vcpkg/docs/maintainers/vcpkg_configure_make.md
Kai Pastor f20c7bf05b
[vcpkg-configure-make] Fix include path prepending (#24823)
* Fix include path prepending

* Update DISABLE_VERBOSE_FLAGS documentation

Co-authored-by: Thomas1664 <46387399+Thomas1664@users.noreply.github.com>

Co-authored-by: Thomas1664 <46387399+Thomas1664@users.noreply.github.com>
2022-05-20 14:41:10 -07:00

3.4 KiB

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]
    [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>...]
)

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