MS Windows (MinGW)

Необходимый инструментарий (Required tools)

1. Qt SDK for Open Source C++ development on Windows . В дистрибутив входит Qt, MinGW, Qt Creator. /~ 270 MB/
2. Win32 OpenSSL Libs - библиотеки шифрования /~ 7 MB/
3. Win32 Git - утилиты для работы с Git /~ 12 MB/
4. Microsoft Visual C++ 2008 SP1 Redistributable Package (x86 - for 32-bit systems) / (x64 - for 64-bit systems) /~ 5 MB/
5. Slik SVN - утилиты для работы с SVN /~ 5 MB/
6. TortoiseSVN - надстройка для проводника MS Windows, опционально (extension for MS Windows Explorer, optional) /~ 20 MB/
7. QConf - необходимый архив с бинарником здесь (necessary archive with qconf.exe here) /~ 0.1 MB/
8. Aspell Libs for msvc2008 - библиотеки для включения поддержки проверки орфографии (libraries for enable spell checking) /~ 65 MB/

Подготовка к сборке, настройка переменных окружения и необходимых библиотек (Preparations for the building, setting the environment variables and the necessary libraries)

• Устанавливаем необходимый инструментарий, указанный выше (пункты 1 - 6).

• Распаковываем папку QConf из архива qconf-1.5-win32-qt460.zip в папку C:\Qt

• Распаковываем папки include и lib из архива lyx-windows-deps-msvc2008.zip в папку C:\Qt\2010.02\mingw

• В свойствах компьютера (Start → Settings → Control Panel → System Properties → Advanced → Environment Variables) добавляем пути в переменную PATH (везде, при необходимости, пути следует заменить на свои):

C:\Qt\2010.02\qt\bin;C:\Qt\2010.02\mingw\bin;C:\OpenSSL\bin;C:\Program Files\SlikSvn\bin;C:\Program Files\Git\bin;C:\Qt\QConf

а также создаём новые переменные окружения (так же, при необходимости, заменив пути на свои):

QMAKESPEC=win32-g++
QTDIR=C:\Qt\2010.02\qt
OPENSSLDir=C:\OpenSSL

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

Проверка правильной установки и работоспособности Qt на примере сборки тестовой программы

• Запускаем командную строку cmd.exe с правами администратора (Start → Run → cmd)
• Проверяем правильность установки путей и переменных:

C:\>qmake -v
QMake version 2.01a
Using Qt version 4.6.2 in C:/Qt/2010.02/qt/lib

C:\>echo %QMAKESPEC%
win32-g++

• Меняем рабочую папку на C:\Qt\2010.02\qt\examples\tutorials
• В командной строке cmd.exe выполняем команду qmake, а затем команду mingw32-make

C:\Qt\2010.02\qt\examples\tutorials>qmake

C:\Qt\2010.02\qt\examples\tutorials>mingw32-make

