INSTALL
author hgs
Mon, 18 Oct 2010 18:23:13 +0300
changeset 34 ed14f46c0e55
permissions -rw-r--r--
201041
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
34
hgs
parents:
diff changeset
     1
===========================================================================
hgs
parents:
diff changeset
     2
Dependencies
hgs
parents:
diff changeset
     3
===========================================================================
hgs
parents:
diff changeset
     4
 
hgs
parents:
diff changeset
     5
To build the UI Extensions for Mobile package, you need:
hgs
parents:
diff changeset
     6
 - Qt 4.6 or newer.
hgs
parents:
diff changeset
     7
 - Python 2.3 or newer. We recommend 2.6.
hgs
parents:
diff changeset
     8
 
hgs
parents:
diff changeset
     9
===========================================================================
hgs
parents:
diff changeset
    10
How to Build
hgs
parents:
diff changeset
    11
===========================================================================
hgs
parents:
diff changeset
    12
 
hgs
parents:
diff changeset
    13
---------------------------------------------------------------------------
hgs
parents:
diff changeset
    14
Linux
hgs
parents:
diff changeset
    15
---------------------------------------------------------------------------
hgs
parents:
diff changeset
    16
 
hgs
parents:
diff changeset
    17
Run "python configure.py" on the main level of the UI Extensions for Mobile
hgs
parents:
diff changeset
    18
directory. Optional parameters include: 
hgs
parents:
diff changeset
    19
  "--prefix <path>" specifies the installation path. If omitted, defaults 
hgs
parents:
diff changeset
    20
    to "/usr/local/hb".
hgs
parents:
diff changeset
    21
  "--qmake-bin <path>" can be used to specify which QMake should be used.
hgs
parents:
diff changeset
    22
 
hgs
parents:
diff changeset
    23
Run "make" to compile the libraries.
hgs
parents:
diff changeset
    24
 
hgs
parents:
diff changeset
    25
Run "make install" to install the resulting binaries and the .prf file.
hgs
parents:
diff changeset
    26
 
hgs
parents:
diff changeset
    27
---------------------------------------------------------------------------
hgs
parents:
diff changeset
    28
Maemo
hgs
parents:
diff changeset
    29
---------------------------------------------------------------------------
hgs
parents:
diff changeset
    30
 
hgs
parents:
diff changeset
    31
We assume that you have a working Maemo 5 SDK with Qt 4.6 installed.
hgs
parents:
diff changeset
    32
 
hgs
parents:
diff changeset
    33
Make sure following UI Extensions for Mobile dependencies are installed:
hgs
parents:
diff changeset
    34
    libqt4-maemo5-core libqt4-maemo5-dbus libqt4-maemo5-dev
hgs
parents:
diff changeset
    35
    libqt4-maemo5-maemo5 libqt4-maemo5-multimedia libqt4-maemo5-opengl
hgs
parents:
diff changeset
    36
    libqt4-maemo5-phonon libqt4-maemo5-script libqt4-maemo5-svg
hgs
parents:
diff changeset
    37
    libqt4-maemo5-test libqt4-maemo5-xml
hgs
parents:
diff changeset
    38
 
hgs
parents:
diff changeset
    39
Run "python configure.py" on the main level of the UI Extensions for Mobile
hgs
parents:
diff changeset
    40
directory. Optional parameters include: 
hgs
parents:
diff changeset
    41
  "--prefix <path>" specifies the installation path. If omitted, defaults 
hgs
parents:
diff changeset
    42
    to "/usr/local/hb".
hgs
parents:
diff changeset
    43
  "--qmake-bin <path>" can be used to specify which QMake should be used.
hgs
parents:
diff changeset
    44
 
hgs
parents:
diff changeset
    45
Run "make" to compile the libraries.
hgs
parents:
diff changeset
    46
 
hgs
parents:
diff changeset
    47
Copy the binaries (libraries, your apps and the plugins) to your device.
hgs
parents:
diff changeset
    48
