Настройка среды разработки Qt5 под Windows

В 1995 году вышла первая версия Qt, инструментария для разработки, который выгодно отличался тем, что предоставлял одинаковый API для разработки как в Windows так и в LInux. С тех пор многое поменялось, теперь вы можете использовать этот Qt5 совершенно бесплатно, при условии динамической линковки с библиотеками фреймворка.

Для создания программ на Qt5 под Windows потребуется MinGW – минималистическая среда разработки программ под Windows. А для установки мы будем использовать MSYS2 – надстройку над MinGW.

Введение

Инструментарий программиста за время с конца XX века претерпел множество изменений. В начале 90-х, когда я только знакомился с программированием, практический весь инструментарий для разработки ПО, в нашей стране, был «пиратским». Не было рынка программного обеспечения (ПО) и соответственно все пользовались тем, что продавалось на «Горбушке» и у «пиратов» на дискетах или дисках. В тоже время на западе практически все популярные среды для разработки ПО, например Borland Pascal, Borland C++, Delphi, C++ Builder и т.д. были платными.

Время шло, развивалось не только платное (проприетарное), но и свободно распространяемое программное обеспечение — это системы Unix/Linux и все производные от них. Развивался инструментарий для разработки для этих систем и, что самое главное, он был бесплатным. Сегодня, для того чтобы создать программу, необязательно тратить крупные суммы на покупку IDE для разработчика.

Qt5 предоставляет удобный и бесплатный инструментарий для разработки ПО на языке C++. Программы, написанные с помощью данного фреймворка, имеют нативный интерфейс что на Windows, что на Linux, а значит программисту не нужно заботиться о «подгонке» дизайна под конкретную ОС или дистрибутив.

Когда я первый раз устанавливал Qt5 c помощью MSYS2 я столкнулся со целым рядом проблем в процессе установки и настройки и это с учетом использования официального гайда по установке. В этой статье я по шагам опишу процесс установки, так что вы сможете без проблем установить среду разработки на ваш ПК.

Внимание! Чтобы избежать проблем и непонятных глюков, я настоятельно рекомендую удалить старые версии MinGW, если они установлены и Git for Windows. А также почистить переменные среды, удалив все старые ссылки на MinGW. В противном случае могут возникать конфликты и глюки при использовании разных версий библиотек и программ.

Установка

Прежде всего нужно скачать MSYS2. Идем на официальный сайт https://www.msys2.org/ и скачиваем дистрибутив для Windows.

Мы будет ставить 64-битную версию. На момент написания руководства, это версия msys2-x86_64-20190524.exe.

Рекомендую ставить msys2 в корень любого диска. По умолчанию он ставиться в папку c:\msys64 или c:\msys32.

Процесс установки элементарен, так что описывать его я не буду. Просто жмем “Далее”, а когда процесс закончиться – Завершить.

Откроется окно консоли Msys2

Базовая система у нас установлена, переходим к следующему этапу – обновлению.

Обновление

Сразу после установки нужно запустить обновление системы Msys2. Для этого в консоли пишем:

Начнется подготовка к обновлению:

В процессе обновления будет выдан запрос на установку, нажимаем Y и Enter

У меня посыпались множественные ошибки, в этом нет ничего страшного, просто закрываем окно консоли, на предупреждение нажимаем «ОК» и запускаем её снова.

Идем в папку C:\msys64 и запускаем msys2.exe

В консоли вводим:

В процессе обновления будет выдан запрос на установку, нажимаем Y и Enter

Начнется процесс скачивания обновлений и их установки, он может занять длительно время (здесь и далее я, я буду сокращать вывод команд установки и обновления):

Мы обновили базовую систему и все основные пакеты.

Для начала проверим, что се обновилось корректно, для этого поставим Git, он нам в любом случае понадобиться.

Установка C++

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

pacman -S base-devel git mercurial cvs wget p7zip

Нажимаем Y и Enter

Ждем загрузки и установки компонентов.

pacman -S perl ruby python2 mingw-w64-x86_64-toolchain

Нажимаем Y и Enter

Ждем загрузки и установки компонентов.

Установка нужных базовых компонентов завершена.

Установка Qt5

Запустим установку Qt5, в консоли введем:

pacman -S mingw-w64-x86_64-qt-creator mingw-w64-x86_64-clang

Обратите внимание, что загрузка и установка этих компонентов занимает много времени!

Ждем окончания скачивания и установки всех компонентов.

Установка qtcreator завершена, теперь нужно провести дополнительные настройки:

В консоли введем команду:

откроется окно «Переменные среды»

Выбираем переменную Path и нажимаем Изменить

Нажимаем «Создать» и прописываем

Запуск Qt Creator

Запустим обычную консоль cmd.exe

Если всё сделано правильно, запустится IDE Qt Creator:

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

Выберем меню Инструменты-> Параметры

Выберем пункт Среда и поле Язык выставим English

Теперь осталось только перезапустить Qt Creator

После перезапуска интерфейс среды разработки изменится на Английский.

Создадим новый проект

File –> New File or Project

Выбираем Application -> Qt Widgets Application и нажимаем на «Choose …»

