Работа с Boost и CMake под Windows

Приветствую! Составил небольшую заметку по настройке и статической линковке библиотеки Boost с помощью CMake под Windows. Boost представляет собой набор библиотек на языке C++ с широким функционалом и является в некотором роде полигоном для апробирования некоторых идей, которые затем попадают в новые стандарты языка С++. Для установки и настройки CMake проекта прошу под кат!
Установка Boost
1. Скачивание и подготовка библиотеки
Скачайте библиотеку по адресу https://www.boost.org/users/download/ и распакуйте архив, например, в директорию C:/Boost. Затем перейдите в директорию и запустите файл bootstrap.bat, дождитесь окончания его работы. После этого запустите b2.exe и дождитесь окончания его работы. b2.exe осуществляет компиляцию исходного кода библиотек и у меня этот процесс занял более получаса. Точнее сказать не могу, так как оставил его работать и лёг спать, утром всё было готово.
2. Настройка CMake
Для подключения библиотеки Boost к вашему проекту добавьте следующие строки в CMakeLists.txt.
set (BOOST_ROOT "C:/boost_1_78_0/") # Путь к библиотеке Boost set (CMAKE_CXX_STANDARD 20) set (Boost_NO_SYSTEM_PATHS ON) set (Boost_USE_MULTITHREADED ON) set (Boost_USE_STATIC_LIBS ON) set (Boost_USE_STATIC_RUNTIME OFF) set (BOOST_ALL_DYN_LINK OFF) # Подключаем необходимые модули. Для примера подключим program_options find_package (Boost REQUIRED COMPONENTS program_options REQUIRED) # Если библиотека найдена, то if (Boost_FOUND) include_directories (SYSTEM $) # подключаем заголовочные файлы add_executable (Boost_test "main.cpp") # Создаем исполняемый файл для нашего проекта target_link_libraries (Boost_test $) # подключаем библиотеку endif ()
Обратите внимание на строку 16 – мы создаем исполняемый файл нашего проекта только в том случае, если библиотека найдена. Это условие не обязательно, но если вы работаете, например, в Visual Studio, то в случае отсутствия библиотеки, студия не будет отображать доступную к запуску цель, но и ошибки при компиляции не выдаст тоже. Использовать ли это условие или нет – выбор за вами.
Boost в действии
Давайте теперь для примера добавим в проект файл main.cpp со следующим кодом, взятым из примера работы с компонентом program_options библиотеки Boost:
#include #include using namespace std; namespace po = boost::program_options; int main(int argc, char* argv[]) < po::options_description desc("Allowed options"); int c; desc.add_options() ("help,h", "produce help message") ("compression,c", po::value()->default_value(3), "set compression level") ; po::variables_map vm; po::store(po::parse_command_line(argc, argv, desc), vm); po::notify(vm); if (vm.count("help")) < cout if (vm.count("compression")) < cout << "Compression level was set to " << vm["compression"].as() else < cout return 0; >
Program_options является обработчиком параметров командной строки и предоставляет удобный интерфейс для работы. В рассмотренном фрагменте создается экземпляр объекта program_options desc и устанавливается заголовок для отображения справки. Справка будет вызываться параметром –help или -h. Далее регистрируются доступные параметры, с указанием через запятую полной и укороченной версии и описания команды. Укороченная версия параметров не является обязательной и может быть опущена. Для параметра compression устанавливается значение по умолчанию = 3. Далее идёт обработка введённых параметров.
П.с. из-за установленного значения по умолчанию код в строке 30 никогда не выполняется.
Скомпилируйте программу и запустите её передавая следующие комбинации:
- Boost_test.exe
- Boost_test.exe -c 5
- Boost_test.exe -h
- Boost_test.exe –help
Справка о доступных параметров будет выглядеть так:
ЗлостныйКодер

Boost libraries — библиотеки которые расширяют еще больше функциональность C++. Boost библиотека в наше время незаменима, так как в ней есть библиотеки, которые очень часто применяются сейчас в программировании приложений и в ней есть библиотеки, которых нету в стандартном перечне библиотек С++.
Прежде чем мы начнем, надо скачать библиотеки с сайта:
Ссылка на архив: boost .zip — это версия 1.52, если вы хотите более новой версии, то на главной, где есть Current Releases и там будет показано, какая новая версия уже доступна.
Вот еще другой способ скачать:

