Проверка компиляции и компоновки исходного кода Objective-C++
Новая в версии 3.16.
Проверяет, компилируется ли предоставленный исходный код Objective-C++ и может ли он быть скомпонован в исполняемый файл.
-
check_objcxx_source_compiles -
check_objcxx_source_compiles(<code> <resultVar> [FAIL_REGEX <regex1> [<regex2>...]])Проверяет, что предоставленный в
<code>исходный код может быть скомпилирован как файл Objective-C++ и скомпонован в исполняемый файл (следовательно, он должен содержать хотя бы функциюmain()). Результат будет сохранен во внутренней переменной кэша, указанной в<resultVar>, в виде булевого значения true для успеха и false для неудачи. ЕслиFAIL_REGEXуказано, то неудача определяется путем проверки, совпадает ли что-либо в выводе с одним из указанных регулярных выражений.Основная проверка выполняется с помощью команды
try_compile(). Команды компиляции и компоновки могут быть изменены установкой следующих переменных до вызоваcheck_objcxx_source_compiles():-
CMAKE_REQUIRED_FLAGS -
Дополнительные флаги, которые необходимо передать компилятору. Обратите внимание, что содержимое
CMAKE_OBJCXX_FLAGSи его соответствующая переменная конфигурации автоматически добавляются к команде компиляции перед содержимымCMAKE_REQUIRED_FLAGS. -
CMAKE_REQUIRED_DEFINITIONS -
Список определений компилятора в формате
-DFOOили-DFOO=bar. Определение для имени, указанного в<resultVar>, также будет автоматически добавлено. -
CMAKE_REQUIRED_INCLUDES -
Список путей поиска заголовков для передачи компилятору. Это будут единственные пути поиска заголовков, используемые
try_compile(), т.е. содержимое свойства каталогаINCLUDE_DIRECTORIESбудет проигнорировано. -
CMAKE_REQUIRED_LINK_OPTIONS -
Список опций для добавления к команде компоновки (подробнее см.
try_compile()). -
CMAKE_REQUIRED_LIBRARIES -
Список библиотек для добавления к команде компоновки. Это могут быть имена системных библиотек или Импортированные целевые объекты (подробнее см.
try_compile()). -
CMAKE_REQUIRED_QUIET -
Если эта переменная имеет булево значение true, все сообщения статуса, связанные с проверкой, будут подавлены.
Проверка выполняется только один раз, а результат кэшируется в переменной, имя которой указано в
<resultVar>. Каждый последующий запуск CMake будет использовать этот кэшированный результат, а не выполнять проверку снова, даже если<code>изменится. Чтобы принудительно пересчитать проверку, переменную, имя которой указано в<resultVar>, необходимо удалить из кэша вручную. -
© 2000–2020 Kitware, Inc. and Contributors
Licensed under the BSD 3-clause License.
https://cmake.org/cmake/help/v3.19/module/CheckOBJCXXSourceCompiles.html