Статьи из цикла

В статье рассказывается как запускать приложения, созданные в Qt без самого Qt Creator. Или же приложения должны запускаться на компах, где нет Qt.

Для версии Qt под компилятор Visual Studio статья Запуск Qt приложений под Visual Studio .exe вне Qt Creator.

Тут расскажу о самом механизме нахождения DLL, так как Qt активно развивается и регулярно новые версии выпускает, и под каждую версию писать статью о новом наборе DLL накладно.

В качестве среды для разработки используется Qt 5.2.0 for Windows 32-bit (MinGW 4.8). Для версий не с компилятором MinGW алгоритм решение проблемы может быть иным.

Проблема

Допустим, мы создали базовое приложение Qt Widgets.

При запуске приложения в самом Qt Creator (при нажатии на зеленую стрелку, или же через меню, или же иным способом) мы видим наше приложение:

Запущенное приложение

Когда мы создавали приложение, то мы видели следующее окно:

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

Указанные тут папки и есть папки, куда сохраняется наше приложение.

Если мы перейдем в папку C:\Qt\build-Example-Desktop_Qt_5_2_0_MinGW_32bit-Debug (у вас папка может по-другому называться), то увидим следующее:

Папка с построенным проектом

Зайдем в папку debug и найдем там наше приложение:

Папка с EXE файлом приложения

Если мы его запустим, то получим ошибку:

Ошибка при запуске приложения

Как быть?

Первый способ — Официальная утилита windeployqt

У Qt есть утилита windeployqt, которая поставляется с Qt и про которую можно прочитать тут http://doc.qt.io/qt-5/windows-deployment.html. Она решает ту же задачу, что и второй способ ниже.

Update 2018. Сейчас библиотека стала работать гораздо лучше. Поэтому ниже будет более подробная инструкция по использованию windeployqt.

Итак, в командной строке перейдите в папку bin того компилятора, под которым вы компилируете приложение в режиме Release. В этой папке должен быть файл windeployqt.exe. Например, у меня в данный момент для MinGW это папка D:\Qt\5.12.0\mingw73_64\bin, а для Visual Studio D:\Qt\5.12.0\msvc2017_64\bin.

Перейти можно с помощью команды cd:

Командная строка в нужной папке

Скомпилируйте в режиме Release ваше приложение. Для примера я создал простое Qt Widgets Application и скомпилировал под MinGW компилятором:

Компилирование в режиме Release

Найдите папку, в которой находится скомпилированный EXE файл. Например, в моем случае это папка D:\Harrix\Projects\Qt\untitled\_build\release:

Папка с EXE файлом

Теперь можно в командной строке вызвать windeployqt с указанием папки с EXE файлом:

windeployqt D:\Harrix\Projects\Qt\untitled\_build\release

Вызов команды windeployqt

Теперь в папке добавились нужные файлы:

Папка с EXE файлом и DLL

Но если попробовать запустить EXE файл, то вылетит ошибка, так как три DLL не скопировались: libwinpthread-1.dll, libstdc++-6.dll, libgcc_s_seh-1.dll. Их нужно вручную скопировать из той же папки, где находится windeployqt.exe:

Папка с недостающими DLL

После этого приложение должно запуститься. Настоятельно рекомендую проверить работоспособность приложения на чистом компьютере без установленной Qt.

Для компилятора Visual Studio алгоритм тот же, но лучше еще добавить параметр --compiler-runtime, например:

windeployqt --compiler-runtime D:\Harrix\Projects\Qt\untitled\_build\release

Если у вас приложение с использованием QML, то нужен параметр --qmldir с указанием папки, где хранятся .qml файлы:

windeployqt --compiler-runtime --qmldir D:\Harrix\Projects\Qt\untitled D:\Harrix\Projects\Qt\untitled\_build\release

Стоит обратить внимание на то, что windeployqt может копировать лишние файлы. От них можно избавиться, потихоньку удаляя файлы из папки на чистом компьютере.

Второй способ — Ручной

Начало решения проблемы

Мы же хотим, чтобы приложение запускалось на других компах? Поэтому надо в окончательном виде выдавать приложение, а не в режиме отладки.

Внизу, над зеленым треугольником выбираем режим Release:

Режим Debug

Переключение в режим Release

Запускаем приложение, нажатием на зеленый треугольник:

Запущенное приложение

Как видим, через некоторое время запустилось привычное нам приложение. Но теперь *.exe файл появился в папке, которое мы указывали для Release:

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

