跳到主要内容

kmpkg integrate

命令概要​

  • 构建系统集成
kmpkg integrate [options] install
kmpkg integrate [options] remove
kmpkg integrate [options] project
  • Shell 集成
kmpkg integrate [options] powershell
kmpkg integrate [options] bash
kmpkg integrate [options] zsh
kmpkg integrate [options] x-fish

命令描述​

将 kmpkg 与 Shell 环境和构建系统进行集成。

kmpkg integrate install​

与 Visual Studio 集成（仅 Windows 系统）、设置用户级 kmpkg 实例，并显示 CMake 集成帮助信息。

在安装了 Visual Studio 2015 的 Windows 系统上，该子命令会在 MSBuild 安装目录中添加重定向逻辑，使 MSBuild 自动识别每个用户的用户级 kmpkg 实例。Visual Studio 2017 及更高版本已内置此逻辑。

为设置用户级 kmpkg 实例，kmpkg 会在用户的全局配置目录中创建若干小型文件，文件内容为 kmpkg 实例的绝对路径：

  • Windows 系统：%LOCALAPPDATA%\kmpkg 或 %APPDATA%\Local\kmpkg
  • 非 Windows 系统：$HOME/.kmpkg 或 /var/.kmpkg

该命令会输出 CMake 工具链文件 的完整路径。使用该工具链文件无需预先执行此命令。

kmpkg integrate remove​

移除用户级 kmpkg 实例的配置。

该命令会删除由 kmpkg integrate install 在用户全局配置目录中创建的链接文件。

kmpkg integrate project​

创建用于 MSBuild 集成的链接式 NuGet 包。

更多信息请参考 MSBuild 按项目集成。

kmpkg integrate powershell​

  • 仅 Windows 系统支持

为当前用户的 PowerShell 配置文件添加 kmpkg 补全（Tab 补全）支持。

kmpkg integrate bash​

  • 仅非 Windows 系统支持

为当前用户的 .bashrc 文件（macOS 系统为 .bash_profile）添加 kmpkg 补全（Tab 补全）支持。

kmpkg integrate zsh​

  • 仅非 Windows 系统支持

为当前用户的 .zshrc 文件添加 kmpkg 补全（Tab 补全）支持。

kmpkg integrate x-fish​

  • 仅非 Windows 系统支持

为当前用户的 Fish Shell 补全目录添加 kmpkg 补全（Tab 补全）支持。

示例​

$ kmpkg integrate install
已为该 kmpkg 根目录应用用户级全域集成。

CMake 项目应使用："-DCMAKE_TOOLCHAIN_FILE=/workspaces/kmpkg/scripts/buildsystems/kmpkg.cmake"

命令选项​

所有 kmpkg 命令均支持一组通用选项。