跳到主要内容

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 提供许多通用参数。若要查看完整列表,请查阅源码。

示例

源码

scripts/cmake/kmpkg_configure_make.cmake