В этом окне вы можете выбрать папку и название проекта, назовем проект qt_test

Далее нажимаем Next четыре раза

Теперь нам нужно выбрать Kit – набор разработчика. Выбираем Desktop Qt MinGW-w64 64bit (MSYS2)

Далее нажимаем Next и Finish

Теперь осталось только запустить сборку проекта, для того, чтобы проверить, что всё верно настроено.

Получаем ошибку, связанную с Vulkan SDK, в открывшемся окне жмем Yes. Эту ошибку можно смело проигнорировать.

У нас должно открыться пустое окно:

Вот и всё. Среда настроена и готова к использованию.

Заключение

Установка среды разработки и настройка Qt Creator не представляет больших проблем, но есть некоторые подводные камни и неочевидные вещи. Руководствуясь материалами данной статьи, вы сможете установить Qt5 на свой ПК и использовать Qt Creator, для разработки ПО.

В поддержку Qt

статьи в помощь разработчику

Установка библиотеки Qt

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

Использовать Центр приложений или Менеджер пакетов для установки библиотеки Qt 5, подобно тому, как это делалось для более ранних версий, не рекомендуется. Всретится меньше «подводных камней», если использовать для этой цели, скачанный с сайта разработчика, установочный файл под лицензией LGPL

qt-opensource-linux-x86-5.5.1.run 634 MB
(версия файла на момент написания статьи)

В свойствах файла на вкладке «Права» разрешаем выполнение его как программы, запускаем установщик и следуем указаниям. Предложение создать аккаунт Qt можно пропустить. По умолчанию будет предложен путь установки /home/login/Qt5.5.1 , где /home/login – Ваша домашняя папка, а login – имя пользователя. Можно оставить его или изменить, например, на /home/login/Qt/Qt5 . Остановимся на последнем варианте. При выборе компонентов установки отмечать установку исходников ( Source Components ) не имеет смысла. В итоге будут установлены

библиотека Qt 5.5.1 в папку /home/login/Qt/Qt5/5.5/gcc
Qt Creator 3.5.1 в папку /home/login/Qt/Qt5/Tools/QtCreator

Для того, чтобы файлы установленной библиотеки Qt 5 были доступны приложениям, необходимо выполнить некоторые действия. Во-первых, убедиться, что в файле /etc/ld.so.conf прописано

Во-вторых, создать файл /etc/ld.so.conf.d/qt5.conf со следующим содержимым

# Qt5 libs configuration
/home/login/Qt/Qt5/5.5/gcc/lib

И, в-третьих, выполнить в терминале

Установленный вместе с библиотекой Qt Creator (Community) автоматически создает связку инструментов, обладающую свойствами

Название:	Desktop Qt 5.5.1 GCC 32bit
Тип устройства:	Desktop
Устройство:	Локальный ПК (по умолчанию для Desktop)
Компилятор:	GCC (x86 32bit в /usr/bin)
Отладчик:	Система GDB в /usr/bin/gdb
Профиль Qt:	Qt 5.5.1 GCC 32bit

Для своей работы библиотека Qt 5.5.1 (версия на момент написания статьи) требует компилятор MinGW 4.9.2. Он установливается вместе с Qt, но доступен также и по отдельной ссылке (архив i686-4.9.2-release-posix-dwarf-rt_v3-rev1.7z ).

Для Установки Qt скачиваем с сайта разработчика установочный файл под лицензией LGPL

qt-opensource-windows-x86-mingw492-5.5.1.exe 998 MB

Запускаем установщик и следуем указаниям. Предложение создать аккаунт Qt можно пропустить. По умолчанию будет предложен путь установки C:\Qt\Qt5.5.1 , на него и будем ориентироваться. При выборе компонентов установки отмечать установку исходников ( Source Components ) не имеет смысла, а вот установку компилятора MinGW 4.9.2 следует отметить, если конечно Вы не устанавливали этот компонент отдельно. Папку ярлыков в меню «Пуск» называем Qt 5.5.1 MinGW 4.9.2 . В итоге будут установлены

библиотека Qt 5.5.1 в папку C:\Qt\Qt5.5.1\5.5\mingw492_32
компилятор MinGW 4.9.2 в папку C:\Qt\Qt5.5.1\Tools\mingw492_32
Qt Creator 3.5.1 в папку C:\Qt\Qt5.5.1\Tools\QtCreator

Установленный вместе с библиотекой Qt Creator (Community) автоматически создает связку инструментов, обладающую свойствами

Название:	Desktop Qt 5.5.1 MinGW 32bit
Тип устройства:	Desktop
Устройство:	Локальный ПК (по умолчанию для Desktop)
Компилятор:	MinGW 4.9.2 32bit
Отладчик:	GNU gdb 7.8 for MinGW 4.9.2 32bit
Профиль Qt:	Qt 5.5.1 MinGW 32bit

Qt 5 для MSVC 2010

Компилятор и отладчик для данной сборки Qt содержатся в инструментарии Windows SDK for Windows 7 . Инсрукции по его установке можно найти здесь.

Для Установки Qt скачиваем с сайта разработчика установочный файл под лицензией LGPL

