閱讀英文

共用方式為


埠原則參考

埠原則可以在 中 portfile.cmake設定為 'disabled' (預設值) 或 'enabled'。 例如:

set(VCPKG_POLICY_EMPTY_INCLUDE_FOLDER enabled)

VCPKG_POLICY_ALLOW_DEBUG_INCLUDE

停用 vcpkg 的建置後檢查偵錯/包含目錄,哪些埠不應該建立。

VCPKG_POLICY_ALLOW_DEBUG_SHARE

停用 vcpkg 的建置後檢查偵錯/共享目錄,哪些埠不應該建立。

VCPKG_POLICY_ALLOW_DLLS_IN_LIB

停用安裝至 『lib』 目錄而非 'bin' 目錄之 DLL 的建置後檢查。

VCPKG_POLICY_ALLOW_EMPTY_FOLDERS

停用 vcpkg 建置後檢查埠所建立的空白目錄。 空目錄不會被視為埠安裝的語意部分,而且無法代表數個二進位快取後端。

VCPKG_POLICY_ALLOW_EXES_IN_BIN

停用 'bin' 目錄中的 vcpkg 建置後檢查 exe 檔案,此檔案不應存在。 建置工具應該移至工具目錄,可能使用 vcpkg_copy_tools

VCPKG_POLICY_ALLOW_KERNEL32_FROM_XBOX

當埠要求以 XBox 為目標時,停用 vcpkg 的建置後檢查以 kernel32 連結。 與 kernel32 連結的二進位檔無法在沒有kernel32.dll的 XBox 上執行。

VCPKG_POLICY_ALLOW_OBSOLETE_MSVCRT

停用舊 C 運行時間連結庫的建置後檢查 vcpkg。

VCPKG_POLICY_ALLOW_RESTRICTED_HEADERS

停用 vcpkg 的建置後檢查,以取得操作系統和標準連結庫通常保留的標頭。

VCPKG_POLICY_CMAKE_HELPER_PORT

標示埠是要將 CMake 函式提供給其他埠,而且相依埠應該由此埠設定 vcpkg_port_config.cmake

VCPKG_POLICY_DLLS_IN_STATIC_LIBRARY

當三重項要求靜態組建時,停用埠所產生的 DLL 建置後檢查。

VCPKG_POLICY_DLLS_WITHOUT_EXPORTS

停用沒有導出之 DLL 的建置後檢查 vcpkg。 沒有導出的 DLL 通常不適用於呼叫端。 在 Windows 上提供良好的動態連結體驗,需要連結庫定義 DLL 介面。 另 Do not add CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS 請參閱維護工具指南。

VCPKG_POLICY_DLLS_WITHOUT_LIBS

針對未匯入連結庫所產生的 DLL 停用 vcpkg 建置後檢查。 當連結器看不到該 DLL 所導出的函式時,這些 DLL 可能更難使用。

VCPKG_POLICY_EMPTY_INCLUDE_FOLDER

停用 vcpkg 的建置後檢查是否有空的 include 目錄。 空的 include 目錄通常表示標頭未正確安裝。

VCPKG_POLICY_EMPTY_PACKAGE

停用所有建置後檢查,並防止某些套件類型的 『d 套件中包含 vcpkg export埠。

VCPKG_POLICY_MISMATCHED_NUMBER_OF_BINARIES

停用 vcpkg 的建置後檢查,以取得相符的版本數目和偵錯二進位檔。

VCPKG_POLICY_ONLY_RELEASE_CRT

指出埠只想要安裝使用發行 C 運行時間連結庫的元件,且與偵錯 C 運行時間連結庫的連結是 Bug。 請參閱 VCPKG_POLICY_SKIP_CRT_LINKAGE_CHECK

VCPKG_POLICY_SKIP_ABSOLUTE_PATHS_CHECK

停用 vcpkg 建置後檢查內嵌在已安裝檔案中的絕對路徑。 絕對路徑通常會中斷二進位快取,因為已安裝的樹狀結構在不同的 vcpkg 實例中可能有不同的根目錄。

VCPKG_POLICY_SKIP_ALL_POST_BUILD_CHECKS

停用所有 vcpkg 的建置後檢查。

VCPKG_POLICY_SKIP_APPCONTAINER_CHECK

停用 appcontainer 位的建置後檢查 vcpkg,即使以 UWP 為目標的三元要求也是如此。

VCPKG_POLICY_SKIP_ARCHITECTURE_CHECK

停用 vcpkg 建置後檢查埠所建立的二進位檔,以三元組所要求的架構為目標。

停用 vcpkg 建置後檢查埠是否安裝著作權檔案,以包含使用該埠的授權資訊。

VCPKG_POLICY_SKIP_CRT_LINKAGE_CHECK

停用 vcpkg 的建置後檢查,以完全鏈接正確的 C 運行時間連結庫。

VCPKG_POLICY_SKIP_DUMPBIN_CHECKS

此原則沒有作用。 在 vcpkg 的舊復本中,它的目的是為了因應未提供 dumpbin 公用程式的環境,例如 MinGW,方法是停用所需的建置後檢查。 在目前的 vcpkg 複本中,所提供的功能 dumpbin 現在會直接實作,而不需要叫用 dumpbin

VCPKG_POLICY_SKIP_LIB_CMAKE_MERGE_CHECK

針對要合併成單一組態的發行和偵錯組態,停用 vcpkg 建置後檢查 CMake 設定。這通常是因為忘記呼叫 vcpkg_cmake_config_fixup而造成。

VCPKG_POLICY_SKIP_MISPLACED_REGULAR_FILES_CHECK

停用 vcpkg 的建置後檢查,檢查安裝在一般檔案中的一般檔案並非預期。 搜尋的位置應該只包含目錄。

VCPKG_POLICY_SKIP_PKGCONFIG_CHECK

停用在正確位置安裝 pkgconfig (.pc) 檔案的建置後檢查。 或 pkg-config找不到未正確安裝的.pcpkgconf架構獨立性,或未實際提供時公告架構獨立性。

VCPKG_POLICY_SKIP_USAGE_INSTALL_CHECK

停用 vcpkg 的建置後檢查,以取得忘記的使用文字。 當埠包含名為 usage 但不存在 ${CURRENT_PACKAGES_DIR}/share/${PORT}/usage 的檔案時,就會觸發此動作,指出它可能是要安裝但不是使用方式。