You can check ".qmake.cache" to see where UI Extensions for Mobile 
hgs
parents:
diff changeset
    49
expects to find these binaries - the typical locations are:
hgs
parents:
diff changeset
    50
    Libraries: /home/maemo/MyDocs/<hb-src-dir>/lib
hgs
parents:
diff changeset
    51
    Plugins: /home/maemo/MyDocs/<hb-src-dir>/plugins
hgs
parents:
diff changeset
    52
    Apps: /home/maemo/MyDocs/<hb-src-dir>/bin
hgs
parents:
diff changeset
    53
 
hgs
parents:
diff changeset
    54
---------------------------------------------------------------------------
hgs
parents:
diff changeset
    55
Symbian
hgs
parents:
diff changeset
    56
---------------------------------------------------------------------------
hgs
parents:
diff changeset
    57
 
hgs
parents:
diff changeset
    58
In the main directory of UI Extensions for Mobile, run the configuration
hgs
parents:
diff changeset
    59
script with the desired options. For example:
hgs
parents:
diff changeset
    60
  "python configure.py --qmake-bin=\epoc32\tools\qmake \
hgs
parents:
diff changeset
    61
    --qmake-spec=\epoc32\tools\qt\mkspecs\symbian-sbsv2
hgs
parents:
diff changeset
    62
 
hgs
parents:
diff changeset
    63
Hint: the configuration options used for platform builds are available
hgs
parents:
diff changeset
    64
in src\platforms\symbian\configurations\bld.inf.
hgs
parents:
diff changeset
    65
 
hgs
parents:
diff changeset
    66
To compile the libraries, either use the makefile:
hgs
parents:
diff changeset
    67
  "make release-armv5"
hgs
parents:
diff changeset
    68
or run SBS (or ABLD) directly:
hgs
parents:
diff changeset
    69
  "sbs -c armv5_urel"
hgs
parents:
diff changeset
    70
 
hgs
parents:
diff changeset
    71
Finally, copy hb_install.prf to the right location:
hgs
parents:
diff changeset
    72
  "make install"
hgs
parents:
diff changeset
    73
 
hgs
parents:
diff changeset
    74
---------------------------------------------------------------------------
hgs
parents:
diff changeset
    75
Windows
hgs
parents:
diff changeset
    76
---------------------------------------------------------------------------
hgs
parents:
diff changeset
    77
 
hgs
parents:
diff changeset
    78
You need to have either MinGW or MSVC++ installed properly. Some Qt
hgs
parents:
diff changeset
    79
distributions might even install MinGW for you.
hgs
parents:
diff changeset
    80
 
hgs
parents:
diff changeset
    81
Run "python configure.py" on the main level of the UI Extensions for Mobile
hgs
parents:
diff changeset
    82
directory. Optional parameters include: 
hgs
parents:
diff changeset
    83
  "--prefix <path>" specifies the installation path. If omitted, defaults
hgs
parents:
diff changeset
    84
    to "C:\hb".
hgs
parents:
diff changeset
    85
  "--qmake-bin <path>" can be used to specify which QMake should be used.
hgs
parents:
diff changeset
    86
 
hgs
parents:
diff changeset
    87
If you are using MinGW, run "mingw32-make" to compile the libraries and
hgs
parents:
diff changeset
    88
"mingw32-make install" to install the resulting binaries.
hgs
parents:
diff changeset
    89
 
hgs
parents:
diff changeset
    90
If you are using MSVC++, run "nmake" to compile the libraries and
hgs
parents:
diff changeset
    91
"nmake install" to install the resulting binaries.
hgs
parents:
diff changeset
    92
 
hgs
parents:
diff changeset
    93
Add "C:\hb\bin" to your path with "SET PATH=%PATH%;C:\hb\bin".
hgs
parents:
diff changeset
    94
 
hgs
parents:
diff changeset
    95
===========================================================================