qt-opensource-windows-x86-msvc2010-5.5.1.exe 725 MB
(версия файла на момент написания статьи)

Запускаем установщик и следуем указаниям. Предложение создать аккаунт Qt можно пропустить. По умолчанию будет предложен путь установки C:\Qt\Qt5.5.1 . Если Вы планируете использовать несколько сборок Qt одновременно (с MinGW и MSVC), то его следует изменить, например, на D:\Qt\Qt5.5.1-vs . При выборе компонентов установки отмечать установку исходников ( Source Components ) не имеет смысла. Папку ярлыков в меню «Пуск» называем Qt 5.5.1 MSVC 2010 . В итоге будут установлены

библиотека Qt 5.5.1 в папку D:\Qt\Qt5.5.1-vs\5.5\msvc2010
Qt Creator 3.5.1 в папку D:\Qt\Qt5.5.1-vs\Tools\QtCreator

Найдем командный файл D:\Qt\Qt5.5.1-vs\5.5\msvc2010\bin\qtenv2.bat , который вызывает оболочку командной строки Windows с настроенным окружением библиотеки Qt, и посмотрим его содержимое

echo off
echo Setting up environment for Qt usage.
set PATH =D:\Qt\Qt5.5.1-vs\bin; %PATH%
cd /D D:\Qt\Qt5.5.1-vs
echo Remember to call vcvarsall.bat to complete environment setup!

Как можно увидеть в предупреждении из последней строки для полноценной работы не хватает настройки окружения компилятора MSVC 2010. Чтобы исправить это, добавим в файл еще одну команду

call «C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\vcvarsall.bat» x86

Замечание. Для 32-разрядной ОС эта команда выглядит иначе

call «C:\Program Files\Microsoft Visual Studio 10.0\VC\vcvarsall.bat» x86

Установленный вместе с библиотекой Qt Creator (Community) автоматически создает связку инструментов, обладающую свойствами

Название:	Desktop Qt 5.5.1 MSVC2010 32bit
Тип устройства:	Desktop
Устройство:	Локальный ПК (по умолчанию для Desktop)
Компилятор:	Microsoft Windows SDK for Windows 7 (7.1.7600.0.30514) (x86)
Отладчик:	Обнаруженный CDB в .
Профиль Qt:	Qt 5.5.1 MSVC2010 32bit

О настройке Qt Creator и создании новых связок инструментов можно прочитать здесь.

Это новая редакция статьи, старая редакция доступна по ссылкам для Qt 5 и для Qt 4.

Qt Documentation

Contents

Installing Qt

You can install the Qt Framework and tools by using an online or offline installer, or by building the source packages yourself.

The installers allow you to download and install the following components:

• Qt libraries, prebuilt for a particular development platform (operating system and compiler)
• Qt Creator integrated development environment (IDE)
• Reference Documentation and examples
• Qt in source code form (needed only if you want to build the framework and tools yourself)
• Add-On components that are relevant for different platforms

Online Installation

In the online installer, you can select commercial or open source versions of Qt, tools, and Add-On components to install. Using the online installer requires signing in to your Qt Account. The installer retrieves the license attached to the account from a server and provides a list of available components corresponding to the license.

The online installer is available from the Qt Downloads page.

Offline Installation

An offline installer is a single package that contains all of Qt and Add-Ons relevant for a target platform. Users with a commercial license can either sign in with their Qt account or with their Qt license key during the installation process. The license key is available in the Qt Account Web portal.

The offline installer is available here.

Installation Process

To run the installer, you need a Qt Account. You can use your Qt Account credentials to sign-in to all Qt services, including the forums and wiki. If you do not already have a Qt Account, you can create one during the installation process.

To complete the installation, select the components that you want to install and follow the instructions of the installation program.

The following YouTube video gives a complete walk-through of the installation process:

Updating or Removing Qt

Once Qt is installed, you can use the Maintenance Tool under to add components and to update or remove installed components.

Platform Requirements

Specific requirements and instructions for developing applications on different platforms are covered in the platform pages.

For more information, visit the supported platforms page.

Create Your First Applications

Learn the basics of Qt and Qt Quick development by following the two tutorials below that illustrate how to create simple applications and build and run them on target platforms:

Qt Widgets provides a library of UI elements which allow you to create classic desktop-style user interfaces. Qt Quick is a library providing types and functionalities for building modern, fluid, animated UIs.

For a more thorough walkthrough of the different aspects of developing applications with Qt 5, see the QML Book. It focuses on Qt Quick, but also provides the information needed to use QML together with C++.

Explore Qt

We invite you to explore the rest of Qt. We prepared overviews which help you decide which APIs to use and our examples demonstrate how to use them.

To view a list of all Qt examples, visit the List of Qt Examples page.

Setting Up Projects

Developing with Qt Creator

Reference Documentation

• Qt Overviews — list of topics about application development
• Examples and Tutorials — code samples and tutorials
• Qt Reference Pages — a listing of C++ and QML APIs

Qt Project Community

Qt’s vibrant and active community site, http://qt.io houses a wiki, a forum, and additional learning guides and presentations.

В© 2021 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.