project

Установите имя, версию и включите языки для всего проекта.

project(<PROJECT-NAME> [LANGUAGES] [<language-name>...])
project(<PROJECT-NAME>
        [VERSION <major>[.<minor>[.<patch>[.<tweak>]]]]
        [DESCRIPTION <project-description-string>]
        [LANGUAGES <language-name>...])

Устанавливает имя проекта и сохраняет имя в переменной PROJECT_NAME. Кроме того, это устанавливает переменные

• PROJECT_SOURCE_DIR, <PROJECT-NAME>_SOURCE_DIR
• PROJECT_BINARY_DIR, <PROJECT-NAME>_BINARY_DIR

Если VERSION указано, заданные компоненты должны быть целыми числами без знака. Если VERSION не указано, значение по умолчанию для версии — пустая строка. Опция VERSION может быть использована только если политика CMP0048 установлена в NEW.

Команда project() сохраняет номер версии и ее компоненты в переменные

• PROJECT_VERSION, <PROJECT-NAME>_VERSION
• PROJECT_VERSION_MAJOR, <PROJECT-NAME>_VERSION_MAJOR
• PROJECT_VERSION_MINOR, <PROJECT-NAME>_VERSION_MINOR
• PROJECT_VERSION_PATCH, <PROJECT-NAME>_VERSION_PATCH
• PROJECT_VERSION_TWEAK, <PROJECT-NAME>_VERSION_TWEAK

Переменные, соответствующие не указанным версиям, устанавливаются в пустую строку (если политика CMP0048 установлена в NEW).

Если опционально задано DESCRIPTION, то дополнительная переменная PROJECT_DESCRIPTION будет установлена в аргумент. Аргумент должен быть строкой с кратким описанием проекта (несколько слов).

Вы можете указать языки, поддерживаемые вашим проектом. Примеры языков: C, CXX (т.е. C++), CUDA, Fortran, и ASM. По умолчанию C и CXX включены, если не указаны другие языки. Укажите язык NONE, или используйте ключевое слово LANGUAGES и не перечисляйте языки, чтобы не включать никаких языков.

При включении ASM, укажите его в конце, чтобы CMake мог проверить, работают ли компиляторы для других языков, таких как C, и для ассемблера.

Если существует переменная CMAKE_PROJECT_<PROJECT-NAME>_INCLUDE, файл, на который ссылается эта переменная, будет включён в последнюю стадию команды проекта.

Файл верхнего уровня CMakeLists.txt для проекта должен содержать прямую ссылку на команду project(); загрузка через команду include() недостаточно. Если такой вызов отсутствует, CMake неявно добавит его вверху, чтобы включить языки по умолчанию (C и CXX).