1 ===========================================================================

     2 Dependencies

     3 ===========================================================================

     4  

     5 To build the UI Extensions for Mobile package, you need:

     6  - Qt 4.6 or newer.

     7  - Python 2.3 or newer. We recommend 2.6.

     8  

     9 ===========================================================================

    10 How to Build

    11 ===========================================================================

    12  

    13 ---------------------------------------------------------------------------

    14 Linux

    15 ---------------------------------------------------------------------------

    16  

    17 Run "python configure.py" on the main level of the UI Extensions for Mobile

    18 directory. Optional parameters include: 

    19   "--prefix <path>" specifies the installation path. If omitted, defaults 

    20     to "/usr/local/hb".

    21   "--qmake-bin <path>" can be used to specify which QMake should be used.

    22  

    23 Run "make" to compile the libraries.

    24  

    25 Run "make install" to install the resulting binaries and the .prf file.

    26  

    27 ---------------------------------------------------------------------------

    28 Maemo

    29 ---------------------------------------------------------------------------

    30  

    31 We assume that you have a working Maemo 5 SDK with Qt 4.6 installed.

    32  

    33 Make sure following UI Extensions for Mobile dependencies are installed:

    34     libqt4-maemo5-core libqt4-maemo5-dbus libqt4-maemo5-dev

    35     libqt4-maemo5-maemo5 libqt4-maemo5-multimedia libqt4-maemo5-opengl

    36     libqt4-maemo5-phonon libqt4-maemo5-script libqt4-maemo5-svg

    37     libqt4-maemo5-test libqt4-maemo5-xml

    38  

    39 Run "python configure.py" on the main level of the UI Extensions for Mobile

    40 directory. Optional parameters include: 

    41   "--prefix <path>" specifies the installation path. If omitted, defaults 

    42     to "/usr/local/hb".

    43   "--qmake-bin <path>" can be used to specify which QMake should be used.

    44  

    45 Run "make" to compile the libraries.

    46  

    47 Copy the binaries (libraries, your apps and the plugins) to your device.

    48 You can check ".qmake.cache" to see where UI Extensions for Mobile 

    49 expects to find these binaries - the typical locations are:

    50     Libraries: /home/maemo/MyDocs/<hb-src-dir>/lib

    51     Plugins: /home/maemo/MyDocs/<hb-src-dir>/plugins

    52     Apps: /home/maemo/MyDocs/<hb-src-dir>/bin

    53  

    54 ---------------------------------------------------------------------------

    55 Symbian

    56 ---------------------------------------------------------------------------

    57  

    58 In the main directory of UI Extensions for Mobile, run the configuration

    59 script with the desired options. For example:

    60   "python configure.py --qmake-bin=\epoc32\tools\qmake \

    61     --qmake-spec=\epoc32\tools\qt\mkspecs\symbian-sbsv2

    62  

    63 Hint: the configuration options used for platform builds are available

    64 in src\platforms\symbian\configurations\bld.inf.

    65  

    66 To compile the libraries, either use the makefile:

    67   "make release-armv5"

    68 or run SBS (or ABLD) directly:

    69   "sbs -c armv5_urel"

    70  

    71 Finally, copy hb_install.prf to the right location:

    72   "make install"

    73  

    74 ---------------------------------------------------------------------------

    75 Windows

    76 ---------------------------------------------------------------------------

    77  

    78 You need to have either MinGW or MSVC++ installed properly. Some Qt

    79 distributions might even install MinGW for you.

    80  

    81 Run "python configure.py" on the main level of the UI Extensions for Mobile

    82 directory. Optional parameters include: 

    83   "--prefix <path>" specifies the installation path. If omitted, defaults

    84     to "C:\hb".

    85   "--qmake-bin <path>" can be used to specify which QMake should be used.

    86  

    87 If you are using MinGW, run "mingw32-make" to compile the libraries and

    88 "mingw32-make install" to install the resulting binaries.

    89  

    90 If you are using MSVC++, run "nmake" to compile the libraries and

    91 "nmake install" to install the resulting binaries.

    92  

    93 Add "C:\hb\bin" to your path with "SET PATH=%PATH%;C:\hb\bin".

    94  

    95 ===========================================================================