跳到主要内容

环境变量

:::no-loc text="EDITOR":::​

该环境变量可设置为可执行文件的完整路径，用于 kmpkg edit 命令。有关命令特定的帮助，请参阅 kmpkg help edit。

KMPKG_BINARY_SOURCES​

该环境变量用于添加或移除二进制源。有关详细信息，请参阅二进制缓存。

KMPKG_DEFAULT_BINARY_CACHE​

该环境变量用于重定向二进制包的默认存储位置。有关详细信息，请参阅二进制缓存。

KMPKG_DEFAULT_HOST_TRIPLET​

该环境变量可设置为三元组名称，用于命令行中未指定宿主端口的引用，以及依赖列表中所有宿主端口的引用。有关详细信息，请参阅宿主依赖项文档。

KMPKG_DEFAULT_TRIPLET​

该环境变量可设置为三元组名称，用于命令行中未指定三元组的引用。

KMPKG_DISABLE_METRICS​

只要设置了该环境变量（无论值为何），都会禁用遥测数据收集。

KMPKG_DOWNLOADS​

该环境变量可设置为现有目录，用于存储下载文件（替代内置的 downloads/ 目录）。必须设置为绝对路径。

KMPKG_FEATURE_FLAGS​

该环境变量可设置为 kmpkg 中默认关闭的功能的逗号分隔列表。这些功能可能会随时变更或移除，稳定性极低。

目前没有默认关闭的功能标志。

KMPKG_FORCE_DOWNLOADED_BINARIES​

若设置了该环境变量，将忽略系统二进制文件，始终下载并使用 kmpkg 定义的版本。

KMPKG_FORCE_SYSTEM_BINARIES​

若设置了该环境变量，将禁止下载 CMake 和 Ninja，强制使用系统二进制文件。

KMPKG_KEEP_ENV_VARS​

该环境变量可设置为以 ; 分隔的环境变量列表，这些变量将被传递到构建环境中。

保留的变量值不会计入包的 ABI，且变量变更时不会触发重新构建。若需传递变更时应触发重新构建的环境变量，请参阅 KMPKG_ENV_PASSTHROUGH。

示例：FOO_SDK_DIR;BAR_SDK_DIR

KMPKG_MAX_CONCURRENCY​

该环境变量限制底层构建系统使用的并发数。若未指定，默认值为逻辑核心数 + 1。

KMPKG_NO_CI​

设置 KMPKG_NO_CI 将禁用 kmpkg 的 CI 环境检测启发式逻辑。

KMPKG_NUGET_REPOSITORY​

该环境变量用于修改生成的 NuGet 包的元数据。有关详细信息，请参阅二进制缓存。

KMPKG_OVERLAY_PORTS​

该环境变量用于添加额外的覆盖端口或覆盖端口目录，优先级低于命令行中指定的端口。多个值使用平台相关的 PATH 分隔符（Windows 用 ; | 其他系统用 :）分隔。

示例（Windows）：C:\custom-ports\boost;C:\custom-ports\sqlite3;C:\other-ports

KMPKG_OVERLAY_TRIPLETS​

该环境变量允许用户添加三元组的搜索目录。

使用平台相关的 PATH 分隔符（Windows 用 ; | 其他系统用 :）列出覆盖路径。

有关示例，请参阅示例：覆盖三元组。

KMPKG_ROOT​

该环境变量可设置为目录，用作 kmpkg 实例的根目录。仅当 kmpkg 可执行文件不在有效的根目录中，且未使用命令行参数 --kmpkg-root 时，才会使用该目录。

KMPKG_USE_NUGET_CACHE​

该环境变量允许为所有基于 NuGet 的二进制源使用 NuGet 的缓存。有关详细信息，请参阅二进制缓存。

KMPKG_VISUAL_STUDIO_PATH​

该环境变量可设置为机器上 Visual Studio 实例的完整路径。若三元组未通过 KMPKG_VISUAL_STUDIO_PATH 三元组设置覆盖，则使用该 Visual Studio 实例。

示例：D:\2017

VSLANG​

该环境变量设置 kmpkg 显示消息的语言。应设置为 14 个受支持的 LCID（区域设置标识符，对应语言的 4 字节值）之一。

例如：1033 对应英语（美国）。 有关受支持的 LCID 完整列表，请参阅本地化。

X_KMPKG_ASSET_SOURCES​

本节介绍 kmpkg 的实验性功能，可能随时变更或移除，恕不另行通知。

该环境变量允许为所有带 SHA512 标记的资产使用私有镜像。有关详细信息，请参阅资产缓存。

X_KMPKG_NUGET_ID_PREFIX​

为从 NuGet 二进制缓存 推送或恢复的所有二进制包名称添加前缀。

例如，当 X_KMPKG_NUGET_ID_PREFIX 设置为 kmpkg_demo- 时，二进制包 zlib_x64-windows.1.2.13-kmpkg8918746ce8b60474e5ebe68e53355fa70eb05119be913a1d1dc0b930b3b7b6e8.nupkg 将变为 kmpkg_demo-zlib_x64-windows.1.2.13-kmpkg8918746ce8b60474e5ebe68e53355fa70eb05119be913a1d1dc0b930b3b7b6e8.nupkg。