tizenbuildtools/README

Tizen Build Tools - README
--------------------------

Qt for Tizen is a purely community-driven port of Qt 5 to the Tizen mobile profile.
Tizen IVI profile as well as unofficial Netbook/Notebook profiles would benefit too.

Home page: http://qt-project.org/wiki/Tizen


===== Info ==== 
This repository helps to build Qt for Tizen for 3 targets:
* desktop
* device (Tizen developer device - arm architecture)
* emulator (Tizen SDK emulator - i386 architecture)

You need to have Tizen SDK (https://developer.tizen.org/downloads/tizen-sdk) 
installed if you want to build Qt for emulator or device. Desktop version
doesn't need that.


===== Building process =====
Each directory contains main donwloadAndBuildAll.sh script
created to conveniently build Qt fairly automatically.
All steps coded there can be also performed manually by advanced users.

In short downloadAndBuildAll.sh clones the qt5 repository from gitorious,
(assuming you did not set the QT5SRCDIR variable). Then it switches
qtbase, qtquickcontrols, qtsensors repositories to a wip/tizen branch,
clones qtquickcontrols-tizen repository in Qt sources directory (wip/tizen branch).

Warning 1!
After this step the mentioned wip/tizen branches are not updated (git pull).
To update just do it by hand or remove Qt sources directory and 
let the script to clone it once again.

By default Qt sources are cloned to qt5.gitorious directory under desktop,
device or emulator directories.

In case of device or emulator build, downloadAndBuildAll.sh also downloads
Tizen packages and prepares rootfs for cross compilation by unpacking them into
rootfs directory. Just run script without parameters to see some useful tips.

Warning 2!
If you for example built Qt Tizen for desktop and want to build it for emulator
export absolute path,
set QT5SRCDIR=/home/user/your/tizenbuildtools/directory/desktop/qt5.gitorious
before running emulator/downloadAndBuildAll.sh to avoid cloning Qt sources again
in the emulator directory.

Qt's default shadow build directory is buildQt5 in corresponding desktop, device or 
emulator directories.

In case of device or emulator Qt's default install dir is /opt/usr/apps/Qt5Install
 under the rootfs directory. So when you build Qt for emulator it will be installed in
tizenbuildtools/emulator/rootfs/opt/usr/apps/Qt5Install

In case of desktop Qt is installed by default in desktop/qt5hostInstall 
directory.

By default development tools such as qmake are installed in qt5hostInstall/bin
subdirectory of corresponding desktop, device or emulator directory.