try_compile

• Попытка компиляции целых проектов
• Попытка компиляции исходных файлов
• Другие параметры поведения

Попробуйте собрать некоторый код.

Попытка компиляции целых проектов

try_compile(RESULT_VAR <bindir> <srcdir>
            <projectName> [<targetName>] [CMAKE_FLAGS <flags>...]
            [OUTPUT_VARIABLE <var>])

Попробуйте собрать проект. Успех или неудача try_compile, т.е. TRUE или FALSE соответственно, возвращается в RESULT_VAR.

В этом формате <srcdir> должен содержать полный проект CMake с файлом CMakeLists.txt и всеми исходными файлами. Файлы <bindir> и <srcdir> не будут удалены после выполнения этой команды. Укажите <targetName>, чтобы собрать определённый целевой объект вместо целевого объекта all или ALL_BUILD. Значение других параметров см. ниже.

Попытка компиляции исходных файлов

try_compile(RESULT_VAR <bindir> <srcfile|SOURCES srcfile...>
            [CMAKE_FLAGS <flags>...]
            [COMPILE_DEFINITIONS <defs>...]
            [LINK_LIBRARIES <libs>...]
            [OUTPUT_VARIABLE <var>]
            [COPY_FILE <fileName> [COPY_FILE_ERROR <var>]]
            [<LANG>_STANDARD <std>]
            [<LANG>_STANDARD_REQUIRED <bool>]
            [<LANG>_EXTENSIONS <bool>]
            )

Попробуйте создать исполняемый файл из одного или нескольких исходных файлов. Успех или неудача try_compile, т.е. TRUE или FALSE соответственно, возвращается в RESULT_VAR.

В этом формате пользователю необходимо предоставить один или несколько исходных файлов, которые включают определение для main. CMake создаст файл CMakeLists.txt для сборки исходных файлов в исполняемый файл, который будет выглядеть примерно так:

add_definitions(<expanded COMPILE_DEFINITIONS from caller>)
include_directories(${INCLUDE_DIRECTORIES})
link_directories(${LINK_DIRECTORIES})
add_executable(cmTryCompileExec <srcfile>...)
target_link_libraries(cmTryCompileExec ${LINK_LIBRARIES})

Параметры:

CMAKE_FLAGS <flags>...

Указать флаги в формате -DVAR:TYPE=VALUE, которые необходимо передать команде cmake командной строки, используемой для управления сборкой теста. Приведённый выше пример показывает, как используются значения переменных INCLUDE_DIRECTORIES, LINK_DIRECTORIES, и LINK_LIBRARIES.

COMPILE_DEFINITIONS <defs>...

Указать аргументы -Ddefinition для передачи в add_definitions в сгенерированном тестовом проекте.

COPY_FILE <fileName>

Скопировать связанный исполняемый файл в указанный <fileName>.

COPY_FILE_ERROR <var>

Используйте после COPY_FILE, чтобы захватить в переменную <var> любое сообщение об ошибке, возникшее при попытке копирования файла.

LINK_LIBRARIES <libs>...

Указать библиотеки для связывания в сгенерированном проекте. Список библиотек может ссылаться на системные библиотеки и на Импортированные целевые объекты из вызываемого проекта.

Если этот параметр указан, любое значение -DLINK_LIBRARIES=... , заданное параметру CMAKE_FLAGS, будет проигнорировано.

OUTPUT_VARIABLE <var>

Сохранить вывод процесса сборки в указанной переменной.

<LANG>_STANDARD <std>

Указать свойство целевого объекта C_STANDARD, CXX_STANDARD или CUDA_STANDARD сгенерированного проекта.

<LANG>_STANDARD_REQUIRED <bool>

Указать свойство целевого объекта C_STANDARD_REQUIRED, CXX_STANDARD_REQUIRED или CUDA_STANDARD_REQUIRED сгенерированного проекта.

<LANG>_EXTENSIONS <bool>

Указать свойство целевого объекта C_EXTENSIONS, CXX_EXTENSIONS или CUDA_EXTENSIONS сгенерированного проекта.

В этой версии все файлы в <bindir>/CMakeFiles/CMakeTmp будут автоматически очищены. Для отладки можно передать --debug-trycompile в cmake, чтобы избежать этой очистки. Однако несколько последовательных операций try_compile повторно используют этот единственный выходной каталог. Если вы используете --debug-trycompile, вы можете отладить только один вызов try_compile за раз. Рекомендуемая процедура заключается в защите всех вызовов try_compile в вашем проекте с помощью логики if(NOT DEFINED RESULT_VAR), настроить с помощью CMake всё до конца один раз, затем удалить запись кеша, связанную с вызовом try_compile, в котором вы заинтересованы, и затем снова запустить cmake с --debug-trycompile.

Другие параметры поведения

Если установлены, следующие переменные передаются в сгенерированный CMakeLists.txt для инициализации свойств целевого объекта компиляции значениями по умолчанию:

• CMAKE_ENABLE_EXPORTS
• CMAKE_LINK_SEARCH_START_STATIC
• CMAKE_LINK_SEARCH_END_STATIC
• CMAKE_POSITION_INDEPENDENT_CODE

Если CMP0056 установлено в NEW, тогда CMAKE_EXE_LINKER_FLAGS также передаётся.

Текущее значение CMP0065 устанавливается в сгенерированном проекте.

Установите переменную CMAKE_TRY_COMPILE_CONFIGURATION, чтобы выбрать конфигурацию сборки.

Установите переменную CMAKE_TRY_COMPILE_TARGET_TYPE, чтобы указать тип целевого объекта, используемого для подписи исходного файла.

Установите переменную CMAKE_TRY_COMPILE_PLATFORM_VARIABLES, чтобы указать переменные, которые необходимо распространить в тестовый проект. Эта переменная предназначена только для использования в файлах инструментальных средств.

Если CMP0067 установлено в NEW, или используются какие-либо из опций <LANG>_STANDARD, <LANG>_STANDARD_REQUIRED, или <LANG>_EXTENSIONS, тогда переменные стандартного языка учитываются:

• CMAKE_C_STANDARD
• CMAKE_C_STANDARD_REQUIRED
• CMAKE_C_EXTENSIONS
• CMAKE_CXX_STANDARD
• CMAKE_CXX_STANDARD_REQUIRED
• CMAKE_CXX_EXTENSIONS
• CMAKE_CUDA_STANDARD
• CMAKE_CUDA_STANDARD_REQUIRED
• CMAKE_CUDA_EXTENSIONS

Их значения используются для установки соответствующих свойств целевого объекта в сгенерированном проекте (если они не переопределены явно).