Установка и модификация компонентов фреймворка Qt

Фреймворк Qt прост в установке и поставляется с собственной средой для быстрой разработки под названием Qt Creator. Вы так же можете использовать Qt из командной строки, или в других IDE (например MS Visual Studio). Установить Qt можно двумя способами, через оффлайн или онлайн инсталляторы. Рекомендуется выбрать второй, т.к. онлайн инсталлятор содержит больше версий Qt, вспомогательные утилиты и позволяет гибко управлять установленными пакетами.

Загрузка онлайн инсталлятора

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

Чтобы перейти к установке, скачаем онлайн инсталлятор:

  1. Перейдите на официальный сайт: https://www.qt.io/ и в правом верхнем углу нажмите кнопку Download.Try.
  2. Из доступных вариантов загрузки выберите Downloads for open source users;
  3. Ознакомьтесь с условиями использования или сразу промотайте страницу до кнопки Download the Qt Online Installer;
  4. Сайт попробует подобрать загрузчик под вашу операционную систему, но если ему это не удастся, можно выбрать нужную версию самостоятельно (View other options). Если всё правильно, нажмите кнопку Download.

Прежде чем перейти к установке

Для того, чтобы продолжить установку вам понадобится зарегистрироваться на сайте разработчиков Qt. Регистрация происходит стандартным образом, с подтверждением, посредством перехода по ссылке из письма. Крайне желательно не потерять доступ к почтовому ящику, к которому вы привязали аккаунт, чтобы иметь возможность восстановить забытый пароль. Причина в том, что любое действие по установке/обновлению/удалению отдельных пакетов фреймворка потребует от вас повторного введения логина/пароля от учётной записи, причём именно от той, которая использовалась, при первоначальной установке. Без авторизации доступно только полное удаление.

При установке на чистую операционную систему инсталлятор может отказаться запускаться, жалуясь на нехватку некоторых библиотек, например этих: MSVCP140.dll, VCRUNTIME140.dll. Чтобы вылечить данную ошибку нужно установить Распространяемый пакет Visual C++ для Visual Studio 2015. На странице загрузки вам предложат выбрать пакеты для приложений написанных под x64 или x86, на всякий случай можно установить оба.

Установка фреймворка

Перейдём непосредственно к установке фреймворка:

  1. Запустите онлайн инсталлятор;
  2. Введите данные учётной записи;
  3. Примите условия лицензии;
  4. Выберите отправлять или нет информацию о использовании фреймворка разработчикам.
  5. Выберите путь и вариант установки. Путь должен содержать только латинские символы и быть не очень длинным (желательно оставить дефолтный). Варианты установки:
    • Custom installation — выбор компонентов вручную (предпочтительный);
    • Design Tools — установка Qt Design Studio;
    • Qt 6.2 for mobile development — эквивалентно, ручному выбору компонент Qt 6.2 для компилятора MinGW (для десктопа), соответствующих компонентов Qt для android и компилятора MinGW 11.2.0 64-bit. Настраивать сборку под android, всё равно придётся вручную.
  6. Если вы выбрали ручной способ установки, то далее вы попадёте на экран Выбор компонентов, в остальных случаях, на экран установки.
  7. На экране Выбор компонентов разверните список под названием Qt. В результате вы увидите доступные версии фреймворка. Одновременно можно установить несколько разных версий, но как правило достаточно одной.
  8. Выберем последнюю, на данный момент это Qt 6.2.2. Развернём соответствующий список и из предложенного выберем: MinGW 9.0.0 64-bit (компоненты для разработки под десктоп) и Android (для разработки под android). Не стоит беспокоится, если вы выбрали больше/меньше/не то что хотели, т.к. это можно будет исправить по средством инструмента MaintenanceTool
    Краткое описание остальных пакетов:
    • WebAssambly — компоненты предназначенные для выполнения внутри виртуальной машины в браузере.
    • MSVC 2019 … — компоненты Qt для компилятора MS Visual Studio 2019. Нужны, если вы хотите использовать Qt в проектах Visual Studio;
    • MinGW … — компоненты Qt для инструментов сборки MinGW (компилятор gcc). Нужны, если вы планируете вести разработку в среде Qt Creator;
    • Android — компоненты Qt для разработки под android;
    • Sources — исходники компонентов Qt. Например, если вы захотите собрать библиотеки фреймворка под специфическую операционную систему или внести в них какие-то изменения;
    • Ещё в списке присутствуют дополнительные пакеты, например совместимость с Qt5 и т.п.
  9. Кроме компонент Qt нужно установить соответствующие инструменты сборки. Промотайте вниз и разверните пункт Developer and Designer Tools. Здесь есть список различных версий инструментов сборки MinGW. Обычно нужно выбирать такую же версию MinGW как и компонент (с учётом битности). Но в нашем случае подходящий версии нет, поэтому выбираем более позднюю MinGW 11.2.0 64-bit.
  10. Нажимаем Далее, принимаем лицензионное соглашение и переходим на экран установки, на котором будет показан необходимый объём дискового пространства. Установка будет происходить в каталог: C:\Qt.

