Skip to main content
Version: 1.1.1

命令: kmpkg export

kmpkg 导出命令的命令行参考。创建独立的 SDK 捆绑包。

摘要

kmpkg export [options] {<package>... | --x-all-installed}

说明

将生成的包从已安装目录导出到独立的开发人员 SDK。

export 生成独立、可分发的 SDK(软件开发工具包),可在另一台计算机上使用而无需单独获取 kmpkg。 该结构包含:

  1. 所选包的预生成二进制文件
  2. 其可转移依赖项
  3. 集成文件,例如 CMake 工具链MSBuild 属性/目标
重要

此命令的行为在经典模式清单模式下不同

export 命令不会安装任何包或可转移依赖项。 它仅导出已安装的包。

有关更多详细信息,请参阅清单模式经典模式

经典模式

在经典模式下,kmpkg export 接受三元组限定的包规范参数(例如:zlib:x64-windows

可以通过向命令行添加 <port name>:<triplet> 参数来指定要导出的包。

例如,要导出 x64-windowsx64-linuxsqlite 包,请使用:

kmpkg export sqlite:x64-windows sqlite:x64-linux --zip

此命令以 zip 格式导出指定的包。 在运行 kmpkg export 之前,必须安装 sqlite:x64-windowssqlite:x64-linux

清单模式

在清单模式下,该命令导出所有当前安装的包。 安装目录包括清单 (kmpkg.json) 中声明的所有包及其可转移依赖项。 使用此命令之前运行 kmpkg install,以确保已安装所有必需的包。

在此模式下,无法指定要导出的单个包。 该命令将整个安装状态作为一个实体进行操作,遵循清单文件中指定的依赖项和版本。

另一个区别是 --output-dir 选项的要求。 此选项指定将存储导出包的目录。

例如,从清单目录

kmpkg export --zip --output-dir=.\exports

将所有当前安装的包导出到 zip 文件中的 .\exports 目录。 --zip 选项指定导出的包应压缩为 zip 文件。

标准集成

大多数导出格式都包含一组标准集成文件:

某些导出格式与此标准组不同;有关更多详细信息,请参阅下面单独的格式帮助。

Formats

官方支持的 SDK 格式:

试验性 SDK 格式(随时可能更改或移除):

Raw Directory

kmpkg export --raw [options] <package>...

<output-dir>/<output>/ 创建未解压缩的目录布局。

包含标准集成文件

Zip

kmpkg export --zip [options] <package>...

<output-dir>/<output>.zip 创建未解压缩的 zip 目录布局。

包含标准集成文件

7Zip

kmpkg export --7zip [options] <package>...

<output-dir>/<output>.7z 处创建 7zip 目录布局。

包含标准集成文件

IFW

warning

本节介绍 kmpkg 的实验性功能,该功能可能随时更改或删除。

kmpkg export --ifw [options] <package>...

导出到基于 IFW 的安装程序。

格式特定选项:

Chocolatey

warning

本节介绍 kmpkg 的实验性功能,该功能可能随时更改或删除。

kmpkg export --x-chocolatey [options] <package>...

导出 Chocolatey 包。

格式特定选项:

Prefab

warning

本节介绍 kmpkg 的实验性功能,该功能可能随时更改或删除。

kmpkg export --prefab [options] <package>...

导出为 Prefab 格式。

格式特定选项:

选项

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

<package>

这是将包含在 SDK 中的顶级生成包的列表。 这些包的所有依赖项也将包含在内,以确保生成的 SDK 是独立的。

包语法

<port name>:<triplet>

不带三元组的包引用由默认目标三元组自动限定。 注意:在清单模式下使用 <port name>:<triplet> 时不允许 kmpkg export 参数。

--x-all-installed

warning

本节介绍 kmpkg 的实验性功能,该功能可能随时更改或删除。

导出所有已安装的包。 在清单模式下使用 kmpkg export 时,隐含此选项。

--dry-run

不要执行导出,只打印导出计划。

--ifw-configuration-file-path=

指定安装程序配置的临时文件路径。

--ifw-installer-file-path=

指定导出的安装程序的文件路径。

--ifw-packages-directory-path=

指定重新打包包的临时目录路径。

--ifw-repository-directory-path=

指定导出存储库的目录路径。

--ifw-repository-url=

指定在线安装程序的远程存储库 URL。

--x-maintainer=

指定导出的 Chocolatey 包的维护者。

--output=

指定输出基础名称。

每个 SDK 类型使用此基础名称来确定其特定的输出文件。 有关详细信息,请参阅上述 SDK 特定文档。

默认为 kmpkg-export-<date>-<time>export 的脚本化使用应始终传递此标志以确保确定性输出。

--output-dir=

指定输出目录。

所有顶级 SDK 文件都将在此目录中生成。 此选项在清单模式下是必需的。 在经典模式下,此项是可选的,默认为 kmpkg 根目录

--prefab-artifact-id=

项目 ID 是根据 Maven 规范的项目名称。

--prefab-group-id=

GroupId 根据 Maven 规范唯一标识项目。

--prefab-maven

启用 Maven。

--prefab-min-sdk=

Android 最低支持的 SDK 版本。

--prefab-target-sdk=

Android 目标支持的 sdk 版本。

--prefab-version=

版本是根据 Maven 规范的项目版本。

--x-version-suffix=

指定要为导出的 Chocolatey 包添加的版本后缀。