Создание проекта в Qt Creator

Среда разработки Qt Creator не является неотъемлимым компонентом для разработки приложений с помощью фреймворка Qt, тем не менее он упрощает многие вещи, прежде всего конфигурацию и настройку построения приложения. Кроме того, Qt Creator предоставляет унифицированный интерфейс для основных операционных систем. И в дальнейшем я буду ориентироваться прежде всего на Qrt Creator.

Создадим первый проект. Для этого откроем Qt Creator и на стартовом экране выберем Create Project..., либо перейдем к пункту меню :

И нам откроется окно выбора типа проекта:

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

На следующем шаге надо указать имя проекта и его расположение. Пусть проект будет называться HelloApp:

Далее надо выбрать систему сборки. В данном случае у нас есть выбор между qmake, CMake и Qbs. У каждого из них есть свои особенности, но в данном случае не принципиально, какую именно использовать. Поэтому возьмем первую из них qmake, которая представляет собственную систему сборки Qt.

На следующем шаге нам отобразится окно с настройкой создаваемых файлов.

Оставим все эти настройки по умолчанию. Но для общего понимания вкратце пробежимся по ним:

• Class name: имя создаваемого класса приложения

• Base class: базовый класс, от которого будет наследоваться класс приложения. По умолчанию у нас есть выбор из QMainWindow, QWidget и QDialog. Если надо, чтобы было полноценное окно приложения с меню, панелями статуса, инструментов, то выбирается QMainWindow.

• Header file: заголовочный файл для описания функция класса

• Source file: файл с реализацией функционала класса

• Generate form: указывает, будет ли генерироваться файл формы

• Form file: имя файла формы, который будет генерироваться

При желании эти опции можно поизменять, но для первого приложения оставим все эти опции по умолчанию.

Qt Creator поставляется с инструментом Qt Linguist, который позволяет переводить приложение на разные языки. И на следующем шаге предлагается указать язык приложения.

На данный момент для нас это не актуально, поэтому ничего не будем вводить и пропустим этот шаг

На следующем шаге будет предложено выбрать комплект инструментов (kit) для сборки и запуска проекта. И в данном случае необходимо выбрать хотя бы один комплект. Например, в данном случае мы будет создавать настольное графическое приложение. Поэтому выберем пункт, название которого начинается с "Desktop". Например, для создания графического приложения под Windows я выбираю пункт Desktop (x86-windows-msvc2022-pe-64bit)

В зависимости от операционной системы набор комплектов может отличаться. Обычно комплекты определяются автоматически.

Однако может быть ситуация, когда в списке указаны комплекты, но они не активны, не доступны для выбора и отображаются серым цветом. В этом случае, возможно, имеются проблемы с настройкой комплекта, как например, в следующем случае:

В этом случае надо установить связь между нужным комплектом и установленной версией Qt. Как это сделать расказывается далее.

После выбора комплекта на финальном окне можно будет указать настройки контроля версий:

Оставим все поля по умолчанию и нажмем на кнопку "Finish" для создания проекта.

Установка связи между Qt и Qt Creator

Как правило, Qt Creator может автоматически подхватить установленный Qt, а также ряд дополнительных инструментов типа CMake, компиляторов для C/C++ и других. Однако если Qt Creator устанавливается отдельно от Qt (вручную или с помощью пакетного менеджера), то может потребоваться вручную установить связь между комплектом и версией Qt. Для этого в Qt Creator перейдем к пункту меню Tools -> External - > Configure... (или к пункту Edit-> Preferences):

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

Если здесь пусто, нажмем на кнопку "Add" и в открывшемся окне укажем путь к утилите qmake6 (qmake6.exe на windows). Например, в моем случае это путь "C:\Qt\6.6.1\msvc2019_64\bin". И затем нажмем на кнопку "Apply". Выше приведен пример с Windows, но те же самое характерно и для Linux/MacOS, только конкретные пути к qmake будут отличаться.

Далее на вкладке Kits находим выбираем нужный комплект и через поле Qt Version устанавливаем для него версию ферймворка Qt

Структура проекта

Итак, в результате Qt Creator создает проект следующего вида :

Слева отобразится дерево проекта, а справа будет открыт файл main.cpp. По умолчанию стартовый проект состоит из следующих файлов:

• HelloApp.pro: файл конфигурации проекта

• mainwindow.h: заголовочный файл с описанием класса MainWindow, который представляет графическое окно

• mainwindow.cpp: непосредственно сам функционал класса MainWindow

• main.cpp: файл с функцией main, в которой и происходит запуск приложения Qt и его окна в виде объекта класса MainWindow

• mainwindow.ui: xml-файл, который описывает интерфейс окна

Запуск проекта

Проект по умолчанию уже можно запустить. Для запуска проекта нажмем в Qt Creator в левом нижнем углу на зеленую стрелочку. Стоит отметить, что при компиляции мы можем проверить вывод окна "Compile Output" - здесь могут отображать различная важная информация, например, информация о возникших ошибках:

И при запуске проекта нам отобразится пустое окно приложения: