Установка Qt на Ubuntu: 3 способа, настройка и создание первого приложения | AdminWiki
Logo

Установка Qt на Ubuntu: Полное руководство для разработчиков C++

18 декабря 2025 8 мин. чтения #c++ #gui #linux #qt #qt creator #ubuntu #разработка #установка qt
Содержание статьи

Введение: Почему Qt и Ubuntu — идеальный дуэт

Представь, что ты начинаешь новый проект на C++ с графическим интерфейсом. Ты хочешь кроссплатформенность, мощные возможности и профессиональный инструментарий. Qt на Ubuntu — это именно то, что нужно. В этой статье я покажу тебе все способы установки Qt на Ubuntu, от самого простого до продвинутого, чтобы ты мог выбрать оптимальный вариант для своей работы.

Qt — это кроссплатформенный фреймворк для разработки на C++, который позволяет создавать приложения с графическим интерфейсом для Windows, Linux, macOS, Android и iOS. Ubuntu — одна из самых популярных платформ для разработки на Qt.

Подготовка системы перед установкой Qt

Давай разберем, какие зависимости нужно установить перед началом работы с Qt. Это важно для корректной работы компилятора и сборки проектов.

bash
# Обновляем список пакетов
sudo apt update

# Устанавливаем базовые инструменты разработки
sudo apt install -y build-essential

# Устанавливаем зависимости для Qt
sudo apt install -y libgl1-mesa-dev libglu1-mesa-dev freeglut3-dev mesa-common-dev

# Устанавливаем дополнительные библиотеки
sudo apt install -y libxcb-xinerama0-dev libxkbcommon-dev libxkbcommon-x11-dev

Способ 1: Установка Qt через менеджер пакетов apt

Это самый быстрый способ получить рабочую версию Qt. Он идеально подходит для новичков и тех, кому нужна стабильная версия.

bash
# Устанавливаем Qt и Qt Creator
sudo apt install -y qt5-default qtcreator

# Устанавливаем дополнительные модули Qt
sudo apt install -y qt5-doc qt5-doc-html qtbase5-doc-html
sudo apt install -y qtbase5-examples qtdeclarative5-examples

# Проверяем установку
qmake --version
Внимание! Установка через apt даст тебе версию Qt, которая есть в репозиториях Ubuntu. Она может быть не самой свежей, но гарантированно стабильной и протестированной.

Преимущества и недостатки apt-установки

Преимущества Недостатки
Быстрая и простая установка Не самая свежая версия
Автоматические обновления Ограниченный выбор модулей
Интеграция с системой Может быть не все компоненты
Не требует ручной настройки Занимает системное пространство

Способ 2: Установка через официальный онлайн-установщик

Этот способ дает полный контроль над версией и компонентами Qt. Идеально для профессиональной разработки.

Шаг 1: Скачивание установщика

bash
# Переходим в домашнюю директорию
cd ~

# Скачиваем установщик (замени версию на актуальную)
wget https://download.qt.io/official_releases/online_installers/qt-unified-linux-x64-online.run

# Делаем файл исполняемым
chmod +x qt-unified-linux-x64-online.run

Шаг 2: Запуск установщика

bash
# Запускаем установщик
./qt-unified-linux-x64-online.run

# Или с правами суперпользователя, если нужна системная установка
sudo ./qt-unified-linux-x64-online.run

Шаг 3: Выбор компонентов для установки

В установщике тебе будут предложены следующие основные компоненты:

  • Qt — основные библиотеки (выбери нужную версию, например, Qt 6.5.0)
  • Qt Creator — интегрированная среда разработки
  • Developer and Designer Tools — дополнительные инструменты
  • Qt для Android — если планируешь разработку под Android
  • Документация и примеры — очень полезно для обучения
Совет: Устанавливай Qt в домашнюю директорию (например, ~/Qt), чтобы не требовались права суперпользователя и можно было иметь несколько версий Qt одновременно.

Способ 3: Сборка Qt из исходных кодов

Это продвинутый способ для тех, кому нужна максимальная кастомизация или специфичная конфигурация.

bash
# Устанавливаем дополнительные зависимости для сборки
sudo apt install -y libfontconfig1-dev libfreetype6-dev libx11-dev libxext-dev libxfixes-dev libxi-dev libxrender-dev libxcb1-dev libx11-xcb-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-util-dev libxcb-xinerama0-dev libxcb-xkb-dev libxkbcommon-dev libxkbcommon-x11-dev

# Скачиваем исходники Qt (пример для версии 6.5.0)
git clone https://code.qt.io/qt/qt5.git
cd qt5
git checkout 6.5.0

# Инициализируем репозиторий
perl init-repository

# Создаем директорию для сборки
mkdir build
cd build

# Конфигурируем сборку
../configure -prefix /opt/qt-6.5.0 -opensource -confirm-license -nomake examples -nomake tests

# Собираем (это займет много времени!)
make -j$(nproc)

# Устанавливаем
sudo make install

Настройка Qt Creator после установки

После установки Qt нужно правильно настроить Qt Creator. Давай разберем основные шаги.

