閱讀英文

共用方式為


一般命令選項

大部分的 vcpkg 命令都接受一組可控制工具跨領域層面的常見選項。 並非所有選項都會影響每個命令。 例如,不會下載任何檔案的命令將會因為變更下載目錄而受到影響。

選項。

--x-asset-sources=<config>

注意

本節涵蓋 vcpkg 的實驗功能,隨時可能會變更或移除。

指定資產快取的 快取組態。

--binarysource=<config>

新增二進位快的來源。

這個選項可以指定多次;如需多個二進位來源的互動方式,請參閱二進位快取檔。

--x-buildtrees-root=<path>

注意

本節涵蓋 vcpkg 的實驗功能,隨時可能會變更或移除。

指定儲存中繼組建檔案的暫存路徑,例如物件或解壓縮的原始程式碼。

預設為 buildtrees/ vcpkg 根資料夾底下的 。

--classic

即使偵測到指令清單檔仍會強制傳統模式。

--x-cmake-configure-debug=<debugger-pipe>[;semicolon;port;list]

注意

本節涵蓋 vcpkg 的實驗功能,隨時可能會變更或移除。

在上游組建系統CMakeLists.txt內啟用 CMake--debugger,例如 在 內vcpkg_cmake_configure

這個值 <debugger-pipe> 會在 CMake 命令列上傳遞為 --debugger-pipe

如果有分號分隔的埠清單,調試程式只會用於該清單中的埠。 否則,它會用於所有埠。

triplet 變數 VCPKG_CMAKE_CONFIGURE_OPTIONS 可用來將選項傳遞至內部 CMake 設定呼叫。 因此,它不適用於覆寫 VCPKG_CMAKE_CONFIGURE_OPTIONS的自定義三元組。 手動傳遞偵錯選項,或改為將選項附加至 VCPKG_CMAKE_CONFIGURE_OPTIONS

不同於 --x-cmake-debug 沒有輸出,表示組建正在等候調試程式連線。 輸出只會在停止 Configuring <triplet>

雖然所有埠都應該在 portfile 內呼叫 CMake,以從 CMake 工具鏈取得編譯旗標。 此命令主要適用於實際使用 CMake 作為建置系統的埠。

--x-cmake-debug=<debugger-pipe>[;semicolon;port;list]

注意

本節涵蓋 vcpkg 的實驗功能,隨時可能會變更或移除。

啟用 CMake 在執行 --debugger 直接叫用的 CMake 腳稿時,例如三重檔案(例如: x64-windows.cmake) 或 portfile.cmake 檔案。

這個值 <debugger-pipe> 會在 CMake 命令列上傳遞為 --debugger-pipe

如果有分號分隔的埠清單,調試程式只會用於該清單中的埠。 否則,它會用於所有埠。

注意:如果 Waiting for debugger client to connect... 可以在 vcpkg 的輸出中觀察到調試程式,並停止執行,直到調試程式連線為止,就可以附加調試程式。

--downloads-root=<path>

指定應保留下載的工具和原始程式碼封存的位置。

默認為 VCPKG_DOWNLOADS 環境變數。 如果這是未設定的,則預設為 downloads/ vcpkg 根資料夾底下。

--feature-flags=<flag1>,...

此變數可以設定為功能旗標清單,以選擇加入實驗行為。

--host-triplet=<triplet>

指定主機三重。

默認為 VCPKG_DEFAULT_HOST_TRIPLET 環境變數。 如果這也是未設定的,則會根據主機架構和操作系統來推斷值。

--x-install-root=<path>

注意

本節涵蓋 vcpkg 的實驗功能,隨時可能會變更或移除。

指定要設定已安裝套件的路徑。

傳統模式中,預設為 installed/ vcpkg 根資料夾底下。

指令清單模式中,預設為 vcpkg_installed/ 指令清單資料夾底下的 。

--x-manifest-root=<path>

注意

本節涵蓋 vcpkg 的實驗功能,隨時可能會變更或移除。

指定包含 vcpkg.json的目錄。

預設會從目前的工作目錄向上搜尋最 vcpkg.json接近 的 。

--overlay-ports=<path>

指定重 迭埠或本身重疊埠的子目錄。 如果 <path> 是包含 CONTROLvcpkg.json的目錄,則會將其視為重迭埠目錄,且子目錄不會被視為額外的重疊埠。

這個選項可以指定多次;埠會解析為第一個相符專案。

--overlay-triplets=<path>

指定包含重疊三重疊 目錄。

您可以指定此選項多次以新增多個目錄;三胞胎會依名稱解析為第一個相符專案。

--x-packages-root=<path>

注意

本節涵蓋 vcpkg 的實驗功能,隨時可能會變更或移除。

指定暫存中繼套件檔案的暫存路徑,再進行最終安裝。

預設為 packages/ vcpkg 根資料夾底下的 。

--triplet=<triplet>

指定目標架構三重。

默認為 VCPKG_DEFAULT_TRIPLET 環境變數。 如果這是未設定的,則會根據主機架構和操作系統來推斷。

在 Windows 作業系統上,架構一律會因為舊版原因而推斷為 x86。

注意

在 2023 年 9 月之後建立的所有版本都會預設為 Windows 上的主機三重專案,而不是 x86-windows。

--vcpkg-root=<path>

指定 vcpkg 根資料夾。

預設為包含 vcpkg 程式的目錄。 目錄必須是有效的 vcpkg 實例,例如 git clonehttps://github.com/microsoft/vcpkg。 這個選項可用來直接從組建資料夾執行工具的自訂建置複本。

回應檔 (@<file>

vcpkg 命令行接受包含換行分隔命令行參數的文字檔。

此工具的作用就像檔案中的專案已接合到命令行,以取代 @ 參考。 回應檔不能包含其他回應檔。