cmake-toolchains(7)
- Введение
- Языки
- Переменные и свойства
- Функции цепочки инструментов
Введение
CMake использует цепочку инструментов для компиляции, компоновки библиотек, создания архивов и других задач для управления сборкой. Доступные инструменты цепочки инструментов определяются активированными языками. В обычных сборках CMake автоматически определяет цепочку инструментов для хост-сборок на основе системного анализа и значений по умолчанию. В сценариях кросс-компиляции может быть указан файл цепочки инструментов с информацией о путях компилятора и утилит.
Языки
Языки активируются командой project(). Языковые встроенные переменные, такие как CMAKE_CXX_COMPILER, CMAKE_CXX_COMPILER_ID и т. д., устанавливаются с помощью команды project(). Если в файле CMakeLists верхнего уровня нет команды project, она будет сгенерирована неявно. По умолчанию активированными языками являются C и CXX:
project(C_Only C)
Также с командой project() можно использовать специальное значение NONE для отключения всех языков:
project(MyProject NONE)
Команда enable_language() может быть использована для активации языков после команды project():
enable_language(CXX)
Когда язык активирован, CMake находит компилятор для этого языка и определяет такую информацию, как поставщик и версия компилятора, целевая архитектура и разрядность, расположение соответствующих утилит и т. д.
Глобальное свойство ENABLED_LANGUAGES содержит языки, которые в настоящее время активированы.
Переменные и свойства
Несколько переменных относятся к языковым компонентам цепочки инструментов, которые активированы. CMAKE_<LANG>_COMPILER — это полный путь к компилятору, используемому для <LANG>. CMAKE_<LANG>_COMPILER_ID — это идентификатор, используемый CMake для компилятора, а CMAKE_<LANG>_COMPILER_VERSION — это версия компилятора.
Переменные CMAKE_<LANG>_FLAGS и их аналоги, специфичные для конфигурации, содержат флаги, которые будут добавлены к команде компиляции при компиляции файла определенного языка.
Поскольку компоновщик вызывается драйвером компилятора, CMake нуждается в способе определения компилятора, который нужно использовать для вызова компоновщика. Это вычисляется по типу LANGUAGE исходных файлов в целевом объекте и, в случае статических библиотек, по языку зависимых библиотек. Выбор, сделанный CMake, может быть переопределен свойством целевого объекта LINKER_LANGUAGE.
Функции цепочки инструментов
CMake предоставляет команду try_compile() и макросы-обертки, такие как CheckCXXSourceCompiles, CheckCXXSymbolExists и CheckIncludeFile, для проверки возможностей и доступности различных функций цепочки инструментов. Эти API проверяют цепочку инструментов каким-либо образом и кэшируют результат, чтобы проверка не выполнялась повторно при следующем запуске CMake.
Некоторые функции цепочки инструментов имеют встроенную обработку в CMake и не требуют проверки компиляцией. Например, POSITION_INDEPENDENT_CODE позволяет указать, что целевой объект должен быть скомпилирован как позиционно-независимый код, если компилятор поддерживает эту функцию. Свойства целевого объекта <LANG>_VISIBILITY_PRESET и VISIBILITY_INLINES_HIDDEN добавляют флаги для скрытой видимости, если это поддерживается компилятором.
Кросс-компиляция
Если cmake(1) вызывается с параметром командной строки -DCMAKE_TOOLCHAIN_FILE=path/to/file, файл будет загружен предварительно для установки значений компиляторов. Переменная CMAKE_CROSSCOMPILING устанавливается в значение true, когда CMake выполняет кросс-компиляцию.
Обратите внимание, что использование переменных CMAKE_SOURCE_DIR или CMAKE_BINARY_DIR внутри файла цепочки инструментов обычно нежелательно. Файл цепочки инструментов используется в контекстах, где эти переменные имеют разные значения при использовании в различных местах (например, в качестве части вызова try_compile()). В большинстве случаев, когда необходимо оценить пути внутри файла цепочки инструментов, более подходящей переменной для использования является CMAKE_CURRENT_LIST_DIR, так как она всегда имеет однозначное, предсказуемое значение.
Кросс-компиляция для Linux
Типичная цепочка инструментов для кросс-компиляции для Linux содержит такие данные:
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR arm)
set(CMAKE_SYSROOT /home/devel/rasp-pi-rootfs)
set(CMAKE_STAGING_PREFIX /home/devel/stage)
set(tools /home/devel/gcc-4.7-linaro-rpi-gnueabihf)
set(CMAKE_C_COMPILER ${tools}/bin/arm-linux-gnueabihf-gcc)
set(CMAKE_CXX_COMPILER ${tools}/bin/arm-linux-gnueabihf-g++)
set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER)
set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY)
Переменная CMAKE_SYSTEM_NAME — это идентификатор CMake целевой платформы для сборки.
Переменная CMAKE_SYSTEM_PROCESSOR — это идентификатор CMake целевой архитектуры для сборки.
Переменная CMAKE_SYSROOT является необязательной и может быть указана, если доступен sysroot.
Переменная CMAKE_STAGING_PREFIX также является необязательной. Она может использоваться для указания пути на хост-системе для установки. Переменная CMAKE_INSTALL_PREFIX всегда представляет собой расположение установки в режиме выполнения, даже при кросс-компиляции.
Переменные CMAKE_<LANG>_COMPILER могут быть установлены в полные пути или в имена компиляторов для поиска в стандартных расположениях. Для инструментальных цепочек, которые не поддерживают связывание библиотек без пользовательских флагов или скриптов, можно установить переменную CMAKE_TRY_COMPILE_TARGET_TYPE в значение STATIC_LIBRARY, чтобы указать CMake не пытаться связывать исполняемые файлы во время проверок.
Команды CMake find_* по умолчанию будут искать в sysroot и в записях CMAKE_FIND_ROOT_PATH, а также в префиксе корневого каталога хост-системы. Хотя это можно контролировать в каждом конкретном случае, при кросс-компиляции полезно исключить поиск в хост- или целевой системе определённых артефактов. Обычно, заголовки, библиотеки и пакеты должны быть найдены в префиксах целевой системы, в то время как исполняемые файлы, которые должны быть запущены в рамках сборки, должны быть найдены только на хост-системе, а не на целевой. Это предназначение переменных CMAKE_FIND_ROOT_PATH_MODE_*.
Кросс-компиляция для среды Cray Linux
Кросс-компиляция для вычислительных узлов в среде Cray Linux может быть выполнена без отдельного файла инструментальной цепочки. Указание -DCMAKE_SYSTEM_NAME=CrayLinuxEnvironment в командной строке CMake гарантирует, что будут настроены соответствующие параметры сборки и пути поиска. Платформа получит свои настройки из текущих переменных среды и настроит проект для использования оболочек компилятора из модулей PrgEnv-* среды Cray Programming Environment, если они присутствуют и загружены.
По умолчанию среда Cray Programming Environment поддерживает только статические библиотеки. Это можно изменить и включить динамические библиотеки, установив переменную среды CRAYPE_LINK_TYPE в значение dynamic.
Запуск CMake без указания CMAKE_SYSTEM_NAME выполнит этап настройки в режиме хоста, предполагая стандартную среду Linux. Если не переопределено, будут использоваться оболочки компилятора PrgEnv-*, которые, если целевой узел является узлом входа или вычислительным узлом, вероятно, не являются желаемым поведением. Исключением является случай, когда вы собираете напрямую на узле NID вместо кросс-компиляции с узла входа. Если вы пытаетесь собрать программное обеспечение для узла входа, вам необходимо либо сначала разгрузить загруженный модуль PrgEnv-* или явно указать CMake использовать системные компиляторы в /usr/bin вместо оболочек Cray. Если вместо этого требуется целевой вычислительный узел, просто укажите CMAKE_SYSTEM_NAME, как указано выше.
Кросс-компиляция с использованием Clang
Некоторые компиляторы, такие как Clang, изначально являются кросс-компиляторами. Переменная CMAKE_<LANG>_COMPILER_TARGET может быть установлена, чтобы передать значение этим поддерживаемым компиляторам во время компиляции:
set(CMAKE_SYSTEM_NAME Linux)
set(CMAKE_SYSTEM_PROCESSOR arm)
set(triple arm-linux-gnueabihf)
set(CMAKE_C_COMPILER clang)
set(CMAKE_C_COMPILER_TARGET ${triple})
set(CMAKE_CXX_COMPILER clang++)
set(CMAKE_CXX_COMPILER_TARGET ${triple})
Аналогично, некоторые компиляторы не поставляют свои собственные вспомогательные утилиты, такие как компоновщики, но предоставляют способ указать расположение внешней инструментальной цепочки, которая будет использоваться драйвером компилятора. Переменная CMAKE_<LANG>_COMPILER_EXTERNAL_TOOLCHAIN может быть установлена в файле инструментальной цепочки, чтобы передать путь к драйверу компилятора.
Кросс-компиляция для QNX
Как и компилятор Clang, компилятор QCC QNX изначально является кросс-компилятором. Переменная CMAKE_<LANG>_COMPILER_TARGET может быть установлена, чтобы передать значение этим поддерживаемым компиляторам во время компиляции:
set(CMAKE_SYSTEM_NAME QNX)
set(arch gcc_ntoarmv7le)
set(CMAKE_C_COMPILER qcc)
set(CMAKE_C_COMPILER_TARGET ${arch})
set(CMAKE_CXX_COMPILER QCC)
set(CMAKE_CXX_COMPILER_TARGET ${arch})
set(CMAKE_SYSROOT $ENV{QNX_TARGET})
Кросс-компиляция для Windows CE
Для кросс-компиляции для Windows CE требуется соответствующий SDK, установленный на вашей системе. Эти SDK обычно устанавливаются в C:/Program Files (x86)/Windows CE Tools/SDKs.
Файл инструментальной цепочки для настройки генератора Visual Studio для Windows CE может выглядеть следующим образом:
set(CMAKE_SYSTEM_NAME WindowsCE) set(CMAKE_SYSTEM_VERSION 8.0) set(CMAKE_SYSTEM_PROCESSOR arm) set(CMAKE_GENERATOR_TOOLSET CE800) # Can be omitted for 8.0 set(CMAKE_GENERATOR_PLATFORM SDK_AM335X_SK_WEC2013_V310)
Переменная CMAKE_GENERATOR_PLATFORM сообщает генератору, какой SDK использовать. Дальнейшая переменная CMAKE_SYSTEM_VERSION сообщает генератору, какую версию Windows CE использовать. В настоящее время версия 8.0 (Windows Embedded Compact 2013) поддерживается по умолчанию. Другие версии могут потребовать установки CMAKE_GENERATOR_TOOLSET на соответствующее значение.
Кросс-компиляция для универсальных приложений Windows 10
Файл инструментальной цепочки для настройки генератора Visual Studio для универсального приложения Windows 10 может выглядеть следующим образом:
set(CMAKE_SYSTEM_NAME WindowsStore) set(CMAKE_SYSTEM_VERSION 10.0)
Универсальное приложение Windows 10 ориентировано на Windows Store и Windows Phone. Установите переменную CMAKE_SYSTEM_VERSION в значение 10.0, чтобы собрать с использованием последней доступной версии Windows 10 SDK. Установите более конкретную версию (например, 10.0.10240.0 для RTM), чтобы собрать с соответствующим SDK.
Кросс-компиляция для Windows Phone
Файл инструментальной цепочки для настройки генератора Visual Studio для Windows Phone может выглядеть следующим образом:
set(CMAKE_SYSTEM_NAME WindowsPhone) set(CMAKE_SYSTEM_VERSION 8.1)
Кросс-компиляция для Windows Store
Файл инструментальной цепочки для настройки генератора Visual Studio для Windows Store может выглядеть следующим образом:
set(CMAKE_SYSTEM_NAME WindowsStore) set(CMAKE_SYSTEM_VERSION 8.1)
Кросс-компиляция для Android
Файл инструментальной цепочки может настроить кросс-компиляцию для Android, установив переменную CMAKE_SYSTEM_NAME в значение Android. Дальнейшая настройка зависит от используемой среды разработки Android.
Для генераторов Visual Studio, CMake ожидает установки NVIDIA Nsight Tegra Visual Studio Edition или Инструменты Visual Studio для Android. См. эти разделы для получения дополнительных деталей настройки.
Для генераторов Makefile и генератора Ninja, CMake ожидает одну из этих сред:
CMake использует следующие шаги для выбора одной из сред:
- Если переменная
CMAKE_ANDROID_NDKзадана, будет использован NDK по указанному пути. - В противном случае, если задана переменная
CMAKE_ANDROID_STANDALONE_TOOLCHAIN, будет использован Standalone Toolchain по указанному пути. - В противном случае, если переменная
CMAKE_SYSROOTзадана для каталога вида<ndk>/platforms/android-<api>/arch-<arch>, часть<ndk>будет использована как значениеCMAKE_ANDROID_NDK, и будет использован NDK. - В противном случае, если переменная
CMAKE_SYSROOTзадана для каталога вида<standalone-toolchain>/sysroot, часть<standalone-toolchain>будет использована как значениеCMAKE_ANDROID_STANDALONE_TOOLCHAIN, и будет использован Standalone Toolchain. - В противном случае, если переменная cmake
ANDROID_NDKзадана, она будет использована как значениеCMAKE_ANDROID_NDK, и будет использован NDK. - В противном случае, если переменная cmake
ANDROID_STANDALONE_TOOLCHAINзадана, она будет использована как значениеCMAKE_ANDROID_STANDALONE_TOOLCHAIN, и будет использован Standalone Toolchain. - В противном случае, если переменные окружения
ANDROID_NDK_ROOTилиANDROID_NDKзаданы, они будут использованы как значениеCMAKE_ANDROID_NDK, и будет использован NDK. - В противном случае, если переменная окружения
ANDROID_STANDALONE_TOOLCHAINзадана, она будет использована как значениеCMAKE_ANDROID_STANDALONE_TOOLCHAIN, и будет использован Standalone Toolchain. - В противном случае, будет выведено сообщение об ошибке, что ни NDK, ни Standalone Toolchain не найдены.
Новое в версии 3.20: Если выбран Android NDK, его номер версии будет отображён в переменной CMAKE_ANDROID_NDK_VERSION.
Компиляция для Android с NDK
Файл конфигурации инструментария может настроить Генераторы Makefile, Генераторы Ninja или Генераторы Visual Studio для компиляции для Android.
Настройка использования Android NDK с помощью следующих переменных:
-
CMAKE_SYSTEM_NAME -
Устанавливается в
Android. Необходимо указать для включения кросс-компиляции для Android. -
CMAKE_SYSTEM_VERSION -
Устанавливается в уровень API Android. Если не указано, значение определяется следующим образом:
- Если задана переменная
CMAKE_ANDROID_API, её значение используется как уровень API. - Если задана переменная
CMAKE_SYSROOT, уровень API определяется из структуры каталога NDK, содержащей sysroot. - В противном случае используется последний доступный уровень API в NDK.
- Если задана переменная
-
CMAKE_ANDROID_ARCH_ABI -
Устанавливается в ABI Android (архитектура). Если не указано, эта переменная будет по умолчанию равна первой поддерживаемой ABI в списке
armeabi,armeabi-v7aиarm64-v8a. ПеременнаяCMAKE_ANDROID_ARCHбудет вычислена изCMAKE_ANDROID_ARCH_ABIавтоматически. Также см. переменныеCMAKE_ANDROID_ARM_MODEиCMAKE_ANDROID_ARM_NEON. -
CMAKE_ANDROID_NDK -
Устанавливается в абсолютный путь к корневому каталогу Android NDK. Если не указано, значение по умолчанию будет выбрано, как указано выше.
-
CMAKE_ANDROID_NDK_DEPRECATED_HEADERS -
Устанавливается в истинное значение для использования устаревших заголовков по уровням API вместо унифицированных заголовков. Если не указано, значение по умолчанию будет ложным, если не используется NDK, который не предоставляет унифицированные заголовки.
-
CMAKE_ANDROID_NDK_TOOLCHAIN_VERSION -
Для NDK r19 или выше эта переменная должна быть не установлена или установлена в
clang. Для NDK r18 или ниже, установите это значение в версию инструментария NDK, который будет выбран как компилятор. Если не указано, по умолчанию будет использоваться последняя доступная цепочка инструментов GCC. -
CMAKE_ANDROID_STL_TYPE -
Устанавливается для указания используемой библиотеки стандартной C++.
Следующие переменные будут вычислены и автоматически предоставлены:
-
CMAKE_<LANG>_ANDROID_TOOLCHAIN_PREFIX -
Абсолютный путь-префикс к binutils в NDK toolchain.
-
CMAKE_<LANG>_ANDROID_TOOLCHAIN_SUFFIX -
Суффикс хостовой платформы для binutils в NDK toolchain.
Например, файл инструментария может содержать:
set(CMAKE_SYSTEM_NAME Android) set(CMAKE_SYSTEM_VERSION 21) # API level set(CMAKE_ANDROID_ARCH_ABI arm64-v8a) set(CMAKE_ANDROID_NDK /path/to/android-ndk) set(CMAKE_ANDROID_STL_TYPE gnustl_static)
В качестве альтернативы можно указать значения без файла инструментария:
$ cmake ../src \ -DCMAKE_SYSTEM_NAME=Android \ -DCMAKE_SYSTEM_VERSION=21 \ -DCMAKE_ANDROID_ARCH_ABI=arm64-v8a \ -DCMAKE_ANDROID_NDK=/path/to/android-ndk \ -DCMAKE_ANDROID_STL_TYPE=gnustl_static
Компиляция для Android со Standalone Toolchain
Файл конфигурации инструментария может настроить Генераторы Makefile или генератор Ninja для компиляции для Android с использованием Standalone Toolchain.
Настройка использования Android standalone toolchain с помощью следующих переменных:
-
CMAKE_SYSTEM_NAME -
Установлено в
Android. Необходимо для включения кросс-компиляции для Android. -
CMAKE_ANDROID_STANDALONE_TOOLCHAIN -
Устанавливается в абсолютный путь к корневому каталогу автономной цепочки инструментов. Должен существовать каталог
${CMAKE_ANDROID_STANDALONE_TOOLCHAIN}/sysroot. Если не указано, для этой переменной будет выбрано значение по умолчанию, как указано выше. -
CMAKE_ANDROID_ARM_MODE -
Когда автономная цепочка инструментов нацелена на ARM, необязательно установите это значение в
ON, чтобы нацелить её на 32-битный ARM вместо 16-битного Thumb. Подробности см. в документации по переменной. -
CMAKE_ANDROID_ARM_NEON -
При нацеливании автономной цепочки инструментов на ARM v7, необязательно установите это значение в
ON, чтобы нацелить её на устройства ARM NEON. Подробности см. в документации по переменной.
Следующие переменные будут вычислены и предоставлены автоматически:
-
CMAKE_SYSTEM_VERSION -
Уровень API Android, обнаруженный в автономной цепочке инструментов.
-
CMAKE_ANDROID_ARCH_ABI -
ABI Android, обнаруженный в автономной цепочке инструментов.
-
CMAKE_<LANG>_ANDROID_TOOLCHAIN_PREFIX -
Абсолютный префикс пути к
binutilsв автономной цепочке инструментов. -
CMAKE_<LANG>_ANDROID_TOOLCHAIN_SUFFIX -
Суффикс платформы-хоста
binutilsв автономной цепочке инструментов.
Например, файл цепочки инструментов может содержать:
set(CMAKE_SYSTEM_NAME Android) set(CMAKE_ANDROID_STANDALONE_TOOLCHAIN /path/to/android-toolchain)
В качестве альтернативы, значения можно указать без файла цепочки инструментов:
$ cmake ../src \ -DCMAKE_SYSTEM_NAME=Android \ -DCMAKE_ANDROID_STANDALONE_TOOLCHAIN=/path/to/android-toolchain
Кросс-компиляция для Android с NVIDIA Nsight Tegra Visual Studio Edition
Файл цепочки инструментов для настройки одного из генераторов Visual Studio для построения с использованием NVIDIA Nsight Tegra, нацеленного на Android, может выглядеть так:
set(CMAKE_SYSTEM_NAME Android)
Переменная CMAKE_GENERATOR_TOOLSET может быть установлена для выбора значения "Toolchain Version" Nsight Tegra.
См. также свойства целевых объектов:
ANDROID_ANT_ADDITIONAL_OPTIONSANDROID_API_MINANDROID_APIANDROID_ARCHANDROID_ASSETS_DIRECTORIESANDROID_GUIANDROID_JAR_DEPENDENCIESANDROID_JAR_DIRECTORIESANDROID_JAVA_SOURCE_DIRANDROID_NATIVE_LIB_DEPENDENCIESANDROID_NATIVE_LIB_DIRECTORIESANDROID_PROCESS_MAXANDROID_PROGUARD_CONFIG_PATHANDROID_PROGUARDANDROID_SECURE_PROPS_PATHANDROID_SKIP_ANT_STEPANDROID_STL_TYPE
Кросс-компиляция для iOS, tvOS или watchOS
Для кросс-компиляции для iOS, tvOS или watchOS рекомендуется генератор Xcode. Генераторы Unix Makefiles или Ninja также могут быть использованы, но они требуют, чтобы проект обрабатывал больше аспектов, таких как выбор целевого процессора и кодирования.
Любая из трёх систем может быть целевой, установив переменную CMAKE_SYSTEM_NAME на значение из таблицы ниже. По умолчанию выбирается последняя версия Device SDK. Как и для всех платформ Apple, можно выбрать другой SDK (например, симулятор), установив переменную CMAKE_OSX_SYSROOT, хотя это редко необходимо (см. Переключение между устройством и симулятором ниже). Список доступных SDK можно получить, выполнив xcodebuild -showsdks.
ОС | CMAKE_SYSTEM_NAME | Device SDK (по умолчанию) | SDK симулятора |
|---|---|---|---|
iOS | iOS | iphoneos | iphonesimulator |
tvOS | tvOS | appletvos | appletvsimulator |
watchOS | watchOS | watchos | watchsimulator |
Например, для создания конфигурации CMake для iOS достаточно следующей команды:
cmake .. -GXcode -DCMAKE_SYSTEM_NAME=iOS
Переменная CMAKE_OSX_ARCHITECTURES может быть использована для установки архитектур как для устройства, так и для симулятора. Переменная CMAKE_OSX_DEPLOYMENT_TARGET может быть использована для установки целевого значения iOS/tvOS/watchOS.
Следующая конфигурация установит библиотеку iOS для 5 архитектур и добавит флаги -miphoneos-version-min=9.3/-mios-simulator-version-min=9.3 к компилятору:
$ cmake -S. -B_builds -GXcode \
-DCMAKE_SYSTEM_NAME=iOS \
"-DCMAKE_OSX_ARCHITECTURES=armv7;armv7s;arm64;i386;x86_64" \
-DCMAKE_OSX_DEPLOYMENT_TARGET=9.3 \
-DCMAKE_INSTALL_PREFIX=`pwd`/_install \
-DCMAKE_XCODE_ATTRIBUTE_ONLY_ACTIVE_ARCH=NO \
-DCMAKE_IOS_INSTALL_COMBINED=YES
Пример:
# CMakeLists.txt cmake_minimum_required(VERSION 3.14) project(foo) add_library(foo foo.cpp) install(TARGETS foo DESTINATION lib)
Установить:
$ cmake --build _builds --config Release --target install
Проверить библиотеку:
$ lipo -info _install/lib/libfoo.a Architectures in the fat file: _install/lib/libfoo.a are: i386 armv7 armv7s x86_64 arm64
$ otool -l _install/lib/libfoo.a | grep -A2 LC_VERSION_MIN_IPHONEOS
cmd LC_VERSION_MIN_IPHONEOS
cmdsize 16
version 9.3
Подпись кода
Некоторые сборки библиотек для встроенных платформ Apple требуют обязательной подписи кода. Если используется генератор Xcode и требуется или желательна подпись кода, идентификатор команды разработчика можно указать через переменную CMake CMAKE_XCODE_ATTRIBUTE_DEVELOPMENT_TEAM. Этот идентификатор команды будет затем включён в сгенерированный проект Xcode. По умолчанию CMake избегает необходимости подписи кода во время внутренней фазы конфигурации (т.е. идентификация компилятора и обнаружение функций).
Переключение между устройством и симулятором
При конфигурации для встроенных платформ можно нацеливаться как на реальные устройства, так и на симулятор. Оба имеют свои отдельные SDK, но CMake поддерживает только указание одного SDK на этапе конфигурации. Это означает, что разработчик должен выбрать один из них во время конфигурации. При использовании генератора Xcode, это ограничение менее существенно, так как Xcode всё ещё позволяет создавать сборки как для устройства, так и для симулятора, даже если конфигурация проводилась только для одного из них. Внутри среды Xcode сборки выполняются для выбранной платформы "назначения". При сборке из командной строки желаемый sdk можно указать непосредственно, передав параметр -sdk подлежащему инструменту сборки (xcodebuild). Например:
$ cmake --build ... -- -sdk iphonesimulator
Обратите внимание, что проверки, выполненные во время конфигурации, проводились по отношению к SDK времени конфигурации и могут не выполняться для других SDK. Команды, такие как find_package(), find_library() и т. д., хранят и используют детали только для сконфигурированного SDK/платформы, поэтому они могут быть проблематичными при переключении между сборками для устройства и симулятора. Вы можете следовать следующим правилам, чтобы заставить работать конфигурацию устройства + симулятора:
- Используйте явную
-lфлаговую строку компоновщика, напримерtarget_link_libraries(foo PUBLIC "-lz") - Используйте явную
-frameworkфлаговую строку компоновщика, напримерtarget_link_libraries(foo PUBLIC "-framework CoreFoundation") - Используйте
find_package()только для библиотек, установленных с помощьюCMAKE_IOS_INSTALL_COMBINEDфункции
© 2000–2021 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.20/manual/cmake-toolchains.7.html