Заходим в эту папку (у меня это C:\Qt\build-Example-Desktop_Qt_5_2_0_MinGW_32bit-Release):

Папка release

Если в прошлый раз мы заходили в папку debug, то сейчас заходим в папку release, и запускаем приложение:

Ошибка при запуске приложения

Кстати, для последующего распространения программы нам из папки нужен (из текущих файлов) только *.exe файл, поэтому файлы main.o, mainwindow.o, moc_mainwindow.cpp, moc_mainwindow.o можно удалить без ущерба (это служебные файлы, которые будут появляться при каждой компиляции).

Нахождение DLL и других файлов

Итак, приложение ругается на отсутствие Qt5Core.dll (у вас может быть цифра другая, если в момент чтения статьи вышла иная версия Qt). Где этот файл искать?

Найдите папку, в которую устанавливался Qt. У меня это папка C:\QtQt5.2.0

В ней найдите папку с номером версии вашего Qt. У меня это первая папка с названием 5.2.0-rc1. У вас скорее всего будет немного по-другому называться (у меня сейчас beta версия стоит):

Папка Qt

В ней будет папка компилятора MinGW:

Папка MinGW

Переходим в неё:

Содержимое папки MinGW

В ней находим главную папку bin:

Папка bin

И в этой папке находим нужные нам dll. Находим тут Qt5Core.dll (не Qt5Cored.dll!!!) и копируем в папку C:\Qt\build-Example-Desktop_Qt_5_2_0_MinGW_32bit-Release\release (где наш *.exe файл находится). И запустим приложение:

Ошибка при запуске приложения

И вот так копируем все нужные DLL, которые просит приложение. У меня потребовались следующие DLL: icudt51.dll, icuin51.dll, icuuc51.dll, libgcc_s_dw2-1.dll, libstdc++-6.dll, libwinpthread-1.dll, Qt5Core.dll, Qt5Gui.dll, Qt5Widgets.dll. И вот приложение запустилось:

Приложение запустилось

Ура! Но рано радоваться. Если мы запустим на компе, где нет Qt, то приложение выдаст ошибку, так как не может найти библиотеки. Надо скопировать еще несколько файлов. Помните основную папку Qt? Переходим в неё:

Папка Qt

Там есть папка Tools:

Папка Tools

В ней есть папка QtCreator:

Папка QtCreator

В ней папка bin:

Папка bin

Скопируйте файл qt.conf в папку с *.exe файлом:

Папка скомпилированного приложения

Теперь перейдите в папку с компилятором:

Папка MinGW

А там перейдем в папку plugins, а оттуда в platforms:

Папка plugins

Папка platforms

Скопируйте файлы qminimal.dll и qwindows.dll. Но вставим не просто в папку с *.exe файлом, там создадим папку plugins, а там папку platforms, и уже в нее вставим файлы. То есть для всех DLL, которые нам могут пригодиться, некоторые находятся не прямо в папке bin, то для этих DLL в папке с EXE файлом мы должны создать такие же папки, в которых они находились, относительно папки компилятора. В нашем случае в папке с компилятором файлы находись под именами: [путь к папке с компилятором] \plugins \platforms \qminimal.dll, [путь к папке с компилятором] \plugins \platforms \qwindows.dll. Поэтому копируйте так: [путь к папке с *.exe файлом] \plugins \platforms \qminimal.dll, [путь к папке с *.exe файлом] \plugins \platforms \qwindows.dll.

Вот теперь приложение запустится везде! То есть вы должны вместе с EXE файлом копировать все эти DLL и qt.conf. На скриншоте временные файлы я не удалил:

Итоговая папка со всеми дополнительными файлами

Здесь показан принцип, как находить нужные DLL. Если вы используете какие то другие компоненты, например, QWebView, то вам будут нужны еще другие DLL, которые вы находите аналогичным способом.

Помните, что если вы используется QtQuick то вам еще потребуется папка qml.

Внимание! Иногда описанный выше способ не помогает. Вроде скопировали все DLL, что вам могли пригодиться, приложение даже запускается, но вы видите лишь белый экран, например, или приложение вообще не появляется, но в диспетчере задач появляется.

В таком случае копируйте все DLL из папки bin (а из остальных мест в виде папок, где они хранятся) и начинайте скрупулезно удалять поштучно DLL до тех пор, пока не сузите число файлов до минимально работающего числа. Помните, что все DLL есть в двух вариантах: для release и ли debug режима. Для debug режима в имени DLL появляется буква d. Эти файлы вам не нужны!