一般命令選項
大部分的 vcpkg 命令都接受一組可控制工具跨領域層面的常見選項。 並非所有選項都會影響每個命令。 例如,不會下載任何檔案的命令將會因為變更下載目錄而受到影響。
注意
本節涵蓋 vcpkg 的實驗功能,隨時可能會變更或移除。
指定資產快取的 快取組態。
新增二進位快取的來源。
這個選項可以指定多次;如需多個二進位來源的互動方式,請參閱二進位快取檔。
注意
本節涵蓋 vcpkg 的實驗功能,隨時可能會變更或移除。
指定儲存中繼組建檔案的暫存路徑,例如物件或解壓縮的原始程式碼。
預設為 buildtrees/
vcpkg 根資料夾底下的 。
即使偵測到指令清單檔,仍會強制傳統模式。
注意
本節涵蓋 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 作為建置系統的埠。
注意
本節涵蓋 vcpkg 的實驗功能,隨時可能會變更或移除。
啟用 CMake 在執行 --debugger
直接叫用的 CMake 腳稿時,例如三重檔案(例如: x64-windows.cmake
) 或 portfile.cmake
檔案。
這個值 <debugger-pipe>
會在 CMake 命令列上傳遞為 --debugger-pipe
。
如果有分號分隔的埠清單,調試程式只會用於該清單中的埠。 否則,它會用於所有埠。
注意:如果 Waiting for debugger client to connect...
可以在 vcpkg 的輸出中觀察到調試程式,並停止執行,直到調試程式連線為止,就可以附加調試程式。
指定應保留下載的工具和原始程式碼封存的位置。
默認為 VCPKG_DOWNLOADS
環境變數。 如果這是未設定的,則預設為 downloads/
vcpkg 根資料夾底下。
此變數可以設定為功能旗標清單,以選擇加入實驗行為。
指定主機三重。
默認為 VCPKG_DEFAULT_HOST_TRIPLET
環境變數。 如果這也是未設定的,則會根據主機架構和操作系統來推斷值。
注意
本節涵蓋 vcpkg 的實驗功能,隨時可能會變更或移除。
指定要設定已安裝套件的路徑。
在 傳統模式中,預設為 installed/
vcpkg 根資料夾底下。
在 指令清單模式中,預設為 vcpkg_installed/
指令清單資料夾底下的 。
注意
本節涵蓋 vcpkg 的實驗功能,隨時可能會變更或移除。
指定包含 vcpkg.json
的目錄。
預設會從目前的工作目錄向上搜尋最 vcpkg.json
接近 的 。
指定重 迭埠或本身重疊埠的子目錄。 如果 <path>
是包含 CONTROL
或vcpkg.json
的目錄,則會將其視為重迭埠目錄,且子目錄不會被視為額外的重疊埠。
這個選項可以指定多次;埠會解析為第一個相符專案。
指定包含重疊三重疊 的目錄。
您可以指定此選項多次以新增多個目錄;三胞胎會依名稱解析為第一個相符專案。
注意
本節涵蓋 vcpkg 的實驗功能,隨時可能會變更或移除。
指定暫存中繼套件檔案的暫存路徑,再進行最終安裝。
預設為 packages/
vcpkg 根資料夾底下的 。
指定目標架構三重。
默認為 VCPKG_DEFAULT_TRIPLET
環境變數。 如果這是未設定的,則會根據主機架構和操作系統來推斷。
在 Windows 作業系統上,架構一律會因為舊版原因而推斷為 x86。
注意
在 2023 年 9 月之後建立的所有版本都會預設為 Windows 上的主機三重專案,而不是 x86-windows。
指定 vcpkg 根資料夾。
預設為包含 vcpkg 程式的目錄。 目錄必須是有效的 vcpkg 實例,例如 git clone
的 https://github.com/microsoft/vcpkg
。 這個選項可用來直接從組建資料夾執行工具的自訂建置複本。
vcpkg 命令行接受包含換行分隔命令行參數的文字檔。
此工具的作用就像檔案中的專案已接合到命令行,以取代 @
參考。 回應檔不能包含其他回應檔。