跳到主要内容

kmpkg_make_install

构建并安装基于 Make 构建系统的项目。

用法​

kmpkg_make_install(
    [ADD_BIN_TO_PATH]
    [DISABLE_PARALLEL]
    [LOGFILE_ROOT <root-name>]
    [MAKEFILE <makefile-name>]
    [TARGETS <target-name>...]
    [OPTIONS <make-option>...]
    [OPTIONS_RELEASE <make-option>...]
    [OPTIONS_DEBUG <make-option>...]
)

使用该函数前，必须依赖辅助端口 kmpkg-make（需配置为 host 依赖）：

"dependencies": [
  {
    "name": "kmpkg-make",
    "host": true
  }
]

参数​

ADD_BIN_TO_PATH​

将配置阶段依赖的 (debug/)bin 目录添加到系统路径中。若配置过程中需要构建并运行带有共享依赖的可执行文件，该选项会非常实用。

DISABLE_PARALLEL​

默认情况下，kmpkg_make_install 会给 make 命令添加 -j 选项以启用并行构建。若你的项目不支持并行构建，或并行构建时出现问题，可设置该标志禁用并行构建——此时 make 会不带 -j 选项执行，所有构建步骤按顺序运行。

LOGFILE_ROOT​

指定构建生成的日志文件的基础名称，默认值为 "make"。

MAKEFILE​

指定要使用的 Makefile 文件名，默认值为 "Makefile"。

TARGETS​

指定要传递给 make 命令的构建目标，默认值为 "all;install"（先执行 all 目标构建所有产物，再执行 install 目标完成安装）。

OPTIONS​

构建过程中传递给 make 命令的额外选项（对 Debug/Release 构建均生效）。

OPTIONS_RELEASE​

仅在 Release 构建时传递给 make 命令的额外选项。

OPTIONS_DEBUG​

仅在 Debug 构建时传递给 make 命令的额外选项。

完整示例​

# 1. 获取项目源码
kmpkg_from_github(
    OUT_SOURCE_PATH source_path
    REPO example/make-project
    REF v1.0.0
    SHA512 abcdef1234567890...
)

# 2. 配置 Make 项目
kmpkg_make_configure(SOURCE_PATH "${source_path}")

# 3. 构建并安装项目
kmpkg_make_install(
    # 禁用并行构建（若项目不支持）
    DISABLE_PARALLEL
    # 自定义 Makefile 名称
    MAKEFILE "Makefile.custom"
    # 仅 Release 构建传递额外选项
    OPTIONS_RELEASE "CFLAGS=-O3"
)

备注​

该命令替代了旧的 kmpkg_install_make() 函数。