Просмотр исходного текста страницы LXF109:CMake

===Первый пример===

В директории '''samples''' дистрибутива ''wxWidgets'' найдите поддиректорию '''minimal'''. Она содержит минимальный пример приложения ''wxWidgets''. Здесь также находятся файлы сборки приложения
на все случаи жизни; а вот '''CMakeLists.txt''' среди них нет. Давайте
исправим это упущение! Ниже приводится исходный текст файла '''CMakeLists.txt''' (который вы найдете на диске) для приложения
''minimal''. Чтобы упростить работу, мы разместим его в той же директории, что и исходные тексты приложения.

 project(minimal)
 cmake_minimum_required(VERSION 2.6)
 set(wxWidgets_USE_LIBS base core)
 find_package(wxWidgets REQUIRED)
 include(${wxWidgets_USE_FILE})
 set(minimal_SRCS minimal.cpp)
 if(WIN32)
 set(minimal_SRCS ${minimal_SRCS} minimal.rc)
 endif(WIN32)
 add_executable(minimal WIN32 ${minimal_SRCS})
 target_link_libraries(minimal ${wxWidgets_LIBRARIES})

{{Врезка|Содержание=[[Изображение:LXF109_93_1.jpg|300px|Рис. 1]] Рис. 1. ''Make''-файлы ''CMake'' в консоли Linux.|Ширина=300px}}

Те, кому сразу не терпится попробовать, могут скомандовать в
директории '''minimal'''

 cmake ./

после чего вызывать ''make''. Процесс сборки с помощью ''make''-файла,
сгенерированного ''CMake'', выглядит довольно красочно (рис. 1).

После окончания процесса можно скомандовать

 minimal

и посмотреть на работу программы, которую мы не написали, но собрали (рис. 2).

{{Врезка|Содержание=[[Изображение:LXF109_93_2.jpg|300px|Рис. 2]]Рис. 2. Приложение ''wxWidgets'' под Linux.|Ширина=300px}}

Прежде чем разбирать этот пример, рассмотрим кратко структуру языка сценариев ''CMake''. На протяжении всех последующих
статей мы, в основном, будем заниматься его изучением. Элементы языка сценариев ''CMake'' можно разделить на три категории: переменные, свойства и команды. Переменные играют в проектах ''CMake''
такую же важную роль, как и в файлах ''make''. Настройка параметров
сборки проекта выполняется, как правило, путем присвоения им
различных значений. С помощью свойств проект ''CMake'' получает
сведения о состоянии системы, для которой генерируются сборочные файлы. Свойства можно рассматривать как переменные,
доступные только для чтения. Значения свойств устанавливаются
средой ''CMake''. Команды, как вы, конечно, догадались, выполняют
различные действия с переменными и свойствами ''CMake'' и управляют процессом генерации сборочных файлов. Важной особенностью языка ''CMake'' является его расширяемость. Модули ''CMake'', о
которых говорилось выше, позволяют определять новые переменные, свойства и команды. Именно благодаря расширяемости языка
''CMake'' этот пакет может использоваться для сборки столь разных
проектов.

Перейдем теперь к рассмотрению файла '''CMakeLists.txt'''. Описание
сборки начинается с команды '''project()'''.

Команда '''project()''' задает имя проекта, а также позволяет указать (в виде необязательного параметра) язык программирования.
В качестве имени проекта мы взяли название компилируемой программы (это не обязательное правило ''CMake'', но так удобнее). Язык
программирования (''С, CXX, Java'') можно опустить. В этом случае
''CMake'' попробует «угадать» его по расширениям файлов исходных
текстов. Команда '''project()''' – не просто элемент оформления файла '''CMakeLists.txt'''. Помимо прочего, она определяет переменные '''projectname_SOURCE_DIR''' и '''projectname_BINARY_DIR'''. Как нетрудно догадаться, последние содержат имена директории исходных тестов (обычно тот же каталог, где расположен файл '''CMakeLists.txt''') и директории, в которой будет сохранен результат сборки.
Файлы программ по умолчанию собираются в той же директории,
где расположен файл '''CMakeLists.txt''', а файлы библиотек – в поддиректории '''lib''' этого каталога.

