mirror of https://github.com/microsoft/vcpkg.git synced 2024-12-04 13:19:01 +08:00

[scripts-audit] Rollup PR 2021-02-26 (#16440 )

* [scripts-audit rollup] PR #16419

* pull the cmake doc comment parsing out into its own function
* support cmake helper ports
* add real support for deprecation, as opposed to ad-hoc

* [scripts-audit rollup] PR #16192

* add a z_ in front of internal functions
* move internal functions out

set feature_vars again in parent scope

* [scripts-audit rollup] PR #16309

Audit vcpkg_copy_pdbs

* [scripts-audit rollup] PR #16304

* Fix usage, documentation

* [scripts-audit rollup] PR #16393

* [scripts-audit rollup] PR #16377

Deprecate `vcpkg_*_cmake` in favor of `vcpkg_cmake_*` from the
`vcpkg-cmake` port, as well as `vcpkg_fixup_cmake_targets`
in favor of `vcpkg_cmake_config_fixup` from the
`vcpkg-cmake-config` port.

2021-02-28 13:17:19 -08:00

3.4 KiB

Raw Blame History

vcpkg_configure_make

The latest version of this document lives in the vcpkg repo.

Configure configure for Debug and Release builds of a project.

Usage

vcpkg_configure_make(
    SOURCE_PATH <${SOURCE_PATH}>
    [AUTOCONFIG]
    [USE_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]
    [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>...]
)

Parameters

SOURCE_PATH

Specifies the directory containing the configure/configure.ac. By convention, this is usually set in the portfile as the variable SOURCE_PATH.

PROJECT_SUBPATH

Specifies the directory containing the ``configure/configure.ac. By convention, this is usually set in the portfile as the variable SOURCE_PATH`.

SKIP_CONFIGURE

Skip configure process

USE_WRAPPERS

Use autotools ar-lib and compile wrappers (only applies to windows cl and lib)

BUILD_TRIPLET

Used to pass custom --build/--target/--host to configure. Can be globally overwritten by VCPKG_MAKE_BUILD_TRIPLET

DETERMINE_BUILD_TRIPLET

For ports having a configure script following the autotools rules for selecting the triplet

NO_ADDITIONAL_PATHS

Don't pass any additional paths except for --prefix to the configure call

AUTOCONFIG

Need to use autoconfig to generate configure file.

PRERUN_SHELL

Script that needs to be called before configuration (do not use for batch files which simply call autoconf or configure)

ADD_BIN_TO_PATH

Adds the appropriate Release and Debug bin\ directories to the path during configure such that executables can run against the in-tree DLLs.

DISABLE_VERBOSE_FLAGS

do not pass '--disable-silent-rules --verbose' to configure

OPTIONS

Additional options passed to configure during the configuration.

OPTIONS_RELEASE

Additional options passed to configure during the Release configuration. These are in addition to OPTIONS.

OPTIONS_DEBUG

Additional options passed to configure during the Debug configuration. These are in addition to OPTIONS.

CONFIG_DEPENDENT_ENVIRONMENT

List of additional configuration dependent environment variables to set. Pass SOMEVAR to set the environment and have SOMEVAR_(DEBUG|RELEASE) set in the portfile to the appropriate values General environment variables can be set from within the portfile itself.

CONFIGURE_ENVIRONMENT_VARIABLES

List of additional environment variables to pass via the configure call.

Notes

This command supplies many common arguments to configure. To see the full list, examine the source.

Examples

Source

scripts/cmake/vcpkg_configure_make.cmake

3.4 KiB Raw Blame History