Развертывание приложений Qt в MS Windows

Материал из Wiki.crossplatform.ru

(Различия между версиями)
Перейти к: навигация, поиск
(dll'ки плагинов Qt)
Строка 19: Строка 19:
== dll'ки плагинов Qt ==
== dll'ки плагинов Qt ==
-
С плагинами Qt дела обстоят несколько сложнее. Причиной тому является факт жестко зашитых, в dll'ки, путей к плагинам Qt. Этот путь всегда выглядит так: {{cmd|%QTDIR%/Plugins/}}, где %QTDIR% - каталог, в котором собрана/установлена та версия библиотеки Qt, которая использовалась при сборке приложения. Следовательно, при запуске приложения, Qt ядро вашей программы (QtCore4.dll) будет пытатся найти плагины Qt в каталоге {{cmd|%QTDIR%/Plugins/}}. Вероятнее всего на компьютере пользователя такого каталога нет. Существует несколько способов обойти эту проблему. Далее описаны эти способы.
+
С плагинами Qt дела обстоят несколько сложнее. Причиной тому является факт жестко зашитых, в dll'ки, путей к плагинам Qt. Этот путь всегда выглядит так: {{cmd|%QTDIR%/Plugins/}}, где %QTDIR% - каталог, в котором собрана/установлена та версия библиотеки Qt, которая использовалась при сборке приложения. Следовательно, при запуске приложения, Qt ядро вашей программы (QtCore4.dll) будет пытатся найти плагины Qt в каталоге {{cmd|%QTDIR%/Plugins/}}. Вероятнее всего на компьютере пользователя такого каталога нет. Существует несколько способов указать приложению, где искать плагины. Далее описаны эти способы.
 +
 
 +
=== Копирование плагинов в каталог с программой ===
 +
Как сказано в Асистенте (plugins-howto.html)
 +
{{цитата|Когда приложение запущено, Qt сначала просматривает каталог исполняемого файла приложения в качестве '''pluginsbase'''. Например, если приложение находится в C:\Program Files\MyApp и имеет подключаемый модуль стиля, Qt будет искать в C:\Program Files\MyApp\styles.}} Другими словами, каталоги плагинов Qt (например, '''imageformats''' или '''sqldrivers''') необходимо скопировать в каталог, где расположен исполняемый фал приложения
=== Указание путей в самой программе ===
=== Указание путей в самой программе ===
Строка 47: Строка 51:
''(предстоит написать)''
''(предстоит написать)''
 +
=== Переменная окружения QT_PLUGIN_PATH ===
 +
''(предстоит написать)''
 +
 +
 +
 +
Подробности смотрите в документации в разделе [http://www.doc.crossplatform.ru/qt/4.4.3/plugins-howto.html Как создать свой плагин]
== См. также ==
== См. также ==

Версия 07:42, 19 декабря 2009

Как указано в Асистенте, библиотека Qt не является системной. Т.е. она не распространяется штатно с ОС MS Windows. Следовательно при распространении программ, написаных на Qt для ОС MS Windows необходимо вместе с вашей программой распространять и библиотеки (dll'ки) самой Qt.

Содержание


Общее описание

При распространении потребуются следующие dll'ки:

  • dll'ки компилятора (для MinGW32 - mingwm10.dll);
  • dll'ки Qt из катлога %QTDIR%/bin/;
  • dll'ки плагинов Qt из катлога %QTDIR%/Plugins/

dll'ки Qt

Из катлога %QTDIR%/bin/ необходимо взять dll'ки тех модулей которые вы используете. По умолчанию используются модули QtCore и QtGui (QtCore4.dll и QtGui4.dll, соответственно). И dll'ки других модулей, например, если в pro-файле есть запись:

QT += xml

то необходимо взять и QtXml4.dll.

Замечание Замечание: Если вы используете отладочную версию своей программы (CONFIG += debug), то нужно взять dll'ки с буквой "d":
QtCored4.dll, QtGuid4.dll и QtXmld4.dll
для примера выше.

Эти dll'ки должны быть помещены в один каталог с исполняемым файлом вашего приложения.

dll'ки плагинов Qt

С плагинами Qt дела обстоят несколько сложнее. Причиной тому является факт жестко зашитых, в dll'ки, путей к плагинам Qt. Этот путь всегда выглядит так: %QTDIR%/Plugins/, где %QTDIR% - каталог, в котором собрана/установлена та версия библиотеки Qt, которая использовалась при сборке приложения. Следовательно, при запуске приложения, Qt ядро вашей программы (QtCore4.dll) будет пытатся найти плагины Qt в каталоге %QTDIR%/Plugins/. Вероятнее всего на компьютере пользователя такого каталога нет. Существует несколько способов указать приложению, где искать плагины. Далее описаны эти способы.

Копирование плагинов в каталог с программой

Как сказано в Асистенте (plugins-howto.html)

« Когда приложение запущено, Qt сначала просматривает каталог исполняемого файла приложения в качестве pluginsbase. Например, если приложение находится в C:\Program Files\MyApp и имеет подключаемый модуль стиля, Qt будет искать в C:\Program Files\MyApp\styles. »
Другими словами, каталоги плагинов Qt (например, imageformats или sqldrivers) необходимо скопировать в каталог, где расположен исполняемый фал приложения

Указание путей в самой программе

В каталоге, куда устанавливается ваша программа, можно создать такой подкаталог %PATH_TO_APP%/QtPlugins/,
где %PATH_TO_APP% - путь к каталогу приложения.

В этот каталог необходимо скопировать из каталога %QTDIR%/Plugins/ все содержимое или только то, что вам действительно нужно.
Замечание Замечание: обязательно, сохраните структуру (иерархию) вложеных каталогов!

Затем вам нужно добавить несколько строк кода в ваше приложение. Функция main() должна выглядеть так:

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    ...
    // изменим каталог плагинов (добавим каталог установки программы)
    QStringList list_path;	// Список путей
 
    QDir dir = QDir(app.applicationDirPath()+"/QtPlugins/");	//Наш каталог %PATH_TO_APP%/QtPlugins/
    list_path << dir.absolutePath () << app.libraryPaths ();	//добавим в список и наши и стандартные пути
    app.setLibraryPaths( list_path  );				//Установим новый список путей поиска для приложения
    ...
}

Использование файла qt.config

(предстоит написать)

Переменная окружения QT_PLUGIN_PATH

(предстоит написать)


Подробности смотрите в документации в разделе Как создать свой плагин

См. также