vcpkg_configure_cmake
Ostrzeżenie
Ta funkcja została przestarzała na rzecz vcpkg_cmake_configure.
Konfigurowanie narzędzia CMake dla kompilacji debugowania i wydawania projektu.
Użycie
vcpkg_configure_cmake(
SOURCE_PATH <${SOURCE_PATH}>
[PREFER_NINJA]
[DISABLE_PARALLEL_CONFIGURE]
[NO_CHARSET_FLAG]
[GENERATOR <"NMake Makefiles">]
[OPTIONS <-DUSE_THIS_IN_ALL_BUILDS=1>...]
[OPTIONS_RELEASE <-DOPTIMIZE=1>...]
[OPTIONS_DEBUG <-DDEBUGGABLE=1>...]
[MAYBE_UNUSED_VARIABLES <OPTION_NAME>...]
)
Parametry
SOURCE_PATH
Określa katalog zawierający CMakeLists.txt.
Zgodnie z konwencją jest to zwykle ustawiane w pliku portfile jako zmienna SOURCE_PATH.
PREFER_NINJA
Wskazuje, że jeśli jest dostępna, narzędzie vcpkg powinno używać narzędzia Ninja do wykonania kompilacji. Należy to określić, chyba że port nie działa w obszarze Ninja.
DISABLE_PARALLEL_CONFIGURE
Wyłącza równoległe uruchamianie kroku konfiguracji narzędzia CMake. Jest to wymagane w przypadku bibliotek, które zapisują z powrotem do katalogu źródłowego podczas konfigurowania.
Spowoduje to również wyłączenie CMAKE_DISABLE_SOURCE_CHANGES.
NO_CHARSET_FLAG
Wyłącza przekazywanie utf-8 jako domyślnego zestawu znaków na CMAKE_C_FLAGS i CMAKE_CXX_FLAGS.
Jest to wymagane w przypadku bibliotek, które ustawiają własny zestaw znaków kodu źródłowego.
GENERATOR
Określa dokładny generator do użycia.
Jest to przydatne, jeśli jakiś system kompilacji specyficzny dla projektu został opakowany w skrypt cmake, który nie wykona rzeczywistej kompilacji.
W przypadku użycia w tym celu należy ustawić "NMake Makefiles"wartość .
OPTIONS
Dodatkowe opcje przekazywane do narzędzia CMake podczas konfiguracji.
OPTIONS_RELEASE
Dodatkowe opcje przekazywane do narzędzia CMake podczas konfiguracji wydania. Są one dodatkiem do programu OPTIONS.
OPTIONS_DEBUG
Dodatkowe opcje przekazywane do narzędzia CMake podczas konfiguracji debugowania. Są one dodatkiem do programu OPTIONS.
MAYBE_UNUSED_VARIABLES
Wszystkie zmienne CMake, które są jawnie przekazywane, ale które mogą nie być używane na wszystkich platformach. Na przykład:
vcpkg_cmake_configure(
...
OPTIONS
-DBUILD_EXAMPLE=OFF
...
MAYBE_UNUSED_VARIABLES
BUILD_EXAMPLE
)
LOGNAME
Nazwa dziennika do zapisania danych wyjściowych wywołania konfiguracji.
Uwagi
To polecenie dostarcza wiele typowych argumentów narzędzia CMake. Aby wyświetlić pełną listę, sprawdź źródło.
