В одном из уроков по Qt уже было показано, как собрать все DLL , применяемые в проекте для подготовки программы к использованию на других ПК, работающих под управлением ОС Windows , а теперь предлагаю ознакомиться с утилитой, которая поставляется вместе с Qt . Данная утилита называется windeployqt и является консольным приложением, которое, как правило, идёт в поставке с компиляторами MinGW или MSVC.
Для использования windeployqt необходимо запустить из консоли, передав в качестве аргумента путь к скомпилированному исполняемому файлу приложения. После чего windeployqt соберёт все необходимые библиотеки в папке, где располагается исполняемый файл.
Утилита windeployqt располагается в папке bin , которая в свою очередь располагается в папке компилятора для Qt. Таким образом, путь к папке может быть следующим:
- для MinGW - C:\QT\5.5\mingw492_32\bin\windeployqt.exe
- для MSVC - C:\QT\5.5\msvc2013\bin\windeployqt.exe
Работа с windeployqt
А теперь приступим к работе с windeployqt . Допустим, у Вас уже имеется скомпилированный исполняемый файл и требуется собрать все необходимые для его работы DLL. Для этого сделаем небольшую подготовку и перекинем исполняемый файл в подготовленную для сбора папку. Я использую для демонстрации проект EColor , который написан с использованием MinGW. Исполняемый файл проекта будет размещён по следующему пути D:\EColor\EColor.exe.
После чего необходимо будет открыть консоль ( cmd ), и перейти в консоле в папку с windeployqt. Далее запускаем утилиту передав ей путь расположения исполняемого файла, как показано на нижеследующем рисунке.
После чего утилита соберёт все необходимые для работы исполняемого файла DLL-ки. А выглядеть это будет следующим образом.
Возможные ошибки
Также стоит отметить, что не всё может пройти достаточно гладко. Например, windeployqt, может не найти библиотеки компилятора gcc и выдать следующую ошибку:
Cannot find GCC installation directory. g++.exe must be in the system path.
Это лечится прописыванием в переменных среды пути к папке bin, которая содержит GCC и соответствующие библиотеки.
Для этого идём по следующему направлению (пример для ОС Windows 7 ):
Панель Управления / Система / Дополнительные параметры системы / Переменные среды
После чего добавим переменную PATH в системные переменные, где будут прописаны пути к GCC и его библиотекам. В моём случае это выглядело так:
- Имя переменной: PATH
- Значение переменной: D:\AndroidQT\QT\5.5\mingw492_32\bin;D:\AndroidQT\QT\Tools\mingw492_32\bin;%PATH%
После чего рекомендую перезагрузить ПК. После этого ошибка должна будет пропасть, а соответствующие библиотеки должны будут подтянуться в папку с исполняемым файлом.
Файлы, которые могут быть не собраны windeployqt
Также, некоторые файлы могут быть не собраны с помощью windeployqt , что стоит также учесть и протестировать приложение на другом ПК перед выпуском.
К примеру при сборке DLL для EColor, windeployqt всё-таки пропустила следующие файлы:
- LIBEAY32.dll
- MSVCP90.dll
- MSVCR90.dll
- MSVCR120.dll
- ssleay32.dll
Если проект с использованием QML
UPD 19.11.2018 by alex_lip :
Если в проекте используется QML, то необходимо добавить специальную директиву --qmldir
Данная директива должна будет указать откуда брать исходники QML
windeployqt --qmldir f:\myApp\sources f:\build-myApp\myApp.exe
Добавьте в статью, что если используется Qml следует делать так -
For windeployqt there is the option
--qmldir.Спасибо, добавил
Тук-тук. Привет из прошлого! Не могли бы вы подробнее расказать о том, куда должна быть записана данная вставка "windeployqt --qmldir f:\myApp\sources f:\build-myApp\myApp.exe"? Я пробовал указать после пути распаковки .dll, но получаю ошибку.
f:\build-myApp\myApp.exe - это путь к .exe файлку, который я хочу открыть, я так понимаю, а первый что означает (f:\myApp\sources)? Это папка с релизом проекта или это папка с самим проектом (там где .pro-файл)? Заранее спасибо