- Заходим на главную boost.org
- Справа будет красная кнопка Get Boost , нажимаем по ней

3. Далее нажимаем по ссылке Download

4. Далее нас перебросят на страницу где можно будет скачать архив.
Итак, преположим, что все скачано. Распаковываем архив.
Теперь открываем Пуск->Все Программы->Microsoft Visual Studio->Visual Studio Tools->Visual Studio Command Prompt (2010).
ИЛИ Ищем в директории вот такой батник:
vcvarsall.bat

Появилась командная строка для VC2010. Пишем туда (Метка диска где вы распаковали архив, для меня это диск D, вот какую строку я написал «D:»)
Появилась метка тома D:\>

пишем туда: «cd <папка где лежит папка boost_1_52_0>«, в моем случае она лежит по пути D:\libraries, поэтому в моем случае я введу «cd libraries»папка>

Теперь введем имя папки cd boost_1_52_0 в вашем случае это будет папка где будет лежать bootstrap.bat

Теперь запустим тот самый батник bootstrap.bat, начнется построение exe файла bjam.exe. BJam- система построения boost’а. Он предназначен для построения С++ проектов. Пишет, что идет построение (building) и нужно подождать некоторое время пока закончится процесс.

Все! Процесс закончился. В папке boost_*_**_* появился bjam.exe. И в консоли выходит информация, что построение закончилось.

Не запускайте пока что его. Можно с помощью командной строки построить все скачанные библиотеки boost с помощью bjam. Напишем вот такую магическую строчку:
» bjam toolset=msvc link=static threading=multi release stage »
Сначала релизим статическую библиотеку(20 min 🙂 )
Потом дебажим
» bjam toolset=msvc link=static threading=multi debug stage »
Все. теперь все скомпилировано. Теперь нам надо настроить VS2010, для того, чтобы он видел где находятся эти файлы.
Запустим VS2010, запустим любой C++ проект. Включим Property Manager. View->Property Manager, там выберем во вкладке Debug Microsoft.Cpp.
Boost