...................
g++ -c -O2 -frtti -fexceptions -mthreads -Wall -DUNICODE -DQT_LARGEFILE_SUPPORT
-DQT_DLL -DQT_NO_DEBUG -DQT_GUI_LIB -DQT_CORE_LIB -DQT_THREAD_SUPPORT -DQT_NEEDS
_QMAIN -I'../../../../include/QtCore' -I'../../../../include/QtGui' -I'../../../
../include' -I'../../../../include/ActiveQt' -I'tmp/moc/release_shared' -I'../..
/../../mkspecs/win32-g++' -o tmp/obj/release_shared/moc_finddialog.o tmp/moc/rel
ease_shared/moc_finddialog.cpp
g++ -enable-stdcall-fixup -Wl,-enable-auto-import -Wl,-enable-runtime-pseudo-rel
oc -Wl,-s -mthreads -Wl -Wl,-subsystem,windows -o release/part7.exe tmp/obj/rele
ase_shared/addressbook.o tmp/obj/release_shared/finddialog.o tmp/obj/release_sha
red/main.o tmp/obj/release_shared/moc_addressbook.o tmp/obj/release_shared/moc_f
inddialog.o  -L'c:/Qt/2010.02/qt/lib' -L'c:/Qt/2010.02/qt/lib' -lmingw32 -lqtmai
n -lQtGui4 -lQtCore4
mingw32-make[3]: Leaving directory `c:/Qt/2010.02/qt/examples/tutorials/addressb
ook/part7'
mingw32-make[2]: Leaving directory `c:/Qt/2010.02/qt/examples/tutorials/addressb
ook/part7'
mingw32-make[1]: Leaving directory `c:/Qt/2010.02/qt/examples/tutorials/addressb
ook'

Результат сборки release-версии тестового приложения наблюдаем в папке C:\Qt\2010.02\qt\examples\tutorials\addressbook\part7\release

Успешная сборка тестового приложения означает, что Qt правильно установлена и работоспособна.

Сборка Psi+ в автоматическом режиме (Psi+ build in automatic mode) -- рекомендуется (recommended)

• Скачиваем скрипт make-psiplus.cmd в новую папку (например, C:\psi-plus\build)

• Запускаем скрипт make-psiplus.cmd из папки C:\psi-plus\build и ждём окончания его выполнения

Если скрипт отработал успешно, то в рабочей папке C:\psi-plus\build появится скомпилированный и готовый к работе бинарный файл psi.exe

Сборка Psi+ в ручном режиме (Psi+ build in manual mode) -- не рекомендуется (not recommended)

Получение исходных кодов Psi (Getting Psi source code)

• Скачиваем исходный код Psi из git-репозитория. Для этого запускаем cmd в папке psi-git и последовательно выполняем команды:

git clone git://git.psi-im.org/psi.git
cd psi
git submodule init
git submodule update

Подготовка исходных кодов Psi к сборке (Preparation Psi source code for building)

• В файле psi-git/conf_windows.pri раскомментируем 3-ю строку:

было

#CONFIG += qca-static

стало

CONFIG += qca-static

• Раскомментируем 26-ю строку:

было

    #DEFINES += HAVE_ASPELL 

стало

    DEFINES += HAVE_ASPELL 

• В файле psi-git/third-party/qca/qca-ossl.pri переименовываем ключ -llibeay32 в -leay32

• Для включения поддержки плагинов раскомментируем строку в файле psi-git/src/src.pro:

было

#CONFIG += psi_plugins

стало

CONFIG += psi_plugins

• Опционально: для переключения конфигурации (Release/Debug) в файле psi-git/conf_windows.pri необходимо изменить вторую строку c

CONFIG += release

на

CONFIG += debug

• Опционально: для включения автоматического вызова отладочной консоли при старте Psi+ в файле psi-git/src/src.pro добавляем строку:

CONFIG += console

• Опционально: для включения поддержки WebKit в Psi+ добавляем следующую строку в файле psi-git/conf_windows.pri:

CONFIG += webkit

Применение патчей к исходному коду Psi (Applying patches to Psi source code)

Перед использованием GNU/Patch for Windows необходимо учесть следующее:

On MS-Windows, the patchfile must be a text file, i.e. CR-LF must be used as line endings.
A file with LF may give the error: “Assertion failed, hunk, file patch.c, line 343,” unless the option ‘–binary’ is given.

• Запускаем cmd.exe в папке psi-git и последовательно выполняем следующие команды:

patch -p1 < 0000-psiplus-aboutdlg.diff
patch -p1 < 005-less-includes.diff
patch -p1 < 010-psi-additional-system-iconset.diff
patch -p1 < 040-psi-webkit.diff
patch -p1 < 050-psi-muc-topic.diff
patch -p1 < 060-psi-receipts.diff
patch -p1 < 080-psi-popup-avatar.diff
patch -p1 < 090-psi-entity-time.diff
patch -p1 < 100-psi-mood-icons.diff
patch -p1 < 110-psi-muc-change-affiliation.diff
.....................

Примечание: Перед скачиванием и применением патчей, настоятельно рекомендуется проверить соответствие имён файлов с их текущим списком.

Процесс сборки Psi+ (Psi+ build process)

• Заходим в папку psi-git, где расположены скачанные файлы исходного кода Psi

• В данной папке выполняем команды qmake psi.pro и mingw32-make (или make clean и make).

Через некоторое время (10 - 40 минут) ищем результат компиляции в виде psi.exe в psi-git/src/release.

Примечание: размер файла psi.exe может быть различным (зависит от выбранной конфигурации debug/release):

• Для release-конфигурации размер может составлять от 5 MB до 12 MB
• Для debug-конфигурации - от 30 MB до 60 MB

Компиляция плагинов (Compiling plugins)

Conference Logger Plugin

• Скачиваем исходный код плагина conferenceloggerplugin

• Копируем файлы исходного кода плагина в папку psi-git/src/plugins/generic/conferenceloggerplugin

• Выполняем команду qmake conferenceloggerplugin.pro

• Выполняем команду mingw32-make -f makefile.release

C:\psi-plus\build\psi\src\plugins\generic\conferenceloggerplugin>qmake conferenceloggerplugin.pro

C:\psi-plus\build\psi\src\plugins\generic\conferenceloggerplugin>mingw32-make -f makefile.release

...................
C:/Qt/2010.02/qt/bin/moc.exe -DUNICODE -DQT_LARGEFILE_SUPPORT -DQT_DLL -DQT_NO_D
EBUG -DQT_PLUGIN -DQT_XML_LIB -DQT_GUI_LIB -DQT_CORE_LIB -DQT_THREAD_SUPPORT -I'
c:/Qt/2010.02/qt/include/QtCore' -I'c:/Qt/2010.02/qt/include/QtGui' -I'c:/Qt/201
0.02/qt/include/QtXml' -I'c:/Qt/2010.02/qt/include' -I'../../include' -I'c:/Qt/2
010.02/qt/include/ActiveQt' -I'release' -I'c:/Qt/2010.02/qt/mkspecs/win32-g++' -
D__GNUC__ -DWIN32 typeaheadfind.h -o release/moc_typeaheadfind.cpp
g++ -c -O2 -frtti -fexceptions -mthreads -Wall -DUNICODE -DQT_LARGEFILE_SUPPORT
-DQT_DLL -DQT_NO_DEBUG -DQT_PLUGIN -DQT_XML_LIB -DQT_GUI_LIB -DQT_CORE_LIB -DQT_
THREAD_SUPPORT -I'c:/Qt/2010.02/qt/include/QtCore' -I'c:/Qt/2010.02/qt/include/Q
tGui' -I'c:/Qt/2010.02/qt/include/QtXml' -I'c:/Qt/2010.02/qt/include' -I'../../i
nclude' -I'c:/Qt/2010.02/qt/include/ActiveQt' -I'release' -I'c:/Qt/2010.02/qt/mk
specs/win32-g++' -o release/moc_typeaheadfind.o release/moc_typeaheadfind.cpp
g++ -enable-stdcall-fixup -Wl,-enable-auto-import -Wl,-enable-runtime-pseudo-rel
oc -Wl,-s -mthreads -Wl -shared -Wl,--out-implib,release/libconferenceloggerplug
in.a -o release/conferenceloggerplugin.dll release/conferenceloggerplugin.o rele
ase/typeaheadfind.o release/moc_typeaheadfind.o  -L'c:/Qt/2010.02/qt/lib' -lQtXm
l4 -lQtGui4 -lQtCore4
Creating library file: release/libconferenceloggerplugin.a

• Скомпилированный плагин conferenceloggerplugin.dll наблюдаем в psi-git/src/plugins/generic/conferenceloggerplugin/release

Полезные ссылки (Links)

• http://psi-im.org/
• http://qt.nokia.com/
• DebugView for Windows