Compiling-ICU-with-MSVC

From Qt Wiki
Revision as of 14:22, 6 June 2016 by Fatalist (talk | contribs) (Forget to --disable-release in debug build)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


Compiling ICU with MSVC (Microsoft Visual Studio)

Qt 5 / QtWebkit requires ICU.

Pre-built packages

The ICU Project site provides pre-built packages for MSVC 2010, which should work with compilers too. Anyhow, you have to compile your own version if you want to avoid the MSVC 2010 runtime dependency (because you're using another MSVC version), or want to tailor the ICU configuration.

download.qt.io also hosts packages for MSVC 2010, 2012 and 2013.

Compiling on your own

Requirements

Note: When installing Cygwin and selecting packages, make sure you search for and select 'make', 'dos2unix' and 'binutils'.

How to build

C:> set PATH=%PATH%;C:\Cygwin\bin
C:> dos2unix *
C:> dos2unix -f configure

Check whether you have e.g. the MSVC compiler (cl.exe) in PATH. If not, set it up by calling e.g.

C:> "C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\vcvarsall.bat" x86

Run configure && build:

C:> bash runConfigureICU Cygwin/MSVC -prefix=/cygdrive/c/icu/dist

This will generate a release shared build that you can use in both a debug and release build of Qt.

To link ICU statically (e.g. for a static release build of Qt), you have to append '—enable-static —disable-shared' :

C:> bash runConfigureICU Cygwin/MSVC -prefix=/cygdrive/c/icu/dist -enable-static -disable-shared

To link ICU statically and build it in debug mode (e.g. for a static debug build of Qt), you have to prepend '—enable-debug —disable-release' to the arguments:

C:> bash runConfigureICU --enable-debug --disable-release Cygwin/MSVC -prefix=/cygdrive/c/icu/dist -enable-static -disable-shared

Finally, run make && make install

C:> make && make install

Usage

Add the include, lib folders to your compilation environment, e.g. for cmd.exe :

C:> set PATH=%PATH%;C:\icu\dist\bin; set INCLUDE=%INCLUDE%;C:\icu\dist\include; set LIB=%LIB%;C:\icu\dist\bin

When you now run Qt’s configure.exe ICU should be detected, and Qt links against the libraries.