Это старая версия документа!
Содержание
Инструкция по сборке Psi+ в ОС MS Windows (MinGW)
Необходимый инструментарий
1. Qt libraries 4.8.7 for Windows (minGW v4.8.2) или скачать с основной страницы загрузок ~330 MB
2. MinGW v4.8.2 ~45 MB
3. CMake build system (win32) – версию 3.7.2 можно взять здесь ~14 MB
4. Git for Windows - набор утилит для работы с Git ~33 MB
5. OpenSSL – архив с исходным кодом пакета программ для поддержки шифрования и криптографии (версия > 1.0.0) ~4 MB
6. GNU IDN Library (LibIDN) – скомпилированную версию (v1.28) можно взять здесь или здесь ~0.5 MB
7. Zlib for Windows (скомпилированную версию можно взять здесь) (v1.2.8) ~0.05 MB
8. GnuPG (Package for Windows) - свежий win32-инсталлятор можно взять здесь
Опционально:
- TortoiseGit - надстройка для проводника MS Windows ~20 MB
- Aspell Libs for MinGW - библиотеки для обеспечения работы функционала проверки орфографии, необходимые для сборки файлы можно взять здесь ~0.5 MB
- Hunspell for MinGW - библиотека проверки орфографии
Python – только версии 2.x.x (x86) ~15 MBccache version 3.1 – утилита для ускорения процесса компиляции ~0.2 MBПримечание: для нормальной работы ccache необходимо прописать переменную CCACHE_DIR в переменных окружения.
Подготовка к сборке, настройка переменных окружения и необходимых библиотек
- Устанавливаем необходимый инструментарий, указанный выше. Git рекомендуется устанавливать в корень диска, например, в C:\Git
- Создаём в папке C:\MinGW\bin новый файл make.exe путём копирования и переименования из файла mingw32-make.exe (ВРЕМЕННЫЙ КОСТЫЛЬ)
- Распаковываем содержимое архива zlib-1.2.8-win32.7z в папку C:\Qt\zlib
- Распаковываем содержимое архива libidn-1.28-win32.zip в папку C:\Qt\LibIDN
- Скачиваем и распаковываем содержимое архива otrplugin-deps-mingw-win32.7z следующим образом:
- файлы из папки bin копируем в папку Psi+ (например, C:\Program Files (x86)\Psi+)
- папки include и lib копируем в папку C:\MinGW\i686-w64-mingw32
Распаковываем утилиту ccache.exe и библиотеку zlib1.dll из архива ccache-3.1-win32.7z в папку C:\MinGW\binРедактируем строки QMAKE_CC и QMAKE_CXX в файле C:\Qt\4.8.7\mkspecs\win32-g++\qmake.conf (дописываем ccache в следующих строках)
<code>
……..
QMAKE_CC = ccache $${CROSS_COMPILE}gcc
……..
QMAKE_CXX = ccache $${CROSS_COMPILE}g++
</code>
- В свойствах компьютера (Start → Settings → Control Panel → System Properties → Advanced → Environment Variables) добавляем необходимые пути в системную переменную PATH (при необходимости пути следует заменить на свои):
C:\>path
PATH=C:\MinGW\bin;C:\Qt\QConf;C:\cmake\bin;C:\Program Files (x86)\GNU\GnuPG\pub
А также создаём новые системные переменные (при необходимости заменив пути на свои):
GITDIR=C:\Git LIBIDNDIR=C:\Qt\LibIDN MINGWDIR=C:\MinGW OPENSSLDIR=C:\OpenSSL QCADIR=C:\Qt\QCA QCONFDIR=C:\Qt\QConf QMAKESPEC=win32-g++ QTDIR=C:\Qt\4.8.7 ZLIBDIR=C:\Qt\zlib
Примечание 1: Переменные обновятся только для вновь запущенных процессов, т.е. требуется перезапустить cmd с правами администратора (в крайнем случае - перезагрузить систему).
Примечание 2: Если у вас закрыт доступ наружу по порту 9418, то вы не сможете скачать исходный код Psi и Psi+ по протоколу git://. В этом случае рекомендуется в глобальном конфиге Git добавить следующий параметр:
C:\Git\bin\git config --global url."https://".insteadOf git://
Компиляция OpenSSL Toolkit v1.x.x
Важно! Данный алгоритм справедлив для версий OpenSSL выше v1.x.x.
- Создаём рабочую папку C:\build\openssl
- Распаковываем архив с исходниками OpenSSL v1.x.x (из Пункта №5 необходимого инструментария) в папку C:\build\openssl
- Запускаем от имени Администратора Git Bash (идёт в комплекте с Git) в папке C:\build\openssl и последовательно выполняем следующие команды. Сначала конфигурируем проект:
MAKE=mingw32-make PERL=perl.exe ./config --prefix=/c/OpenSSL shared
По завершении конфигурации выполняем команду:
mingw32-make mingw32-make install
В результате компиляции и инсталляции пакета OpenSSL Toolkit v1.x.x получаем скомпилированные библиотеки libeay32.dll и ssleay32.dll в папке C:\OpenSSL\bin, а также заголовочные файлы в папке C:\OpenSSL\include\openssl и служебные библиотеки для линковки в папке C:\OpenSSL\lib.
Теперь пакет OpenSSL Toolkit v1.x.x готов для линковки и сборки Psi+. Временную папку сборки C:\build\openssl можно удалить.
Компиляция Qt Cryptographic Architecture (QCA)
- Запускаем от имени Администратора CMD в рабочей папке C:\build
- Скачиваем исходный код QCA из официального git-репозитория:
C:\Git\bin\git clone git://anongit.kde.org/qca.git
- Переходим в папку C:\build\qca и конфигурируем проект перед сборкой:
cmake -G "MinGW Makefiles" -DCMAKE_INSTALL_PREFIX="C:/Qt/QCA" -DCMAKE_BUILD_TYPE=Release -DUSE_RELATIVE_PATHS=ON -DBUILD_PLUGINS=ossl;gnupg
Где «C:/Qt/QCA» - путь по которому будет установлена библиотека QCA (у вас может быть другой)
- После успешного конфигурирования проекта запускаем сборку командой:
mingw32-make
- Теперь запускаем установку компонентов QCA в заданную при конфигурировании папку:
mingw32-make install
- В каталоге C:\Qt\QCA появится полностью собранная библиотека QCA
Теперь комплект QCA готов для конфигурирования и сборки проекта Psi+.
Компиляция zlib
- Скачиваем исходный код zlib-1.2.8 отсюда
- Распаковываем содержимое архива zlib-1.2.8.tar.gz во временную рабочую папку C:\build\zlib
- Запускаем от имени Администратора Git Bash в папке C:\build\zlib
- Выполняем команду:
mingw32-make -f win32/Makefile.gcc
В результате компиляции наблюдаем в рабочей папке C:\build\zlib готовую к употреблению библиотеку zlib1.dll, а также служебные файлы zconf.h, zlib.h, libz.a и libz.dll.a
Копируем из папки C:\build\zlib следующие файлы:
- zlib1.dll в папку C:\Qt\zlib\bin
- zconf.h и zlib.h в папку C:\Qt\zlib\include
- libz.a и libz.dll.a в папку C:\Qt\zlib\lib
После этого временную рабочую папку C:\build\zlib можно удалить.
Теперь комплект zlib готов для конфигурирования и сборки проекта Psi+.
Компиляция библиотеки Hunspell
- Скачиваем при помощи Git исходники из github репозитория:
C:\Git\bin\git clone https://github.com/zdenop/hunspell-mingw.git
- Переходим в каталог исходников
cd hunspell-mingw
- Создаем каталог для теневой сборки и переходим в него:
mkdir build cd build
- Выполняем конфигурацию исходников:
cmake -G "MinGW Makefiles" -DCMAKE_INSTALL_PREFIX="C:/Hunspell" ..
Где C:/Hunspell - путь куда будет установлена библиотека libhunspell после сборки
- Если конфигурация прошла успешно, запускаем сборку библиотеки и установку:
mingw32-make mingw32-make install
Если сборка прошла успешно, то по адресу C:\Hunspell будет установлена библиотека libhunspell
<del>Компиляция утилиты ccache</del>
Подробную инструкцию по сборке утилиты ccache можно найти здесь.
Сборка Psi+ в автоматическом режиме (рекомендуется)
- Скачиваем скрипт auto-compiler-all-in-one.cmd в новую папку (например, C:\build)
- Включаем необходимый для сборки параметр MakeClassic в положение 1 (если он ещё не включен):
SET MakeClassic=1 SET UploadClassic=0 SET MakeClassicDebug=0 SET UploadClassicDebug=0 SET MakeWebkit=0 SET UploadWebkit=0 SET MakeWebkitDebug=0 SET UploadWebkitDebug=0 SET MakePlugins=0 SET UploadPlugins=0 SET MakePluginsDebug=0 SET UploadPluginsDebug=0
- Запускаем скрипт auto-compiler-all-in-one.cmd в папке C:\build и ждём окончания его выполнения
Если скрипт отработал успешно, то в рабочей папке C:\build появится архив, содержащий скомпилированный и готовый к работе бинарный файл psi-plus.exe.
Компиляция плагинов Psi+
- Скачиваем скрипт auto-compiler-all-in-one.cmd в новую папку (например, C:\build)
- Включаем необходимый для сборки параметр MakePlugins в положение 1:
SET MakeClassic=0 SET UploadClassic=0 SET MakeClassicDebug=0 SET UploadClassicDebug=0 SET MakeWebkit=0 SET UploadWebkit=0 SET MakeWebkitDebug=0 SET UploadWebkitDebug=0 SET MakePlugins=1 SET UploadPlugins=0 SET MakePluginsDebug=0 SET UploadPluginsDebug=0
- Запускаем скрипт auto-compiler-all-in-one.cmd в папке C:\build и ждём окончания его выполнения
Если скрипт отработал успешно, то в рабочей папке C:\build появится архив, содержащий скомпилированные и готовые к работе плагины Psi+.
Альтернативный способ сборки Psi+ под OS Windows (утилитой cmake)
Инструкция по установке Qt5
- Запускаем онлайн-инсталлер qt-unified-windows-x86-2.0.5-online.exe
- Нажимаем Next
- Нажимаем Skip (если у вас есть аккаунт Qt можете ввести данные)
- Если это первый запуск онлайн-инсталлера, то он попросит ввести путь установки, вводим и нажимаем Next
- Онлайн-инсталлер начнет скачивать информацию по доступным файлам, затем нажимаем Next
- В появившемся списке версий снимаем все галочки и ставим их таким образом:
- Нажимаем Next и ждем окончания установки
Настройка скрипта сборки Psi+ при помощи cmake и сборка
- Скачиваем архив make-psiplus-cmake и распаковываем файл make-psiplus-cmake.cmd.
- Ищем в скрипте и правим следующие переменные:
set CPUCOUNT=5 ←тут вместо 5 ваше количество ядер CPU + 1 (в примере 4+1)
set BUILDDIR=C:\build ←тут вместо C:\build путь к каталогу куда будут скачаны исходники и где будет производится сборка Psi+
set PSIDEPSPREFIX=C:\build\psibuild\psisdk ←тут вместо C:\build\psibuild\psisdk путь к каталогу в который был установлен Psi+ SDK
set GITBIN=C:\Git\bin\git.exe ←тут вместо C:\Git\bin\git.exe ваш путь к файлу git.exe
set CMAKEDIR=C:\cmake ←тут вместо C:\cmake ваш путь к каталогу в который был установлен Cmake
set ISWEBKIT=NO ←Если необходимо собрать Psi+ с поддержкой Webkit, заменяем NO на OK
set MINGW32=C:\MinGW ←тут вместо C:\MinGW ваш путь к каталогу в который был установлен MinGW (каталог в котором лежат каталоги bin и lib)
Если вы хотите собрать Psi+ при помощи Qt5, нужно изменить также следующие переменные:
set QT5DIR=C:\Qt\Qt5\5.5\mingw492_32 ←тут вместо C:\Qt\Qt5\5.5\mingw492_32 ваш путь к каталогу в который был установлен Qt-5.5 (каталог в котором лежат каталоги bin и lib)
set MINGW5DIR=C:\Qt\Qt5\Tools\mingw492_32 ←тут вместо C:\Qt\Qt5\Tools\mingw492_32 ваш путь к каталогу в который был установлен MinGW для Qt5 (каталог в котором лежат каталоги bin и lib)
- Выполнив все подготовительные действия и исправив скрипт, запускаем скрипт на выполнение кликнув по нему правой кнопкой мыши и в меню выбрав Запуск от имени администратора
- Скрипт сам скачает всё необходимое, подготовит исходники к сборке и запустит компиляцию. В процессе он несколько раз будет останавливаться для контроля за процессом сборки. Процесс сборки будет наглядно отображён процентом выполненной работы. Если скрипт отработал правильно, то у вас на диске C: появится каталог build, в котором появится каталог psibuild. В каталоге C:\build\psibuild будут лежать следующие каталоги: psi-plus-snapshots, psi-plus-l10n, это каталоги с исходными кодами, необходимыми для сборки Psi+. Также в каталоге C:\build\psibuild будет расположен каталог work, где и будет производится сборка Psi+
- После того как скрипт закончит работу, в каталоге C:\build\psibuild\psi_версия пси+ будут лежать следующие элементы:
- psi-plus.exe
- каталог plugins со всеми плагинами
- файл client_icons.txt
- каталог crets
- каталог iconsets
- каталог sound
- и каталог themes (если включен вебкит)
Файлы переводов (локализации) после сборки будут лежать в каталоге C:\build\psibuild\work\cmake_build\psi\translations