Building Static Qt 6 for Desktop OpenGL on Ubuntu & Ubuntu WSL Статическая сборка Qt 6 для Desktop OpenGL в Ubuntu и Ubuntu WSL

1. (For Windows Users) Install Ubuntu WSL 1. (Для пользователей Windows) Установка Ubuntu WSL

If you are on Windows and want to develop inside Linux without dual-booting or heavy virtual machines, open CMD (or PowerShell) as Administrator and install Ubuntu under WSL: Если вы работаете в Windows и хотите разрабатывать под Linux без второй ОС и тяжелых виртуальных машин, откройте CMD (или PowerShell) от имени администратора и установите Ubuntu для WSL:

wsl --install -d Ubuntu

Restart your PC if prompted. Windows 11 and modern Windows 10 include WSLg, allowing Linux GUI and OpenGL applications to render directly on your Windows desktop with hardware acceleration. Перезагрузите ПК, если потребуется. В Windows 11 и обновленной Windows 10 встроен компонент WSLg, который позволяет выводить окна графических и OpenGL-приложений Linux прямо на рабочий стол Windows с аппаратным ускорением.

2. Prerequisites & System Packages 2. Необходимые системные пакеты

Inside your Ubuntu terminal (or Ubuntu WSL via wsl -d Ubuntu), install the compiler toolchain, CMake, Ninja, OpenGL development files, Wayland, and X11/xcb libraries: В терминале Ubuntu (или Ubuntu WSL через wsl -d Ubuntu) установите компиляторы GCC/G++, CMake, Ninja, заголовочные файлы OpenGL, Wayland и библиотеки X11/xcb:

sudo apt update && sudo apt install -y \
  build-essential \
  cmake \
  ninja-build \
  git \
  libgl1-mesa-dev \
  libglu1-mesa-dev \
  libegl1-mesa-dev \
  libx11-dev \
  libx11-xcb-dev \
  libxext-dev \
  libxfixes-dev \
  libxi-dev \
  libxrender-dev \
  libxcb1-dev \
  libxcb-glx0-dev \
  libxcb-keysyms1-dev \
  libxcb-image0-dev \
  libxcb-shm0-dev \
  libxcb-icccm4-dev \
  libxcb-sync-dev \
  libxcb-xfixes0-dev \
  libxcb-shape0-dev \
  libxcb-randr0-dev \
  libxcb-render-util0-dev \
  libxcb-xinerama0-dev \
  libxcb-xkb-dev \
  libxkbcommon-dev \
  libxkbcommon-x11-dev \
  libfontconfig1-dev \
  libfreetype6-dev \
  libwayland-dev \
  wayland-protocols \
  libdrm-dev \
  libgbm-dev

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

If you are on Windows, open your terminal (PowerShell or Windows Terminal) and explicitly launch your Ubuntu distribution using wsl -d Ubuntu (especially important if you have other distros like Fedora installed). Then create the source directory and clone qtbase: Если вы работаете в Windows, откройте терминал (PowerShell или Windows Terminal) и запустите именно дистрибутив Ubuntu командой wsl -d Ubuntu (это важно, если у вас установлены другие дистрибутивы, например Fedora). Затем создайте каталог и склонируйте qtbase:

# Launch specifically Ubuntu WSL (if on Windows)
wsl -d Ubuntu

# Create source directory in Linux home
mkdir -p ~/QtSource
cd ~/QtSource

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

4. Configure for Static Build into ~/libs/qt-6.12.0-static-gcc 4. Конфигурация статической сборки с установкой в ~/libs/qt-6.12.0-static-gcc

Create a separate build directory and configure Qt using the configure script. We include -no-feature-sql because SQL modules are not needed for pure OpenGL/QtWidgets applications and significantly speeds up compilation: Создайте отдельную папку для сборки и запустите конфигурацию с помощью скрипта configure. Мы указываем -no-feature-sql, так как SQL не требуется для чистых приложений OpenGL/QtWidgets и существенно ускоряет сборку:

mkdir -p ~/QtBuild
cd ~/QtBuild

~/QtSource/qtbase/configure \
  -static \
  -release \
  -prefix ~/libs/qt-6.12.0-static-gcc \
  -opengl desktop \
  -no-feature-sql \
  -nomake examples \
  -nomake tests

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

Run ninja (limiting to -j 4 is recommended in WSL2 to prevent memory exhaustion), then install: Запустите ninja (рекомендуется ограничить до -j 4 в WSL2, чтобы избежать исчерпания оперативной памяти), а затем установите:

ninja -j 4
ninja install

6. Project Configuration: Linking Static Qt with Wayland Support 6. Конфигурация проекта: линковка статического Qt с поддержкой Wayland

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