Изменение состава установленных пакетов

Иногда нужно установить или удалить некоторые компоненты фреймворка Qt. Для этого служит инструмент MaintenanceTool, который расположен в корне каталога Qt (обычно C:\Qt).

Для любого действия кроме удаления вам понадобится ваша учётная запись, при этом, нужна именно та учётка, которая была использована при установке.

  1. Запустите MaintenanceTool и введите данные учетной записи.
  2. Выберите одну из трёх опций:
    • Добавление или удаление компонентов;
    • Обновление компонентов;
    • Удаление всех компонентов.
  3. Выберите необходимые или снимите галочки с ненужных компонентов. В нашем случае мы установим дополнительный комплект компонентов Qt 5.12.12 для десктопа и соответствующие инструменты сборки;
  4. После этого переходим непосредственно к установке/удалению.

Перед сборкой тестового проекта

У русскоязычных пользователей часто встречается проблема связанная с наличием русских символов в путях к проекту или фреймворку. Старайтесь использовать только латинские символы в названиях каталогов и файлов, т.к. в противном случае проект может не собраться, кидаясь невнятными сообщениями об ошибке. Например: Процесс «*\qmake.exe» завершился с кодом 2.

Вторая популярная проблема заключается в ограничении длины полного имени файла. Разработчики Qt Creator, по видимому любят всякое длинное, в отличие от разработчиков операционных систем, и в некоторых случаях, это может привести к проблемам при сборке проекта, без явного указания причины в сообщении об ошибке. По умолчанию в Windows существует ограничение на длину пути к файлу ~260 символов и периодически случается, что путь к каталогу сборки, который Qt Creator сгенерировал превышает это ограничение. Если вы попали в данную ситуацию, перейдите на вкладку Проекты и, для выбранного комплекта сборки, уменьшите имя Каталога сборки. Каталоги сборки для режимов Отладка, Сборка, Профилирование, нужно исправлять отдельно.

Сборка тестового приложения

Чтобы убедится, что всё установилось правильно, соберём проект из списка примеров. Чтобы запустить Qt Creator достаточно открыть меню пуск и набрать Qt и в результатах поиска выбрать Qt Creator 6.0.1 (Community). Если поиск не сработал, то можно вручную запустить файл qtcreator.exe, расположенный в каталоге C:\Qt\Tools\QtCreator\bin.

В качестве тестового проекта попробуем собрать пример под названием Calculator Example.

  1. Найдите его и щёлкните по карточке проекта. В результате вы увидите окно справки по проекту, которое можно спокойно закрыть.
  2. Сам Qt Creator при этом перейдёт на вкладку Проекты (кнопки для переключения вкладок расположены с левой стороны). Главное, что нужно сделать на этой вкладке — выбрать хотя бы один комплект сборки. Список комплектов расположен с левой стороны в разделе Сборка и запуск. В этом списке не будут отображены не совместимые или не настроенные комплекты сборки (в нашем случае комплект для android ещё не настроен).
  3. Теперь можно перейти на вкладку Редактор и изучить исходники проекта или сразу перейти к запуску.
  4. В нижней части окна Qt Creator, с левой стороны, расположены три кнопки для быстрой сборки и запуска:
    • Треугольник — сборка и запуск проекта;
    • Треугольник с жуком — сборка и запуск в отладочном режиме;
    • Молоток — только сборка, без запуска.