Команда '''cmake_minimum_required()''' позволяет задать минимальный номер версии ''CMake'', требуемый для сборки проекта.
Она не является обязательной, но весьма полезна, если файл
'''CMakeLists.txt''' использует возможности, появившиеся в последней версии ''CMake'', которая пока что есть не у всех. Если установленная в системе версия ''CMake'' не соответствует минимальным
требованиям файла '''CMakeLists.txt''', будет выдано сообщение об
ошибке.

Следующая команда, '''set()''', является одной из наиболее часто
используемых. Она позволяет присваивать переменным значения.
Первым аргументом команды должно быть имя переменной (если
переменной с таким именем ранее не существовало, она будет создана), далее следует список значений, которые ей присваиваются
(одной переменной можно присвоить сразу несколько значений).
Например, в команде

  set(wxWidgets_USE_LIBS base core)

мы присваиваем переменной '''wxWidgets_USE_LIBS''' (которая должна
содержать список требуемых программе модулей ''wxWidgets'') значения '''base''' и '''core'''. Переменные ''CMake'' можно использовать рекурсивно, то есть добавлять новые значения к списку уже имеющихся, как например, в строке

  set(minimal_SRCS ${minimal_SRCS} minimal.rc)

где к значениям переменной '''minimal_SRCS''' добавляется еще одно.
Обратите внимание на конструкцию '''${имя_переменной}'''. Она возвращает значение переменной с указанным именем (без символа
'''$''' и фигурных скобок ''CMake'' «не понял» бы, что тут имеется в виду
имя переменной). Правила использования имен и значений переменных в ''CMake'' похожи на правила для переменных окружения в
сценариях оболочки.

Команда '''find_package()''' – одна из важнейших в ''CMake''. В следующей статье мы остановимся на ней подробнее; сейчас скажем только, что '''find_package()''' загружает расширения ''CMake''. В
нашем примере загружается расширение '''wxWidgets''', предназначенное для генерации файлов сборки программ, использующих
''wxWidgets''. Важно подчеркнуть, что команда '''find_package()''' не ищет
сами библиотеки, она только загружает расширение ''CMake''. Поиск
библиотек, определение их версий и прочие действия, связанные с
библиотеками, выполняет загруженное расширение. Естественно,
что поскольку система ''CMake'' сама не выполняет сборку приложений, библиотеками она «интересуется» лишь с точки зрения генерации инструкций для сборочных файлов. В нашем примере команда
'''find_package()''' вызывается с опцией '''REQUIRED'''. Тем самым мы указываем ''CMake'', что если расширение для работы с '''wxWidgets''' не найдено, генерация файлов, необходимых для сборки приложения,
выполняться не может.

Команда '''add_executable()''' относится к числу тех, что устанавливают цели сборки. Собственно, она указывает, что ею является
исполняемый файл программы. Если бы мы собирали библиотеку, следовало бы использовать команду '''add_library()'''. Команда
'''add_executable()''' позволяет указать имя собираемого файла и связать с ним исходные тексты. Обратите внимание на опцию '''WIN32''', переданную команде '''add_executable()'''. Ее потребовалось упомянуть
для того, чтобы на платформе Windows создавались файлы сборки графического приложения (а не консольного, как это будет по
умолчанию). В Linux нет принципиальной разницы между структурой исполняемого файла графической и консольной программы
(в Windows – есть, интересующихся читателей отсылаю к соответствующей литературе). Как же отреагирует ''CMake'' для Linux на присутствие опции '''WIN32'''? Правильный ответ – никак, пакет ее просто
проигнорирует. Помимо файлов программ и библиотек, в проектах
''CMake'' можно задавать и другие цели, например, установку и упаковку приложений.

Последняя команда файла, '''target_link_libraries()''', указывает
''CMake'', какие инструкции следует добавить в сборочный файл для
подключения к проекту сторонних библиотек. Первый ее аргумент –
цель, определенная выше командой '''add_executable()''' (вообще говоря, целей сборки может быть несколько), далее идет список внешних библиотек, в которых она нуждается. В нашем примере он хранится в переменной '''wxWidgets_LIBRARIES''', определенной в расширении ''wxWidgets''. На содержимое переменной '''wxWidgets_LIBRARIES'''
влияет переменная '''wxWidgets_USE_LIBS''', вот почему значение ей
следует присвоить до обращения к команде '''find_package()'''.