Building Static Qt 6 for Desktop OpenGL with MinGW GCC 16.2 Статическая сборка Qt 6 для Desktop OpenGL с MinGW GCC 16.2

1. Prerequisites 1. Необходимые инструменты

Before building, install the required toolchains and ensure their binary directories are added to your System PATH: Перед началом сборки установите необходимые инструменты и убедитесь, что пути к ним добавлены в переменную PATH:

• MinGW GCC 16.2.0 (WinLibs): Download from winlibs.com and extract to C:\mingw64_16.2 (Ninja is already included in WinLibs). MinGW GCC 16.2.0 (WinLibs): Скачайте с winlibs.com и распакуйте в C:\mingw64_16.2 (утилита Ninja уже входит в комплект WinLibs).
• CMake: Download and install from cmake.org (select "Add CMake to system PATH"). CMake: Скачайте и установите с cmake.org (выберите пункт "Add CMake to system PATH").
• Qt Creator: Download standalone installer from Qt Creator GitHub Releases. Qt Creator: Скачайте автономный установщик со страницы GitHub релизов Qt Creator.

2. Clone Only qtbase 2. Клонирование только модуля qtbase

Because you only need Desktop OpenGL, QWindow, and QtWidgets, you do not need the full umbrella Qt repository or Perl. Everything you need is inside qtbase: Так как для работы нужны только Desktop OpenGL, QWindow и QtWidgets, вам не требуется клонировать весь репозиторий Qt или устанавливать Perl. Всё необходимое уже находится внутри qtbase:

mkdir C:\QtSource
cd C:\QtSource

# Shallow clone of qtbase only (~150 MB download)
git clone --depth 1 -b v6.12.0 https://code.qt.io/qt/qtbase.git

3. Configure for Static Build 3. Конфигурация статической сборки

Create a separate build folder and configure Qt using configure.bat: Создайте отдельную папку для сборки и запустите конфигурацию с помощью configure.bat:

mkdir C:\QtBuild
cd C:\QtBuild

C:\QtSource\qtbase\configure.bat ^
  -static ^
  -release ^
  -prefix C:\Qt\6.12.0_static_mingw162 ^
  -opengl desktop ^
  -nomake examples ^
  -nomake tests

4. Compile and Install 4. Компиляция и установка

Run ninja to start building with all CPU threads, then install: Запустите ninja для многопоточной компиляции, а затем установите:

ninja
ninja install

5. Register Kit in Qt Creator 5. Настройка Kit в Qt Creator

Open Qt Creator and navigate to Edit > Preferences: Откройте Qt Creator и перейдите в Edit > Preferences:

1. Qt Versions: Click Add and select C:\Qt\6.12.0_static_mingw162\bin\qmake.exe Qt Versions: Нажмите Add и укажите C:\Qt\6.12.0_static_mingw162\bin\qmake.exe
2. Compilers: Verify your WinLibs GCC 16.2 (C and C++) compilers are detected under Auto-detected. Compilers: Убедитесь, что компиляторы WinLibs GCC 16.2 (C и C++) присутствуют в разделе Auto-detected.
3. Debuggers: Click Add, set Name to GDB (WinLibs MinGW 16.2), and point Path to your gdb.exe (e.g., C:\mingw64_16.2\bin\gdb.exe). Debuggers: Нажмите Add, назовите GDB (WinLibs MinGW 16.2) и укажите путь к gdb.exe (например, C:\mingw64_16.2\bin\gdb.exe).
4. Kits: Click Add:
   • Name: Qt 6.12.0 Static (MinGW 16.2)
   • Compiler C/C++: WinLibs GCC 16.2
   • Debugger: GDB (WinLibs MinGW 16.2)
   • Qt version: The static version registered in step 1
   • CMake Generator: Ninja
   Kits: Нажмите Add:
   • Name: Qt 6.12.0 Static (MinGW 16.2)
   • Compiler C/C++: WinLibs GCC 16.2
   • Debugger: GDB (WinLibs MinGW 16.2)
   • Qt version: Добавленная статическая версия из шага 1
   • CMake Generator: Ninja

6. Project Configuration & Testing in Qt Creator 6. Конфигурация проекта и запуск в Qt Creator

You can clone or download the complete ready-to-run demo project directly from GitHub: github.com/ivan-enzhaev/OpenGLTestQt6 Вы можете клонировать или скачать готовый к запуску демонстрационный проект с GitHub: github.com/ivan-enzhaev/OpenGLTestQt6

git clone https://github.com/ivan-enzhaev/OpenGLTestQt6.git

How to Open and Run in Qt Creator: Как открыть и запустить проект в Qt Creator:

1. In Qt Creator, click File > Open File or Project... (or press Ctrl+O). В Qt Creator нажмите File > Open File or Project... (или нажмите Ctrl+O).
2. Navigate to the cloned repository folder and select the CMakeLists.txt file. Перейдите в папку склонированного репозитория и выберите файл CMakeLists.txt.
3. In the Configure Project screen, select your kit Qt 6.12.0 Static (MinGW 16.2).
   Important: Only Debug is checked by default. Make sure to also check the Release checkbox so that Qt Creator configures the optimized release build! Then click Configure Project. На экране Configure Project выберите ваш Kit Qt 6.12.0 Static (MinGW 16.2).
   Важно: По умолчанию галочка стоит только на Debug. Обязательно поставьте галочку напротив Release, чтобы Qt Creator сконфигурировал оптимизированную Release-сборку! После этого нажмите Configure Project.
4. Switch the active build configuration to Release (click the monitor icon in the bottom-left corner of Qt Creator or press Ctrl+T). Переключите активную конфигурацию сборки на Release (нажмите на значок монитора в левом нижнем углу окна Qt Creator или нажмите Ctrl+T).
5. Press Ctrl+R to build and launch! The resulting single executable in the release build folder will be stripped down to ~30 MB and runs without needing any external DLLs. Нажмите Ctrl+R для сборки и запуска! Итоговый одиночный .exe файл в папке release-сборки будет автоматически сжат до ~30 МБ и запустится без каких-либо внешних DLL.

CMakeLists.txt Reference: Содержимое CMakeLists.txt:

Here is the clean CMakeLists.txt used in the repository, configured for static linking and automatic stripping: Минимальный и чистый CMakeLists.txt из репозитория с флагом -static и авто-strip для Release:

cmake_minimum_required(VERSION 3.21)
project(OpenGLTestQt6 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTOUIC ON)

find_package(Qt6 COMPONENTS Widgets OpenGLWidgets REQUIRED)

add_executable(OpenGLTest WIN32
    main.cpp
    mainwindow.cpp
    mainwindow.h
    mainwindow.ui
)

target_link_libraries(OpenGLTest PRIVATE
    Qt6::Widgets
    Qt6::OpenGLWidgets
    opengl32
)

if(MINGW)
    target_link_options(OpenGLTest PRIVATE
        -static
        $<$<CONFIG:Release>:-s>
    )
endif()