mirror of
https://github.com/microsoft/vcpkg.git
synced 2024-12-29 03:34:26 +08:00
5304f826b5
* [rollup:2021-07-26 1/6] PR #18783 (@strega-nil) [scripts-audit] vcpkg_copy_tools and friends * [rollup:2021-07-26 2/6] PR #18898 (@dg0yt) [vcpkg] Fix toolchain compatibility with cmake < 3.15 * [rollup:2021-07-26 3/6] PR #18980 (@strega-nil) [cmake-guidelines] Minor update, for `if()` * [rollup:2021-07-26 4/6] PR #18981 (@strega-nil) [scripts-audit] vcpkg_check_linkage * [rollup:2021-07-26 5/6] PR #19158 (@Hoikas) [vcpkg.cmake] Fix variable case. * [rollup:2021-07-26 6/6] PR #18839 [scripts-audit] z_vcpkg_get_cmake_vars Co-authored-by: nicole mazzuca <mazzucan@outlook.com>
73 lines
2.8 KiB
CMake
73 lines
2.8 KiB
CMake
#[===[.md:
|
|
# vcpkg_check_linkage
|
|
|
|
Asserts the available library and CRT linkage options for the port.
|
|
|
|
## Usage
|
|
```cmake
|
|
vcpkg_check_linkage(
|
|
[ONLY_STATIC_LIBRARY | ONLY_DYNAMIC_LIBRARY]
|
|
[ONLY_STATIC_CRT | ONLY_DYNAMIC_CRT]
|
|
)
|
|
```
|
|
|
|
## Parameters
|
|
### ONLY_STATIC_LIBRARY
|
|
Indicates that this port can only be built with static library linkage.
|
|
|
|
Note: If the user requested a dynamic build ONLY_STATIC_LIBRARY will result in a note being printed, not a fatal error.
|
|
|
|
### ONLY_DYNAMIC_LIBRARY
|
|
Indicates that this port can only be built with dynamic/shared library linkage.
|
|
|
|
### ONLY_STATIC_CRT
|
|
Indicates that this port can only be built with static CRT linkage.
|
|
|
|
### ONLY_DYNAMIC_CRT
|
|
Indicates that this port can only be built with dynamic/shared CRT linkage.
|
|
|
|
## Notes
|
|
This command will either alter the settings for `VCPKG_LIBRARY_LINKAGE` or fail, depending on what was requested by the user versus what the library supports.
|
|
|
|
## Examples
|
|
|
|
* [abseil](https://github.com/Microsoft/vcpkg/blob/master/ports/abseil/portfile.cmake)
|
|
#]===]
|
|
|
|
function(vcpkg_check_linkage)
|
|
cmake_parse_arguments(PARSE_ARGV 0 arg
|
|
"ONLY_STATIC_LIBRARY;ONLY_DYNAMIC_LIBRARY;ONLY_DYNAMIC_CRT;ONLY_STATIC_CRT"
|
|
""
|
|
""
|
|
)
|
|
|
|
if(DEFINED arg_UNPARSED_ARGUMENTS)
|
|
message(WARNING "${CMAKE_CURRENT_FUNCTION} was passed extra arguments: ${arg_UNPARSED_ARGUMENTS}")
|
|
endif()
|
|
|
|
if(arg_ONLY_STATIC_LIBRARY AND arg_ONLY_DYNAMIC_LIBRARY)
|
|
message(FATAL_ERROR "Requesting both ONLY_STATIC_LIBRARY and ONLY_DYNAMIC_LIBRARY; this is an error.")
|
|
endif()
|
|
if(arg_ONLY_STATIC_CRT AND arg_ONLY_DYNAMIC_CRT)
|
|
message(FATAL_ERROR "Requesting both ONLY_STATIC_CRT and ONLY_DYNAMIC_CRT; this is an error.")
|
|
endif()
|
|
|
|
if(arg_ONLY_STATIC_LIBRARY AND "${VCPKG_LIBRARY_LINKAGE}" STREQUAL "dynamic")
|
|
message(STATUS "Note: ${PORT} only supports static library linkage. Building static library.")
|
|
set(VCPKG_LIBRARY_LINKAGE static PARENT_SCOPE)
|
|
elseif(arg_ONLY_DYNAMIC_LIBRARY AND "${VCPKG_LIBRARY_LINKAGE}" STREQUAL "static")
|
|
message(STATUS "Note: ${PORT} only supports dynamic library linkage. Building dynamic library.")
|
|
if("${VCPKG_CRT_LINKAGE}" STREQUAL "static")
|
|
message(FATAL_ERROR "Refusing to build unexpected dynamic library against the static CRT.
|
|
If this is desired, please configure your triplet to directly request this configuration.")
|
|
endif()
|
|
set(VCPKG_LIBRARY_LINKAGE dynamic PARENT_SCOPE)
|
|
endif()
|
|
|
|
if(arg_ONLY_DYNAMIC_CRT AND "${VCPKG_CRT_LINKAGE}" STREQUAL "static")
|
|
message(FATAL_ERROR "${PORT} only supports dynamic crt linkage")
|
|
elseif(arg_ONLY_STATIC_CRT AND "${VCPKG_CRT_LINKAGE}" STREQUAL "dynamic")
|
|
message(FATAL_ERROR "${PORT} only supports static crt linkage")
|
|
endif()
|
|
endfunction()
|