Подключаем GLFW

Подключишь к проекту библиотеку GLFW, которая откроет окно, и проверишь, что код GLFW собирается вместе с app.

Откроем наш проект в Visual Studio. Сейчас программа app только печатает строку в консоль. Движку нужно окно, в котором видеокарта будет рисовать картинку.

Окно в Windows создают через WinAPI, и это несколько сотен строк кода: зарегистрировать в Windows вид окна, создать окно, разбирать события, которые Windows присылает окну (нажатия клавиш, движение мыши, щелчок по крестику), и отдельно подготовить окно к рисованию через OpenGL. Такой код работает только в Windows. Поэтому окно откроет библиотека GLFW: она делает ту же работу несколькими вызовами, и те же вызовы работают на Linux и macOS.

FetchContent

GLFW — чужой код, и этот код нужно как-то получить. Можно скачать готовую библиотеку с сайта GLFW и прописать в проекте пути к файлам, но тогда каждый, кто скачает твой проект, должен повторить скачивание и настройку путей руками и угадать ту же версию библиотеки. Мы попросим CMake скачать GLFW самому. Это умеет модуль CMake FetchContent («получить содержимое»). Адрес и версия GLFW будут записаны в CMakeLists.txt, поэтому любой, кто откроет проект, получит ту же GLFW 3.5.1.

Вот что делал CMake, пока шла настройка. Реплики идут по строкам раздела «Dependencies», который ты дописал в CMakeLists.txt.

Как CMake FetchContent скачивает и подключает библиотеку

include(FetchContent)# --- GLFW -------------------------------------------------------------------set(GLFW_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)set(GLFW_BUILD_TESTS    OFF CACHE BOOL "" FORCE)set(GLFW_BUILD_DOCS     OFF CACHE BOOL "" FORCE)set(GLFW_INSTALL        OFF CACHE BOOL "" FORCE)FetchContent_Declare(    glfw    GIT_REPOSITORY https://github.com/glfw/glfw.git    GIT_TAG        3.5.1    GIT_SHALLOW    TRUE)FetchContent_MakeAvailable(glfw)

Теперь проверь в Visual Studio, что цель glfw появилась. Окно Solution ExplorerОбозреватель решений сейчас показывает папку проекта, а цели, о которых знает CMake, видны в другом его представлении. Переключи окно на CMake Targets View. В дереве раскрой строку Engine Project: там будет строка app (executable), то есть твоя программа, и ниже папка GLFW3 со строкой glfw (static library). Это и есть новая цель: «static library» значит статическая библиотека. Рядом в папке GLFW3 стоит ещё служебная цель update_mappings. Чтобы вернуться к папке на диске, снова нажми Switch Views и дважды щёлкни строку Folder View.

Подключить GLFW к app

Цель glfw есть в проекте, но app про неё ещё не знает. В CMakeLists.txt уже есть две команды, которые что-то сообщают цели app: target_compile_features говорила, что нужно программе («C++20»), а target_compile_options передавала компилятору флаг /W4. Третья команда того же вида, target_link_libraries, подключает к цели библиотеку.

Ты допишешь в CMakeLists.txt команду target_link_libraries. Эта одна команда настраивает сразу два шага сборки, и каждому нужно своё. Компилятору, который читает main.cpp, нужно знать, где лежит заголовок GLFW\glfw3.h, который подключает строка #include. Линкеру, который собирает готовую программу, нужен файл glfw3.lib с готовым кодом GLFW.

Ни путь к заголовку, ни имя файла glfw3.lib в команде писать не надо, хватает имени glfw: цель glfw сама хранит, что нужно тем, кто её подключает. Это записали авторы GLFW в файле glfw-src\src\CMakeLists.txt. Когда app подключает glfw, CMake сам передаёт компилятору папку out\build\vs2026\_deps\glfw-src\include, где лежит заголовок, а линкеру — файл glfw3.lib. Этот файл появится при сборке в папке out\build\vs2026\_deps\glfw-build\src\Debug.

glfwGetVersionString() только возвращает строку с версией GLFW. Эту функцию можно вызвать сразу, без подготовки библиотеки к работе, поэтому glfwGetVersionString удобна для проверки. Если строка напечаталась, сработали оба шага: компилятор нашёл заголовок GLFW/glfw3.h в папке, которую CMake передал от цели glfw, а линкер нашёл код функции в glfw3.lib.

Строка в консоли рассказывает, как собрана GLFW.

GLFW 3.5.1 Win32 WGL Null EGL OSMesa VisualC

Библиотеку можно собрать двумя способами: статической, файлом .lib, код которого входит в программу, или динамической, файлом .dll, который лежит рядом с программой отдельно. Если бы GLFW была динамической, строка версии в консоли заканчивалась бы словом DLL. Этого слова в строке нет, значит GLFW статическая: GLFW по умолчанию собирается статической, если в проекте не попросить другое, и код GLFW вошёл прямо в app.exe. Поэтому отдельный файл GLFW рядом с программой не нужен.

Итог

Проект скачивает GLFW 3.5.1 при настройке, собирает её как цель glfw и подключает к app, а программа печатает версию GLFW.

Так выглядят оба файла после главы:

cmake_minimum_required(VERSION 3.28)# ============================================================================# Project# ============================================================================project(Engine LANGUAGES CXX)# ============================================================================# Dependencies# ============================================================================include(FetchContent)# --- GLFW -------------------------------------------------------------------set(GLFW_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)set(GLFW_BUILD_TESTS    OFF CACHE BOOL "" FORCE)set(GLFW_BUILD_DOCS     OFF CACHE BOOL "" FORCE)set(GLFW_INSTALL        OFF CACHE BOOL "" FORCE)FetchContent_Declare(    glfw    GIT_REPOSITORY https://github.com/glfw/glfw.git    GIT_TAG        3.5.1    GIT_SHALLOW    TRUE)FetchContent_MakeAvailable(glfw)# ============================================================================# App# ============================================================================add_executable(app main.cpp)target_compile_features(app PRIVATE cxx_std_20)if(MSVC)    target_compile_options(app PRIVATE /W4)endif()target_link_libraries(app PRIVATE glfw)

#include <format>#include <iostream>#include <GLFW/glfw3.h>int main(){    std::cout << std::format("GLFW {}\n", glfwGetVersionString());    return 0;}