git clone https://github.com/ivan-enzhaev/opengl-test-qt6-desktop.git
cd opengl-test-qt6-desktop

In static Qt on Linux/WSL, platform plugins are static archives (e.g. libqwayland.a). To ensure your application initializes the Wayland window manager correctly: В статической сборке Qt под Linux/WSL платформенные плагины представляют собой статические архивы (например, libqwayland.a). Чтобы приложение корректно инициализировало окно под Wayland/WSLg:

1. In your main.cpp: 1. В вашем файле main.cpp:

Import the static Wayland plugin near the top of main.cpp: Импортируйте статический плагин Wayland в начале main.cpp:

#if defined(__linux__)
#include <QtPlugin>
Q_IMPORT_PLUGIN(QWaylandIntegrationPlugin)
#endif

2. Clean CMakeLists.txt Reference: 2. Содержимое файла CMakeLists.txt:

Use qt_add_executable, conditionally look up WaylandClient on Linux, and link the platform plugin: Используйте qt_add_executable, проверяйте WaylandClient только для Linux и подключайте платформенный плагин:

cmake_minimum_required(VERSION 3.21)
project(opengl-test-qt6-desktop LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 20)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

set(CMAKE_AUTOMOC ON)
set(CMAKE_AUTOUIC ON)
set(CMAKE_AUTORCC ON)

# -----------------------------------------------------------------------------
# Locate Packages
# -----------------------------------------------------------------------------
find_package(Qt6 REQUIRED COMPONENTS Widgets OpenGLWidgets)

# Wayland is only present and required on Linux (Ubuntu / WSL)
if(UNIX AND NOT APPLE)
    find_package(Qt6 REQUIRED COMPONENTS WaylandClient)
endif()

# -----------------------------------------------------------------------------
# Executable Target
# -----------------------------------------------------------------------------
qt_add_executable(app
    src/main.cpp
    src/mainwindow.h
    src/mainwindow.cpp
)

target_link_options(app PRIVATE -static-libgcc -static-libstdc++)

# -----------------------------------------------------------------------------
# Platform-Specific Link Flags & Libraries
# -----------------------------------------------------------------------------
if(WIN32)
    target_link_libraries(app PRIVATE
        Qt6::Widgets
        Qt6::OpenGLWidgets
        opengl32
    )
    target_link_options(app PRIVATE -static)
else()
    target_link_libraries(app PRIVATE
        $ENV{HOME}/libs/qt-6.12.0-static-gcc/plugins/platforms/libqwayland.a
        Qt6::Widgets
        Qt6::OpenGLWidgets
        Qt6::WaylandClient
        GL
    )
endif()

# Auto-strip symbols in Release builds for GCC / Clang
if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU" OR CMAKE_CXX_COMPILER_ID MATCHES "Clang")
    target_link_options(app PRIVATE
        $<$<CONFIG:Release>:-s>
    )
endif()

3. Build and Run via Terminal: 3. Сборка и запуск через терминал:

mkdir dist && cd dist

# Configure pointing to your static Qt
cmake -DCMAKE_PREFIX_PATH=$HOME/libs/qt-6.12.0-static-gcc \
      -DCMAKE_BUILD_TYPE=Release \
      -GNinja ..

# Build
ninja

# Run! Window appears seamlessly on Windows desktop via WSLg
./app

7. (Optional) Using Qt Creator on Native Ubuntu 7. (Опционально) Настройка в Qt Creator на нативной Ubuntu

If you prefer using the Qt Creator IDE on Native Ubuntu, open Edit > Preferences: Если вы предпочитаете IDE Qt Creator на нативной Ubuntu, откройте Edit > Preferences:

1. Qt Versions: Click Add and choose ~/libs/qt-6.12.0-static-gcc/bin/qmake. Qt Versions: Нажмите Add и укажите ~/libs/qt-6.12.0-static-gcc/bin/qmake.
2. Compilers: System GCC/G++ is auto-detected automatically. Compilers: Системный GCC/G++ определится автоматически в разделе Auto-detected.
3. Kits: Click Add:
   • Name: Qt 6.12.0 Static (GCC Linux)
   • Compiler C/C++: GCC / G++
   • Qt version: The static version registered in step 1
   • CMake Generator: Ninja
   Kits: Нажмите Add:
   • Name: Qt 6.12.0 Static (GCC Linux)
   • Compiler C/C++: GCC / G++
   • Qt version: Добавленная статическая версия из шага 1
   • CMake Generator: Ninja

Complete source code for this project is available on GitHub: Полный исходный код проекта доступен на GitHub:

View on GitHub Смотреть на GitHub