Редактирование: Распространение приложений для Windows

{{Панель навигации по Qt Quarterly|Выпуск 10}}

by Andy Shaw
<BLOCKQUOTE>''''''  
__TOC__
</BLOCKQUOTE>
Эта статья является второй в серии из трех статей, охватывающих распространение  приложений Qt на различных платформах. Основной упор делается на систему Windows.  Точно так же, как приложения ОС Mac X, распространение приложений под систему  Windows не требует никаких навыков в программировании на C++. Все, что вам нужно  сделать - это собрать Qt и ваше приложение в режиме релиза, также следуют придерживаться  процедур, описанных в этой статье. Мы продемонстрируем примеры прикладных показательных  программ, которые располагаются в директории Qt examples.

== Статические связи ==
Если вы хотите, чтобы все было просто, имея только единый запускаемый файл,  т.е. автономную выполняемую программу, то вы должны настроить некоторые параметры.  Как со статической линковкой на Mac ОС X, преимущества - то, что приложение  загрузится и выполнится быстрее, потому что все символы находятся в выполняемой  программе. Недостатки - это возрастание размера выполняемой программы, и факт,  что вы не можете использовать дополнений (плагинов) к программе.
 
Перед тем, как мы сможем собрать наше приложение, мы должны убедиться, что  Qt собрана правильно. Чтобы сделать это, требуется набрать в командной строке  следующее: 
<source lang="cpp-qt">
cd %QTDIR%
configure -static <и другие нужные вам параметры >
</source> 
Помните, определяя другие разные варианты, которые вам нужны, как, например,   поддержка потоков, вам требуется указать соответствующие аргументы для <tt>configure</tt>.   Как только <tt>configure</tt> отработает, вам требуется набрать следующее:
<source lang="cpp-qt">
make sub-src 
</source> 
Таким образом, Qt будет собран в статическом режиме релиза. [[#fn1 | <SUP>[1]</SUP>]]   Как только Qt собрана, вы можете приступить к сборке приложения <tt>showimg</tt>. 

Для начала мы должны зайти в директорию, который содержит приложения, которое мы хотим запустить:

<source lang="cpp-qt">cd examples\showimg</source> 

Мы должны теперь выполнить команду <TT>qmake</TT>, чтобы создать новый makefile   для прикладной программы, и сделать очистку билда, чтобы создать статически   связанный выполняемый модуль: 

<source lang="cpp-qt">
qmake showimg.pro
make clean
make 
 </source> 
Теперь, при условии, что все откомпилировано и связано без каких-либо ошибок,   мы должны получить файл <TT>showimg.exe</TT>, который готов для запуска. Единственный   наиболее простой путь для проверки, что приложение действительно может быть   запущено как автономное приложение - скопировать его на машину, на которой не   установлена Qt или какие-либо приложения Qt, и выполнить это приложение на этой   машине. 

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

Как и при использовании статической связи, прежде чем мы можем приступить   к сборке нашей прикладной программы, мы должны удостовериться в том, что Qt   собрана как общедоступная библиотека. Чтобы настроить данный параметр, требуется   перейти в режим командной строки и набрать следующее:

<source lang="cpp-qt">
cd %QTDIR%
configure -shared < и другие нужные вам параметры >
</source> 
Помните - для использования других параметров, которые вам требуются, нужно   указать их, перечислив после параметра <TT>configure</TT>. Так как мы все еще   используем приложение <TT>showimg</TT> в качестве примера, мы так же определим   <TT>plugin-imgfmt-jpeg</TT> как одну из опций, таким образом, она окажется в   списке плагинов. Когда <tt>configure</tt> отработает<tt>,</tt> требуется набрать   следующее:

<source lang="cpp-qt">make sub-plugins</source> 

Таким образом, мы собрали Qt как общедоступную библиотеку в режиме релиза,   и установили дополнительный формат изображения JPEG для использования в программе.   Когда Qt будет полностью собрана, мы можем запустить программу <TT>showimg</TT>.   Сначала мы должны войти в каталог, который содержит прикладную программу, которую   мы хотим запустить, для этого требуется выполнить следующее: 

<source lang="cpp-qt">cd ..\examples\showimg</source> 


Теперь выполните <TT>qmake</TT>, чтобы создать новый makefile для прикладной   программы, и очистить билд, чтобы создать динамически связанную выполняемую   программу:

<source lang="cpp-qt">
qmake showimg.pro
make clean
make
</source> 

Если все откомпилировано и связано без ошибок, мы получим файл <TT>showimg.exe</TT>.   Чтобы запустить программу, мы должны убедиться, что Qt DLL находится в той же   директории, что и выполняемая программа. Для начала мы проверим, что приложение   будет работать на разных платформах. Берем и копируем выполняемую программу   и Qt DLL на машину, на которой не установлена Qt или какие-либо приложения Qt.   Если вы хотите протестировать все на своей машине, удалите переменную окружения   QTDIR и удалите <TT>%QTDIR%\bin</TT> из переменной окружения PATH..

Мы должны получить выполняемую программу <TT>showimg.exe</TT> и Qt DLL (напр., <TT>qt331.dll</TT>, если вы произвели конфигурацию с поддержкой <TT>qt-mt331.dll</TT>), в одной директории. В командной строке теперь  наберите эту директорию и попробуйте запустить программу.

Если программа запустилась без всяких проблем, мы получили успешно отлинкованную   программу <TT>showimg</TT>. Если вы попытаетесь открыть PNG изображение, используя   данную программу, картинка отобразиться корректно, но если вы захотите открыть   JPEG картинку, ничего не произойдет, так как вы не подключили JPEG плагин к   приложению.

== Плагины ==
Плагины работают несколько по-другому, нежели обычные DLL. Мы всего лишь копируем   их в директорию с исполняемой программой, точно так, как мы делали с Qt DLL.   Приложения Qt ищут плагины к программе в подкаталоге в пределах их собственной   директории, например, плагин для изображений должен находиться в подкаталоге   <TT>imageformats</TT>, SQL драйвер должен находиться в подкаталоге <TT>sqldrivers</TT>.

Таким образом, чтобы сделать JPEG плагин  доступным для нашего приложения, нам требуется создать нужную директорию и скопировать туда требуемую DLL, например:

<source lang="cpp-qt">
mkdir imageformats
copy %QTDIR%\plugins\imageformats\qjpeg100.dll imageformats
</source> 

Если же вы не установили переменную окружения QTDIR, вы должны будете набирать   абсолютный путь к вашей Qt директории, нежели использовать %QTDIR%.) Если теперь   вы откроете JPEG изображение, то оно отобразится правильно.

Основное преимущество плагинов состоит в том, что они могут быть сделаны доступными   целому семейству программ. Например, ели мы имеем несколько программ, которые   нуждаются в поддержке JPEG модуля, рациональнее всего использовать общую директорию   для наших плагинов. Конечно, мы могли бы положить все наши плагины в директорию   <TT>"C:\QtPlugins"</TT>". Если мы используем текущую директорию, ты мы также   должны использовать поддиректории для различных плагинов, таким образом наш   плагин должен находиться в следующей поддиректории: "<TT>"C:\QtPlugins\imageformats"</TT>".   Чтобы наши приложения знали об этой директории, мы должны добавить следующую   строку перед тем, как программе потребуется загрузить данный плагин: 

<source lang="cpp-qt">qApp->addLibraryPath("C:\\QtPlugins");</source> 

Чаще всего удобнее добавить данную строку в начале главной программы <TT>main()</TT>.   Как только путь добавлен, программы будет использовать его для поиска плагинов,   а также просматривать подкаталоги своей директории. Таким образом, некоторое   количество путей будет добавлено.

== Динамические связи С ==
Иногда вам требуется поставлять свою программу с динамической библиотекой С.   Большинство версий Windows будет уже иметь установленную динамическую библиотеку, но если вы используете современный Visual Studio, то это не приемлемо. Мы можете   проверить с какими библиотеками связывается ваша программа, используя утилиту   <TT>depends</TT>. Чтобы использовать утилиту <TT>depends</TT>, вам требуется   выполнить следующее:

<source lang="cpp-qt">depends <application executable></source> 

Таким образом, вам выведется список библиотек, используемых вашей программой.   Если вы посмотрите в верхне - левую секцию, то увидите список библиотек.

== Завершение ==
Данная статья охватила ключевые аспекты распространения программы на Qt под   систему Windows. В данном документе мы не упомянули о версиях Windows, так как   в этом не было никакой потребности. Приложения, построенные на какой-то определенной   версии Windows, будут работать так же и на других. 

<HR width="25%">

<SUP>[1]</SUP> Отметьте, что мы использовали <TT>make</TT> во всех примерах, но если вы используете Microsoft Visual C++, вы должны использовать <TT>nmake.</TT>