vcpkg install
概要
- 傳統模式
vcpkg install [options] <package>...
- 指令清單模式
vcpkg install [options]
描述
建置並安裝埠套件。
傳統模式
在傳統模式中，這個動詞命令會將埠套件新增至已安裝目錄中的現有集合（預設為 installed/ vcpkg 根目錄下）。 這可能需要移除和重建現有的套件，這可能會失敗。
套件語法
portname[feature1,feature2]:triplet
沒有三元的套件參考會自動由 預設目標三元組限定。 未明確列出 core 之套件參考會被視為暗示所有預設功能。
指令清單模式
在指令清單模式中，此命令會將已安裝的vcpkg.json目錄設定為指令清單檔案所指定的狀態，視需要新增、移除或重建套件。
選項。
所有 vcpkg 命令都支援一組 常見的選項。
--allow-unsupported
不要在不支援的埠上停止，而是繼續警告。
根據預設，vcpkg 會拒絕執行安裝計劃，其中包含其 "supports" 子句外部三重專案的埠安裝。 套件 "supports" 的 子句描述套件預期可建置的一組完整平臺。 此旗標會指示 vcpkg 警告建置預期會失敗，而不是停止。
--clean-after-build
建置每個套件之後，清除建置樹狀結構、套件和下載專案。
此選項的效果與傳遞 --clean-buildtrees-after-build、 --clean-downloads-after-build和 --clean-packages-after-build相同。
--clean-buildtrees-after-build
在建置每個套件之後，清除 buildtrees 暫存子資料夾的所有子目錄。
將保留 buildtrees 子資料夾中的所有最上層檔案（例如 buildtrees/zlib/config-x64-windows-out.log）。 將會刪除所有子目錄。
--clean-downloads-after-build
在建置每個套件之後，清除 downloads/ 資料夾中所有未移除的資產。
資料夾中的所有最上層檔案 downloads/ 都會被刪除。 系統會保留擷取的工具。
--clean-packages-after-build
建置每個套件之後，清除套件暫存子資料夾。
安裝之後，將會刪除所建置套件的套件子資料夾（例如 packages/zlib_x64-windows， ）。
--dry-run
列印安裝方案，但不移除或安裝任何套件。
安裝方案會列出將安裝的所有套件和功能，以及需要移除和重建的任何其他套件。
--editable
- 僅限傳統模式
針對命令行上所有直接參考的套件執行可編輯的組建。
當 vcpkg 建置埠時，它會每次清除並重新擷取原始程式碼，以確保輸入正確無誤。 這是指令清單模式必須正確更新所安裝的內容，以及二進位快取，以確保快取的內容正確無誤。
傳遞 --editable 旗標會停用此行為，並保留對資料夾中所擷取來源的 buildtrees/ 編輯。 這可藉由避免在每次變更上寫入檔案的需求，來快速開發修補程式。
在可編輯的組建期間擷取的來源在目錄名稱上沒有 .clean/ 後綴，後續不可編輯的組建將不會清除。
--enforce-port-checks
如果埠偵測到問題或嘗試使用已被取代的功能，則安裝失敗。
根據預設，vcpkg 會在建置套件上執行數個檢查，並在偵測到任何問題時發出警告。 此旗標會將這些警告升級為錯誤。
--x-feature=<feature>
注意
本節涵蓋 vcpkg 的實驗功能，隨時可能會變更或移除。
- 僅限指令清單模式
指定要安裝相依性的其他功能vcpkg.json。
根據預設，只會 "dependencies" 安裝 和的 "default-features" 相依性。
--head
- 僅限傳統模式
要求命令行上明確參考的所有套件，以擷取建置時可用的最新來源。
此旗標僅適用於暫存測試，不適用於生產環境或長期使用。 這會停用 所有明確參考套件及其相依專案的二進位快 取，因為 vcpkg 無法正確追蹤所有輸入。
--keep-going
在第一次失敗之後繼續安裝方案。
根據預設，vcpkg 會在第一次套件建置失敗時停止。 此旗標會指示 vcpkg 繼續建置及安裝不相依於失敗套件之安裝計劃的其他部分。
--x-no-default-features
注意
本節涵蓋 vcpkg 的實驗功能，隨時可能會變更或移除。
- 僅限指令清單模式
請勿從最上層指令清單安裝預設功能。
在指令清單模式中使用 install 時，預設會安裝中 "default-features" 所列功能的所有相依性。 此旗標會停用該行為，因此只會安裝 所 --x-feature 明確啟用的功能。
--no-downloads
建置套件時，防止埠在建置期間下載新的資產。
根據預設，埠會視需要從因特網取得原始程式碼和工具（受限於 資產快取）。 此參數會封鎖下載，並將埠限制為計算機上先前下載和快取的資產。
--only-downloads
嘗試下載安裝計劃所需的所有資產，而不需要執行任何組建。
傳遞此選項時，vcpkg 會在計劃中執行每個組建，直到它進行第一次非下載外部進程呼叫為止。 大部分的埠會在第一個外部進程呼叫之前執行所有下載（通常是對其建置系統），因此此程式會下載所有必要的資產。 未遵循此程式的埠將不會預先下載其資產。
--only-binarycaching
拒絕執行任何組建。 僅從 二進位快取還原套件。
此旗標會封鎖 vcpkg 依需求執行組建，如果找不到任何二進位快取中的套件，將會失敗。
--recurse
- 僅限傳統模式
核准需要重建套件的安裝計劃。
若要修改已安裝套件的一組功能，vcpkg 必須移除並重建該套件。 由於這可能會失敗，並且讓安裝樹狀結構與用戶啟動的套件少，因此用戶必須核准透過傳遞此旗標來核准重建套件的計劃。
--x-use-aria2
注意
本節涵蓋 vcpkg 的實驗功能，隨時可能會變更或移除。
使用aria2來執行下載工作。
--x-write-nuget-packages-config
注意
本節涵蓋 vcpkg 的實驗功能，隨時可能會變更或移除。
寫出 NuGet packages.config格式的檔案，以搭配 二進位快取使用。
這個選項可以搭配 --dry-run 使用，以取得二進位快取所需的 NuGet 套件清單，而不需要建置或安裝任何套件。 這可讓 NuGet 命令行針對進階案例個別叫用，例如使用替代通訊協定來取得 .nupkg 檔案。
--no-print-usage
隱藏在安裝結束時列印的使用文字產生。