Boost является одной из самых известных и наиболее часто используемых программистами С++ библиотек. Сейчас сложно даже представить область программирования (веду речь про С++), где бы не использовался boost или хотя бы отдельные его части. На самом деле буст это общее название, своеобразное знамя, собирающее под собой целую кучу различных библиотек, которые охватывают огромное количество повседневных задач. Именно из-за того, что boost значительно упрощает и ускоряет разработку ПО, он и завоевал такую большую популярность. Естественно, boost используется и при разработке игр, по тем же самым причинам: экономия времени, надёжность, проверенность временем, широкая известность (легко найти нужных программистов), простота использования.
Не подумайте, что я пишу все эти статьи по установке “лишнего” софта только от того, что мне нечего больше написать – просто этот софт нам понадобится уже в самых ближайших уроках и без него вы не сможете продолжить создание наших с вами общих игр.
Где взять Boost
Boost это свободное программное обеспечение и скачать его исходники можно с официального сайта . Кстати, там же находится и полная документация по всем его компонентам .
Компоненты Boost
Как я уже сказал, в состав boost входит довольно большое количество библиотек. Кстати, большой плюс буста в том, что он является кроссплатформенным, т.е. он работает и под Windows, и под Linux, и под MacOS – то есть под большинством наиболее распространённых операционных систем. И для того, что бы портировать вашу программу из-под Windows, например, под MacOS, вам не нужно будет даже прикасаться к коду, использующему boost – достаточно просто перекомпилировать программу и всё будет работать.
Наиболее часто используются следующие компоненты Boost:
- boost::asio – библиотека работы с сетью. Через некоторое время я покажу в уроках как его использовать.
- boost::bind – очень часто используемая библиотека, в ней находятся враперы для простого использования фукнторов, указателей на функции и т.д.
- boost::CRC – библиотека функций CRC (контрольные суммы)
- boost::DateTime – функции работы с датой/временем/периодами времени
- boost::Filesystem – функции работы с фалами и файловой системой
- boost::Function – врапперы для отложенного вызова функций и реализации коллбэков
- boost::Interprocess – функции для межпроцессоного взаимодействия. С их помощью разные процессы (программы) могут общаться друг с другом.
- boost::Pool – функционал для работы с пуллами
- boost::ProgramOptions – функции для простой работы с опицями программы
- boost::Python – обёртки для простой интеграции питона в ваши приложения или расшаривания ваших функций и библиотек в питон
- boost::Regex – библиотека для работы с регулярными выражениям
- boost::Serialization – сериализация и десериализация объектов. Можно использовать, например, для созхранения состояния игры в файл и для чтения из файла.
- boost::Signals/Signals2 – реализации концепции сигналов/слотов. Например, с помощью этой библиотеки можно организовать обмен сообщениями (между монстрами в игре, скажем)
- boost::SmartPtr – крайне часто используемая библиотека, реализующая концепцию умных указателей. Работать без неё просто невозможно )))
- ну и ещё много-много разных других компонент
Компиляция Boost
Часть библиотек из состава boost не требуют установки и вы можете использовать их просто через инклюды. Но значительную часть, всё же, придётся для начала скомпилировать в библиотеки. Самый простой метод, это использовать boost-jam. Скачайте его вот тут , вам нужен архив, который назвается (в данный момент последняя версия) boost-jam-3.1.18-1-ntx86.zip. В этом архиве находится файл bjam.exe , его надо поместить в какую-то папку, которая прописана в системе в переменной %PATH%. Я обычно кидаю его в C:/Windows/
Есть и более правильный способ: просто запустите в папке boost’а файлик bootstrap.bat – он соберёт для вас bjam последней версии, это надёжнее и более правильно.
Что бы посмотреть все доступные опции сборки надо ввести команду:
bjam --help
До начала сборки самого буста позаботьтесь о том, что бы на диске было свободно хотя бы 3-4 гигабайта свободного места. Ага, буст это штука немаленькая. Однако, не волнуйтесь – когда вы будете собирать свои программы с использованием буст, они не будут разрастаться до гигабайтных размеров – просто буст собирает все библиотеки в куче разных вариантов (линковки), да и потом, при сборке ваших программ, в них будут добавляться лишь реально используемые вами функции буста, а вовсе не вся библиотека. Если какие-то из вариантов линковки вы не собираетесь использовать никогда – вы можете отключить их компиляцию и тогда сборка буста пройдёт существенно быстрее. Однако, никогда наперёд не знаешь, понадобиться оно или нет, потому лучше скомпилировать всё – пусть будет, лишним не будет.
Итак, давайте запустим сборку:
bjam --build-type=complete msvc stage --without-python
Я отключил сорку буст-питон, т.к. он нам не нужен. Если вам он нужен и питон (включая исходники и либы) стоит у вас на компе – не отключайте его.
Теперь можно налить себе кофе, включить любимый сериал и долго-долго смотреть его… Процесс компиляции буста очень (ну оооочень) не быстрый. Я вас очень прошу – сделайте сборку буста сами, не пытайтесь найти где скачать её в сети – даже если вы сможете найти, есть очень большая вероятность, что она у вас просто не зработает…
Во время компиляции может сыпаться довольного много варнингов – просто не обращайте на них внимания – сборка всё равно должна пройти успешно.
В зависимости от мощности вашего компьютера, где-то через 20-60 минут сборка буста закончится. В папке boost’а появится новая папка “stage/libs” – в ней лежат все собранные библиотеки буста.
Подключение Boost к Visual C++
Осталось только добавить эту папку в список папок билиотек Visual Studio. И в список папок-инклюдов добавить “ваша_папка_где_буст/boost” – там лежат инклюды буста, а в либы добавлем папку “где_лежит_буст/stage/lib”. На этом установка буста закончена и он готов к использованию. Что бы убедиться в этом, вы можете взять любой пример с сайта boost’а и попробовать его скомпилировать.
Этот урок закончен. В следующем уроке я расскажу вам о том, как поставить и настроить luabind, который сильно упростит нам жизнь, а точнее позволит более просто использовать lua-скрипты в наших программах.
Если у вас возникнут какие-либо трудности при установке буста, напишите в комментах – я постараюсь помочь каждому обратившемуся.
Как установить библиотеку boost?
Доброго времени суток. Нужна помощь!
Хочу установить библиотеку boost. Во всех туториалах люди заходят в консольку Visual Studio Command Prompt (2010). Но проблема в том, что я не могу ее найти! Искать в винде пробовал — не нашел.
У меня экспресс-версия! Дело в этом?
Отслеживать
51.2k 86 86 золотых знаков 266 266 серебряных знаков 505 505 бронзовых знаков
задан 19 окт 2014 в 16:17
65 1 1 золотой знак 1 1 серебряный знак 4 4 бронзовых знака
3 ответа 3
Сортировка: Сброс на вариант по умолчанию
Библиотека boost — это набор частично компилируемых исходных кодов. В некоторых случаях ничего не нужно собирать, достаточно скачать с официального сайта дистрибутив, разместить в удобном месте и в настройках проекта указать пути.
У меня в специальной папке, где я храню библиотеки многоразового использования, лежит подпапка boost_1_56_0 . Рядом с нею еще ряд других более старых версий этой библиотеки.
В переменные среды (в windows это там же, где и PATH) я заношу переменную BOOST_ROOT , которая указывает на последнюю сборку. Т.е. как появится новая, я создам папку boost_1_XX_Y и переназначу эту переменную.
В настройках любых проектов мне достаточно указать $(BOOST_ROOT)\include — для доступа к headers, и $(BOOST_ROOT)\stage\lib32 / $(BOOST_ROOT)\stage\lib64 для доступа к конкретным библиотекам, нужной мне разрядности.
Поскольку boost автоматически выдает имена собираемым библиотекам, с учетом компиляторов, которыми они собираются, даже если у Вас разные компиляторы, бинарники удобно сбрасывать в одну папку, как указано выше.
- С Intel Compiler у Вас получатся libboost_name-iw-type-version.lib .
- С Visual Studio у Вас получатся libboost_name-vcXX-type-version.lib , где XX — версия компилятора visual studio (не студии, а именно компилятора).
- С MinGW с gcc у Вас получится libboost_name-gcc-type-version.lib , если мне не изменяет память.
При этом для сборки библиотек, которые необходимо собирать, необходимо выполнить одни и те же действия в консоли:
- Для Intel Compiler это будет в соответствующем Command Prompt.
- Для Visual Studio это будет в соответствующем Command Prompt.
- Для MinGW это будет в обычной консоли, если, конечно, путь к bin в MinGW у Вас добавлен в переменную среды PATH.
Действия надо выполнить одни и те же. Сначала bootstrap.bat , а потом b2 —help .
В хелпе b2 Вы увидите все варианты настройки сборки, чтобы собрать наиболее удобным Вам образом.
Строчка будет выглядеть так:
b2 параметр1 параметр2 параметр3 .
- toolset — его стоит указать, чтобы сборка производилась конкретным компилятором (gcc, intel, visual studio), причем можно указать и версию компилятора.
- variant, вид сборки, debug или release. Для разработки Вам понадобятся оба варианта.
- link — Вы выбираете, будет Ваш бинарный код обращаться в dll или содержать «в себе» все используемые алгоритмы.
- threading — честно говоря, плохо понимаю смысл этой директивы и всегда указываю multi. Редко мы пишем однопоточные приложения.
- runtime-link — то же, что и link, только для рантайма.
- address-model — параметр не указан в хелпе, но помогает выбрать архитектуру собираемых библиотек.
- stage/install, отличаются лишь тем, что install позволит «выгрузить» только нужное в отдельную папку, stage собирает всё туда, где оно есть. Если Вы не увлекаетесь изменениями исходников boost, stage Вам вполне подойдет.
В итоге получается что-то вроде вот такого:
b2 toolset=vc120 variant=debug link=shared threading=multi runtime-link=shared address-model=32 stage
Для дебага в x32 и такого:
b2 toolset=vc120 variant=release link=static threading=multi runtime-link=shared address-model=32 stage
Для релиза в x32.
Ждете около 40 минут, радуетесь результату. В случае проблем — гуглите, скорее всего уже тысячи людей сталкивались с Вашей проблемой, и ее решение — невнимательность или какие-то специфические настройки чего-нибудь. Например, при сборке boost python вылезает много warning-ов на MinGW из-за конфликта хедеров, подобные вещи можно разрулить в частном порядке.
Потратив 2 часа на то, чтобы один раз в этом разобраться, Вы никогда не будете зависеть ни от каких сторонних сборок, будете понимать, где у Вас что лежит, кто туда положил и т.п. В общем, это полезно.
ЗЫ: Command Prompt находится в Visual Studio Tools. Или посмотрите в VStudio_PATH\CommonXX\Tools\VsDevCmd.bat