Как собрать CppCMS 1.x.x
Требования
Для сборки CppCMS Вам потребуется:
Обязательные требования
- Современный C++ компилятор -- GCC, MSVC 9, Intel. См. поддерживаемые компиляторы и платформы
- CMake 2.6 и выше, рекомендуется 2.8.x.
- Библиотека Zlib.
- Библиотека PCRE.
- Python >=2.4 (но не 3)
Windows 2000 и XP: библиотека pthread-win32:
- pthreadGC2.dll для MinGW
- pthreadVC2.dll для MSVC
Windows Vista и выше не требуют библиотеку pthreads, т.к. у них лучше API, изначально отображающее в требуемые функции. Для использования Windows Vista/7 API необходимо включить опцию CMake
USE_WINDOWS6_API
Рекомендуемые зависимости
- Библиотека ICU 3.6 и выше -- поддержка расширенных возможностей локализации.
Библиотека gcrypt или OpenSSL -- поддержка зашифрованных cookies сессий.
Если доступны обе библиотеки - будет использоваться gcrypt.
Предлагаемые
- библиотека iconv (если libc не предусматривает интерфейс iconv)
Получение библиотеки
Скачайте новейший cppcms-1.x.x.tar.bz2 из sourceforge и распакуйте его:
tar -xjf cppcms-1.0.4.tar.bz2
Если хотите получить самую свежую версию, вам потребуется Subversion для получения исходников:
svn co https://cppcms.svn.sourceforge.net/svnroot/cppcms/framework/trunk cppcms
И затем распакуйте cppcms_boost.tar.bz (этот шаг не требуется для файлов релиза с Sourceforge)
cd cppcms tar -xjf cppcms_boost.tar.bz
Примечание: Под Windows для распаковки этого файла Вы можете использовать 7zip.
Процесс сборки
Перейдите в созданную директорию cppcms, создайте директорию build и перейдите в нее:
mkdir build cd build
Теперь сконфигурируйте библиотеку с CMake
cmake ..
или
cmake various_build_options ..
Затем выполните
make make test make install
Опции сборки
-DDISABLE_STATIC=ON-- отключить сборку статической версии библиотеки cppcms-DDISABLE_SHARED=ON-- отключить сборку совместно используемой версии библиотеки cppcms-DDISABLE_ICONV=ON-- отключить использование iconv (вместо него будет использоваться ICU)-DDISABLE_GCRYPT=ON-- отключить использование библиотеки gcrypt (будут использоваться только подписанные cookies)-DDISABLE_OPENSSL=ON-- отключить использование OpenSSL.-DUSE_WINDOWS6_API=ON-- по возможности использовать API Windows Vista, Windows 7, позволяющее собрать CppCMS на Windows без библиотеки pthreads. По-умолчанию отключено.
Общие опции оптимизации размера для встраиваемых сборок:
-DDISABLE_FCGI=ON-- сборка без FastCGI API сервера.-DDISABLE_SCGI=ON-- сборка без SCGI API сервера.-DDISABLE_HTTP=ON-- сборка без внутреннего HTTP сервера.-DDISABLE_ICU_LOCALE=ON-- не использовать ICU для локализации, а базирующуюся на локализации C++std::localeв Windows API или POSIX API -- множество возможностей локализации будут недоступны, но это может быть полезным для встраиваемых сборок.-DDISABLE_PREFORK_CACHE=ON- отключение поддержки кеша в режимах prefork (разделяемый кеш процесса)-DDISABLE_TCPCACHE=ON- отключение поддержки распределенного кеша (поддержка решений типа memcache)-DDISABLE_CACHE=ON- отключение системы кеширования полностью.-DDISABLE_GZIP=ON- отключение поддержки сжатия вывода gzip (устраняет зависимость от zlib)
Общие полезные опции CMake:
-DCMAKE_BUILD_TYPE=(Debug|Release|RelWithDebInfo|MinSizeRel)-- тип релиза. По-умолчанию - RelWithDebInfo, в отличие от использования MSVC, где по-умолчанию - Debug.-DCMAKE_INCLUDE_PATH=/path/to/include-- путь к расположению заголовочных файлов библиотек, определите его для нахождения заголовочных файлов библиотек, установленных в нестандартном расположении. Вы почти всегда должны определять его под Windows.-DCMAKE_LIBRARY_PATH=/path/to/lib-- путь к расположению библиотек, определите его для нахождения библиотек, установленных в нестандартном расположении. Вы почти всегда должны определять его под Windows.-DCMAKE_INSTALL_PREFIX=/usr/local-- Префикс (путь) установки (аналогично autoconf --prefix). По-умолчанию - /usr/local
Примеры
Операционные системы POSIX
Предполагается, что вы в терминале и директории сборки, расположенной внутри исходников CppCMS.
Сборка в Linux, FreeBSD и Cygwin:
cmake .. make make test make install
Сборка в OpenSolaris с SunStudio
cmake -DCMAKE_C_COMPILER=/usr/bin/suncc -DCMAKE_CXX_COMPILER=/usr/bin/sunCC .. make make test make install
Сборка в OpenSolaris с GCC, где ICU установлен в /opt/icu
cmake -DCMAKE_INCLUDE_PATH=/opt/icu/include -DCMAKE_LIBRARY_PATH=/opt/icu/lib .. make make test make install
Mircosoft Windows
Предполагается, что сторонние библиотеки установлены в c:\3rd_part и исходники расположены в d:\projects\cppcms
Примечание: Требуется установка корректных значений переменной окружения PATH, чтобы система нашла все нужные ей DLL.
В cmd.exe:
set PATH=c:\3rd_part\lib;%PATH% set PATH=d:\projects\cppcms\build\booster;%PATH%
В bash:
export PATH=/c/3rd_part/lib:"$PATH" export PATH=/d/projects/cppcms/build/booster:"$PATH"
Сборки MinGW:
Для сборок mingw также требуется передать путь к директории библиотек mingw, иначе может не найтись корректно библиотека winsock. Предположим, есть mingw, установленный в c:\mingw
Откройте Shell-терминал MinGW
cmake -G "MSYS Makefiles" -DCMAKE_INCLUDE_PATH=c:/3rd_part/include -DCMAKE_LIBRARY_PATH="c:/3rd_part/lib;c:/mingw/lib" -DCMAKE_INSTALL_PREFIX=c:/mingw .. make make test make install
Сборки MSVC:
Откройте Shell-терминал MSVC (All Programs > Microsoft Visual Studio 2008 > Visual Studio Tools > Visual Studio 2008 Command Prompt)
cmake -G "NMake Makefiles" -DCMAKE_INCLUDE_PATH=c:/3rd_part/include -DCMAKE_LIBRARY_PATH=c:/3rd_part/lib -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=c:/cppcms .. nmake nmake test nmake install
Кросс-компиляция
Сборка - это обычная процедура кросс-компиляции CMake. Для дополнительной информации прочтите http://www.cmake.org/Wiki/CMake_Cross_Compiling
Предоставим пример для ARM под Linux, без ICU.
Создайте ToolChain.cmake
SET(CMAKE_SYSTEM_NAME Linux) SET(CMAKE_C_COMPILER /usr/bin/arm-linux-gnueabi-gcc) SET(CMAKE_CXX_COMPILER /usr/bin/arm-linux-gnueabi-g++) SET(CMAKE_FIND_ROOT_PATH /usr/arm-linux-gnueabi) SET(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) SET(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) SET(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY)
Сконфигурируйте
cmake -DCMAKE_TOOLCHAIN_FILE=ToolChain.cmake -DDISABLE_ICU_LOCALIZATION=ON -DCMAKE_ISTALL_PREFIX=/usr/arm-linux-eabi .. make make install
