mirror of https://github.com/microsoft/vcpkg.git synced 2024-12-12 03:19:02 +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

1.9 KiB

Raw Blame History

vcpkg_acquire_msys

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

Download and prepare an MSYS2 instance.

Usage

vcpkg_acquire_msys(<MSYS_ROOT_VAR>
    PACKAGES <package>...
    [NO_DEFAULT_PACKAGES]
    [DIRECT_PACKAGES <URL> <SHA512> <URL> <SHA512> ...]
)

Parameters

MSYS_ROOT_VAR

An out-variable that will be set to the path to MSYS2.

PACKAGES

A list of packages to acquire in msys.

To ensure a package is available: vcpkg_acquire_msys(MSYS_ROOT PACKAGES make automake1.16)

NO_DEFAULT_PACKAGES

Exclude the normal base packages.

The list of base packages includes: bash, coreutils, sed, grep, gawk, diffutils, make, and pkg-config

DIRECT_PACKAGES

A list of URL/SHA512 pairs to acquire in msys.

This parameter can be used by a port to privately extend the list of msys packages to be acquired. The URLs can be found on the msys2 website[1] and should be a direct archive link:

https://repo.msys2.org/mingw/i686/mingw-w64-i686-gettext-0.19.8.1-9-any.pkg.tar.zst

[1] https://packages.msys2.org/search

Notes

A call to vcpkg_acquire_msys will usually be followed by a call to bash.exe:

vcpkg_acquire_msys(MSYS_ROOT)
set(BASH ${MSYS_ROOT}/usr/bin/bash.exe)

vcpkg_execute_required_process(
    COMMAND ${BASH} --noprofile --norc "${CMAKE_CURRENT_LIST_DIR}\\build.sh"
    WORKING_DIRECTORY ${CURRENT_BUILDTREES_DIR}/${TARGET_TRIPLET}-rel
    LOGNAME build-${TARGET_TRIPLET}-rel
)

Examples

Source

scripts/cmake/vcpkg_acquire_msys.cmake

1.9 KiB Raw Blame History