Compiling-ICU-with-MinGW: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
Line 55: Line 55:
<code>
<code>
$ export PATH="$PATH:/c/icu/dist/lib"
$ export PATH="$PATH:/c/icu/dist/lib"
$ export INCLUDE="$INCLUDE:/c/icu/dist/include"
$ export INCLUDE="$INCLUDE:/c/icu/dist/include"
$ export LIB="$LIB:/c/icu/dist/lib&amp"
$ export LIB="$LIB:/c/icu/dist/lib&amp"
</code>
</code>


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

Revision as of 12:37, 23 February 2015



Compiling ICU with MinGW (for adding Unicode support)

Qt 5 / QtWebkit requires ICU, which MinGW distributions do not ship.

Pre-built packages

The "ICU Project site&quot;:http://site.icu-project.org/download provides pre-compiled libraries for both 32 and 64 bit. However, these depend on the Microsoft Visual C++ 2010 runtime being installed.

"download.qt.io&quot;:http://download.qt.io/development_releases/prebuilt/icu/prebuilt/mingw/ also hosts packages for the MinGW toolchains Qt ships.

Inside MSYS2 shell, a pre-built ICU can be obtained. MSYS2 also contains pre-built dynamic Qt & QtCreator (and static Qt) with ICU & OpenSSL support.

Compiling on your own

Requirements

  • Either use MSYS or use MSYS2.
  • Working MinGW, or MinGW-w64 toolchain.
    • Load MinGW or MinGW-w64 toolchains.
    • NOTE: Do not use (or try to avoid using) different type of toolchains for building different sub-components for the same/main project, targeted for same platform/OS. If you are using MinGW-w64 toolchains from MSYS2\mingw32 or MSYS2\mingw64, then for building main project & all of its sub-components, use same MSYS2 toolchains. If you are using MinGW toolchain, then for building all of your sub-components & main project, use same MinGW toolchain. If you are using MinGW-w64 toolchains from "MinGW-builds&quot;, then for building all sub-components & main project, use same MinGW-builds toolchains.

How to build

  • Download latest ICU4C source code from http://site.icu-project.org/download (e.g. icu4c-52_1-src.zip), unzip
  • Either start MSYS-shell, or start MSYS2-shell:
    • Start a MSYS shell command prompt (C:.0\msys.bat)
    • Or, start MSYS2 shell command prompt (C:2\msys2_shell.bat)
      • See in MSYS2 page, how to prepare MSYS2-shell with build/compile related tools & dependencies & toolchains
  • Inside MSYS or MSYS2 shell, run/execute below command:
    <br />&amp;#36; cd icu/source<br />
    
  • Check that gcc is in PATH, otherwise add it:
    • If using MSYS shell, and if MinGW (32bit) is installed inside /c/mingw32 (C:32 directory, then execute this:
      <br />&amp;#36; export PATH=&quot;/c/mingw32/bin:&amp;#36;PATH&amp;quot;<br />
      
    • If using MSYS2 shell, execute this, if you are building for 32bit:
      <br />&amp;#36; export PATH=&quot;/c/msys2/mingw32/bin:&amp;#36;PATH&amp;quot;<br />
      
    • If using MSYS2 shell, execute this, if you are building for 64bit:
      <br />$ export PATH=&quot;/c/msys2/mingw64/bin:&amp;#36;PATH&amp;quot;<br />
      
  • Run configure && build:
    <br />&amp;#36; ./runConfigureICU MinGW prefix=&amp;#36;PWD/../dist<br />
    

    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’ :
    <br />&amp;#36; ./runConfigureICU MinGW prefix=&amp;#36;PWD/../dist enable-static disable-shared<br />
    
  • 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:
    <br />&amp;#36; ./runConfigureICU enable-debug disable-release MinGW prefix=&amp;#36;PWD/../dist enable-static disable-shared<br />
    
  • Finally, run make && make install
    <br />&amp;#36; make &amp;&amp; make install<br />
    

Using it

  • Add the include, lib folders to your compilation environment, e.g. for cmd.exe (Cmd-shell) :
    <br />C:gt; set PATH=&amp;#37;PATH&amp;amp;#37;;C:C:gt; set INCLUDE=&amp;#37;INCLUDE&amp;amp;#37;;C:C:gt; set LIB=&amp;#37;LIB&amp;amp;#37;;C:
    
  • Add the include, lib folders to your compilation environment, e.g. for MSYS2-shell (or for MSYS-shell) :
$ export PATH="$PATH:/c/icu/dist/lib"

$ export INCLUDE="$INCLUDE:/c/icu/dist/include"

$ export LIB="$LIB:/c/icu/dist/lib&amp"

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