閱讀英文

共用方式為


vcpkg env

概要

注意

只有在 Windows 上才支援此命令。

vcpkg env [<optional command>] [--triplet=<triplet>] [--options]

描述

在目前的終端機中建立全新組建環境。 建立的環境是 cmd 初始化的會話,以符合 vcpkg 用來建置埠的會話。

會話的組態取決於您 的三重設定--triplet使用 選項來指定要鎖定的三重對象,否則會推斷預設的三元組。 視您的設定而定,這可能會透過 vcvars初始化Visual Studio建置環境。

大部分的環境變數都會從會話中清除,但環境變數和VCPKG_ENV_PASSTROUGH三重設定中指定的VCPKG_KEEP_ENV_VARS環境變數除外。

--bin使用、 --debug-bin、 或 --python--include--tools選項前面會加上從三重資料夾installed到工作階段環境變數的個別路徑。 如果您想要讓 vcpkg 所安裝的工具和連結庫可在工作階段中使用,請使用這些專案。 請參閱建置系統 手動整合檔 ,以深入瞭解 installed 資料夾的階層。

您可以選擇性地指定要執行的單一命令。 會話會在之後立即終止。

範例

建立組建環境會話

PS C:\Users\vcpkg\vcpkg> vcpkg env
Microsoft Windows [Version 10.0.25905.1000]
(c) Microsoft Corporation. All rights reserved.

C:\Users\vcpkg\vcpkg>

執行單一命令

PS C:\Users\vcpkg\vcpkg> vcpkg env "cmake --version"
cmake version 3.20.21032501-MSVC_2

CMake suite maintained and supported by Kitware (kitware.com/cmake).

保留環境變數

PS C:\Users\vcpkg\vcpkg> $env:CLEARED_ENV_VAR="hello"
PS C:\Users\vcpkg\vcpkg> vcpkg env "set CLEARED_ENV_VAR"
Environment variable CLEARED_ENV_VAR not defined
PS C:\Users\vcpkg\vcpkg> $env:VCPKG_KEEP_ENV_VARS="CLEARED_ENV_VAR"
PS C:\Users\vcpkg\vcpkg> vcpkg env "set CLEARED_ENV_VAR"
CLEARED_ENV_VAR=hello

新增 --tools 至環境

PS C:\Users\vcpkg\vcpkg> vcpkg install minizip[tool]
PS C:\Users\vcpkg\vcpkg> vcpkg env --tools "minizip"
MiniZip 1.1, demo of zLib + MiniZip64 package, written by Gilles Vollant
more info on MiniZip at http://www.winimage.com/zLibDll/minizip.html

Usage : minizip [-o] [-a] [-0 to -9] [-p password] [-j] file.zip [files_to_add]

  -o  Overwrite existing file.zip
  -a  Append to existing file.zip
  -0  Store only
  -1  Compress faster
  -9  Compress better

  -j  exclude path. store only the file name.

選項。

所有 vcpkg 命令都支援一組 常見的選項

--triplet=<triplet>

指定設定環境時要設定目標的三重專案。 這會影響 Visual Studio 建置環境初始化的方式,以及 installed 其他選項所使用的路徑。

如需詳細資訊,請參閱 --triplet 常見選項

--bin

將 triplet 的已安裝 bin 資料夾新增至工作階段的 PATH 環境變數。

--debug-bin

將 triplet 的已安裝 debug/bin 資料夾新增至工作階段的 PATH 環境變數。

--include

將 triplet 的已安裝 include 資料夾新增至工作階段的 INCLUDE 環境變數。

--tools

將 triplet 的已安裝 tools 資料夾新增至工作階段的 PATH 環境變數。

--python

將 triplet 的已安裝 python 資料夾新增至工作階段的 PYTHONPATH 環境變數。