kmpkg_configure_make
为项目的 Debug 和 Release 版本配置 configure 脚本。
用法
kmpkg_configure_make(
SOURCE_PATH <${SOURCE_PATH}>
[AUTOCONFIG]
[USE_WRAPPERS] [NO_WRAPPERS]
[DETERMINE_BUILD_TRIPLET]
[BUILD_TRIPLET "--host=x64 --build=i686-unknown-pc"]
[NO_ADDITIONAL_PATHS]
[CONFIG_DEPENDENT_ENVIRONMENT <SOME_VAR>...]
[CONFIGURE_ENVIRONMENT_VARIABLES <SOME_ENVVAR>...]
[ADD_BIN_TO_PATH]
[DISABLE_VERBOSE_FLAGS]
[NO_DEBUG]
[SKIP_CONFIGURE]
[PROJECT_SUBPATH <${PROJ_SUBPATH}>]
[PRERUN_SHELL <${SHELL_PATH}>]
[OPTIONS <-DUSE_THIS_IN_ALL_BUILDS=1>...]
[OPTIONS_RELEASE <-DOPTIMIZE=1>...]
[OPTIONS_DEBUG <-DDEBUGGABLE=1>...]
)
参数
SOURCE_PATH
指定包含 configure/configure.ac 文件的目录。
按照惯例,在端口文件中通常将其设置为变量 SOURCE_PATH。
PROJECT_SUBPATH
指定包含 configure/configure.ac 文件的目录。
按照惯例,在端口文件中通常将其设置为变量 SOURCE_PATH。
SKIP_CONFIGURE
跳过 configure 处理流程。
USE_WRAPPERS
使用 autotools 的 ar-lib 和 compile 包装器(仅适用于 Windows 下的 cl 和 lib 工具)。
NO_WRAPPERS
停用 autotools 的 ar-lib 和 compile 包装器(仅适用于 Windows 下的 cl 和 lib 工具)。
BUILD_TRIPLET
用于向 configure 传递自定义的 --build/--target/--host 参数。可通过 KMPKG_MAKE_BUILD_TRIPLET 全局覆盖该参数值。
DETERMINE_BUILD_TRIPLET
适用于其 configure 脚本遵循 autotools 三元组(triplet)选择规则的端口。
NO_ADDITIONAL_PATHS
向 configure 调用仅传递 --prefix 参数,不传递任何额外路径。
AUTOCONFIG
需要使用 autoconfig 生成 configure 文件。
PRERUN_SHELL
配置前需要调用的脚本(请勿用于仅调用 autoconf 或 configure 的批处理文件)。
ADD_BIN_TO_PATH
配置期间将相应的 Release 和 Debug 版本 bin\ 目录添加到路径中,以便可执行文件能够基于树内的 DLL 文件运行。
DISABLE_VERBOSE_FLAGS
不向 configure 传递 --disable-silent-rules --verbose 参数。
OPTIONS
配置阶段传递给 configure 的额外选项。
OPTIONS_RELEASE
仅在 Release 版本配置阶段传递给 configure 的额外选项。这些选项会附加在 OPTIONS 之后。
OPTIONS_DEBUG
仅在 Debug 版本配置阶段传递给 configure 的额外选项。这些选项会附加在 OPTIONS 之后。
CONFIG_DEPENDENT_ENVIRONMENT
需要设置的额外配置相关环境变量列表。
传入 SOMEVAR 即可设置该环境变量,且需在端口文件中将 SOMEVAR_(DEBUG|RELEASE) 设为对应值。
通用环境变量可直接在端口文件内设置。
CONFIGURE_ENVIRONMENT_VARIABLES
需通过 configure 调用传递的额外环境变量列表。
说明
此命令会为 configure 提供许多通用参数。若要查看完整列表,请查阅源码。