vcpkg/docs/maintainers/vcpkg_install_nmake.md
nicole mazzuca 3426db05b9
[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

2.1 KiB

vcpkg_install_nmake

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

Build and install a msvc makefile project.

Usage:

vcpkg_install_nmake(
    SOURCE_PATH <${SOURCE_PATH}>
    [NO_DEBUG]
    [TARGET <all>]
    PROJECT_SUBPATH <${SUBPATH}>
    PROJECT_NAME <${MAKEFILE_NAME}>
    [PRERUN_SHELL <${SHELL_PATH}>]
    [PRERUN_SHELL_DEBUG <${SHELL_PATH}>]
    [PRERUN_SHELL_RELEASE <${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 source files. By convention, this is usually set in the portfile as the variable SOURCE_PATH.

PROJECT_SUBPATH

Specifies the sub directory containing the makefile.vc/makefile.mak/makefile.msvc or other msvc makefile.

PROJECT_NAME

Specifies the name of msvc makefile name. Default is makefile.vc

NO_DEBUG

This port doesn't support debug mode.

PRERUN_SHELL

Script that needs to be called before build

PRERUN_SHELL_DEBUG

Script that needs to be called before debug build

PRERUN_SHELL_RELEASE

Script that needs to be called before release build

OPTIONS

Additional options passed to generate during the generation.

OPTIONS_RELEASE

Additional options passed to generate during the Release generation. These are in addition to OPTIONS.

OPTIONS_DEBUG

Additional options passed to generate during the Debug generation. These are in addition to OPTIONS.

Parameters:

See vcpkg_build_nmake().

Notes:

This command transparently forwards to vcpkg_build_nmake(), adding ENABLE_INSTALL

Examples

Source

scripts/cmake/vcpkg_install_nmake.cmake