Добавление версии Qt в Qt Creator

  1. Открой Qt Creator
  2. Перейди в Tools → Options → Kits → Qt Versions
  3. Нажми "Add" и выбери qmake из установленной версии Qt (например, ~/Qt/6.5.0/gcc_64/bin/qmake)
  4. Перейди во вкладку Kits и создай новый Kit
  5. Выбери добавленную версию Qt и компилятор (обычно GCC)

Пример настройки .pro файла

pro
QT       += core gui

greaterThan(QT_MAJOR_VERSION, 4): QT += widgets

CONFIG += c++17

SOURCES += \
    main.cpp \
    mainwindow.cpp

HEADERS += \
    mainwindow.h

FORMS += \
    mainwindow.ui

# Default rules for deployment.
qnx: target.path = /tmp/$${TARGET}/bin
else: unix:!android: target.path = /opt/$${TARGET}/bin
!isEmpty(target.path): INSTALLS += target

Создание и запуск первого Qt-приложения

Давай создадим простое приложение, чтобы проверить, что все работает правильно.

cpp
// main.cpp
#include 
#include 
#include 

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    
    QPushButton button("Нажми меня!");
    button.resize(200, 100);
    
    QObject::connect(&button, &QPushButton::clicked, []() {
        QMessageBox::information(nullptr, "Поздравляю!", "Qt успешно установлен на Ubuntu!");
    });
    
    button.show();
    
    return app.exec();
}
bash
# Создаем проект
mkdir myfirstqtapp
cd myfirstqtapp

# Создаем .pro файл
cat > myfirstqtapp.pro << 'EOF'
QT += widgets
TARGET = myfirstqtapp
TEMPLATE = app
SOURCES += main.cpp
EOF

# Создаем main.cpp с кодом выше
# Собираем проект
qmake
make

# Запускаем приложение
./myfirstqtapp

Распространенные проблемы и их решения

Проблема 1: Не найден компилятор

bash
# Устанавливаем GCC и G++
sudo apt install -y gcc g++

# Проверяем установку
gcc --version
g++ --version

Проблема 2: Ошибки с OpenGL

bash
# Устанавливаем драйверы и библиотеки OpenGL
sudo apt install -y mesa-utils
sudo apt install -y libglu1-mesa-dev freeglut3-dev mesa-common-dev

# Проверяем поддержку OpenGL
glxinfo | grep "OpenGL version"

Проблема 3: Qt Creator не видит установленную версию Qt

Убедись, что:

  • Путь к qmake указан правильно
  • У тебя есть права на чтение директории с Qt
  • Версия Qt совместима с версией Qt Creator
  • Перезапусти Qt Creator после установки Qt

Оптимизация рабочего процесса

Несколько советов для эффективной работы с Qt на Ubuntu:

Настройка переменных окружения

bash
# Добавь в ~/.bashrc или ~/.zshrc
export QT_DIR="$HOME/Qt"
export PATH="$QT_DIR/Tools/QtCreator/bin:$QT_DIR/6.5.0/gcc_64/bin:$PATH"
export LD_LIBRARY_PATH="$QT_DIR/6.5.0/gcc_64/lib:$LD_LIBRARY_PATH"

# Применяем изменения
source ~/.bashrc

Полезные инструменты для разработки

  • Qt Designer — визуальный редактор интерфейсов
  • Qt Assistant — оффлайн документация
  • Qt Linguist — инструмент для интернационализации
  • qmake — система сборки Qt проектов
  • CMake — альтернативная система сборки (рекомендуется для новых проектов)

Часто задаваемые вопросы (FAQ)

Какую версию Qt выбрать для установки?

Для новых проектов рекомендую Qt 6.5 или новее. Для поддержки legacy-кода может потребоваться Qt 5.15. Установка через apt даст Qt 5, онлайн-установщик — на выбор.

Можно ли установить несколько версий Qt одновременно?

Да, можно. Устанавливай их в разные директории (например, ~/Qt/6.5.0 и ~/Qt/5.15.2) и выбирай нужную версию в Qt Creator через настройки Kits.

Как полностью удалить Qt с системы?

bash
# Для apt-установки
sudo apt remove --purge qt5-default qtcreator
sudo apt autoremove

# Для установки через онлайн-установщик
# Просто удали директорию с Qt (например, ~/Qt или /opt/Qt)

Нужны ли права суперпользователя для установки Qt?

Нет, если устанавливаешь в домашнюю директорию через онлайн-установщик. Для apt-установки или системной установки потребуются права sudo.

Как проверить, что Qt установлен корректно?

bash
# Проверяем qmake
qmake --version

# Проверяем наличие Qt Creator
qtcreator --version

# Создаем и запускаем тестовое приложение (см. пример выше)

Заключение

Установка Qt на Ubuntu — процесс, который может быть как простым (через apt), так и более гибким (через онлайн-установщик). Выбор способа зависит от твоих потребностей: если нужна быстрая установка стабильной версии — используй apt; если нужна конкретная версия или дополнительные модули — онлайн-установщик; если требуется максимальная кастомизация — сборка из исходников.

После установки не забудь настроить Qt Creator и проверить работу на простом примере. Qt на Ubuntu предоставляет мощную платформу для разработки кроссплатформенных приложений на C++, и теперь ты готов начать создавать свои проекты!

Дополнительные ресурсы: Официальная документация Qt, форум Qt Centre, примеры кода в директории examples установленной версии Qt.
Поделиться:
Сохранить гайд? В закладки браузера