Qt Simulator: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
 
No edit summary
Line 1: Line 1:
'''English''' [[Qt Simulator Italian|Italian]]
'''English''' [[Qt_Simulator_Italian|Italian]]


=Qt Simulator=
[toc align_right="yes" depth="3"]
 
= Qt Simulator =


A fast and lightweight simulator for Qt applications running on Nokia devices.
A fast and lightweight simulator for Qt applications running on Nokia devices.


Project Name: Qt Simulator <br /> Platforms: Windows, Linux, Mac <br /> Qt Version: Qt 4.7 <br /> License: [http://www.gnu.org/licenses/lgpl.html <span class="caps">LGPL</span>] ''[gnu.org]''<br /> Blog entries: http://labs.qt.nokia.com/category/qt-simulator/ ''[labs.qt.nokia.com]''<br /> Git repo: http://qt.gitorious.org/qt-labs/simulator ''[qt.gitorious.org]''
p=. Project Name: Qt Simulator<br />Platforms: Windows, Linux, Mac<br />Qt Version: Qt 4.7<br />License: &quot;LGPL&amp;quot;:http://www.gnu.org/licenses/lgpl.html<br />Blog entries: &quot;http://labs.qt.nokia.com/category/qt-simulator/&amp;quot;:http://labs.qt.nokia.com/category/qt-simulator/<br />Git repo: &quot;http://qt.gitorious.org/qt-labs/simulator&amp;quot;:http://qt.gitorious.org/qt-labs/simulator


==Compiling==
== Compiling ==


Building Qt Simulator and its dependencies is a little tedious at the moment. If you just want to use it, we recommend you install the Nokia Qt <span class="caps">SDK</span> instead. If you want to build from source, follow this step-by-step instruction. Note that the order of the steps is important.
Building Qt Simulator and its dependencies is a little tedious at the moment. If you just want to use it, we recommend you install the Nokia Qt SDK instead. If you want to build from source, follow this step-by-step instruction. Note that the order of the steps is important.


===Repositories===
=== Repositories ===


The simulator application itself requires Qt as well as code contained in these repositories:
The simulator application itself requires Qt as well as code contained in these repositories:<br />* &quot;Qt Simulator&amp;quot;:http://qt.gitorious.org/qt-labs/simulator, the master branch<br />* &quot;Remote Control Widget&amp;quot;:http://qt.gitorious.org/qt-labs/remotecontrolwidget, the simulator-master branch<br />* &quot;Qt Messaging Framework (QMF)&quot;:http://qt.gitorious.org/qt-labs/messagingframework, commit a4adb57b076e


* [http://qt.gitorious.org/qt-labs/simulator Qt Simulator] ''[qt.gitorious.org]'', the master branch
For building applications destined to run inside Qt Simulator, you need:<br />* &quot;Simulator Qt&amp;quot;:http://qt.gitorious.org/~qtbynokia/qt/simulator-qt, the 4.7 branch<br />* &quot;Simulator Qt Mobility&amp;quot;:http://qt.gitorious.org/~qtbynokia/qt-mobility/simulator-mobility, the 1.2.0 branch
* [http://qt.gitorious.org/qt-labs/remotecontrolwidget Remote Control Widget] ''[qt.gitorious.org]'', the simulator-master branch
* [http://qt.gitorious.org/qt-labs/messagingframework Qt Messaging Framework] ''[qt.gitorious.org]'', commit a4adb57b076e


For building applications destined to run inside Qt Simulator, you need:
=== Preparation ===


* [http://qt.gitorious.org/~qtbynokia/qt/simulator-qt Simulator Qt] ''[qt.gitorious.org]'', the 4.7 branch
Create two directories:<br />* (simulator-qt-mobility-prefix)<br />* (simulator-depends)
* [http://qt.gitorious.org/~qtbynokia/qt-mobility/simulator-mobility Simulator Qt Mobility] ''[qt.gitorious.org]'', the 1.2.0 branch


===Preparation===
Set the environment variables to the matching paths:<br />* QT_NOKIA_SDK_PATH=(Simulator Qt source directory)<br />* QT_MOBILITY_SOURCE_PATH=(Simulator Qt Mobility source directory)<br />* QMF_INCLUDEDIR=(QMF source directory)/src/libraries/qmfclient<br />* QMF_LIBDIR=(simulator-qt-mobility-prefix)/lib<br />* SIMULATOR_DEPENDENCY_PATH=(simulator-depends)


Create two directories:
=== Simulator application ===


* (simulator-qt-mobility-prefix)
* Get a Qt 4.7. We call this the Desktop Qt. Use only this Qt here.  
* (simulator-depends)
* Run qmake -r QMF_INSTALL_ROOT=(simulator-depends) on QMF in a build directory of your choice.  
 
* Build and install (QMF)/src/libraries/qmfclient.  
Set the environment variables to the matching paths:
* Build and install (QMF)/src/plugins/contentmanagers/qmfstoragemanager
 
* Build and install Qt Mobility. Pass -modules &quot;connectivity location contacts versit organizer&amp;quot; -prefix (simulator-depends) to configure.  
* QT_NOKIA_SDK_PATH=(Simulator Qt source directory)
* Build and install (Remote Control Widget)/library. Pass PREFIX=(simulator-depends) to qmake.  
* QT_MOBILITY_SOURCE_PATH=(Simulator Qt Mobility source directory)
* <span class="caps">QMF</span>_INCLUDEDIR=(<span class="caps">QMF</span> source directory)/src/libraries/qmfclient
* <span class="caps">QMF</span>_LIBDIR=(simulator-qt-mobility-prefix)/lib
* <span class="caps">SIMULATOR</span>_DEPENDENCY_PATH=(simulator-depends)
 
===Simulator application===
 
* Get a Qt 4.7. We call this the Desktop Qt. Use only this Qt here.
* Run qmake -r <span class="caps">QMF</span>_INSTALL_ROOT=(simulator-depends) on <span class="caps">QMF</span> in a build directory of your choice.
* Build and install (<span class="caps">QMF</span>)/src/libraries/qmfclient.
* Build and install (<span class="caps">QMF</span>)/src/plugins/contentmanagers/qmfstoragemanager
* Build and install Qt Mobility. Pass -modules “connectivity location contacts versit organizer” -prefix (simulator-depends) to configure.
* Build and install (Remote Control Widget)/library. Pass <span class="caps">PREFIX</span>=(simulator-depends) to qmake.
* Build the simulator itself.
* Build the simulator itself.


===Dependencies for client applications===
=== Dependencies for client applications ===
 
* Build the Simulator Qt, passing -simulator and -developer-build to configure. On linux, pass -opengl if you want to. Use only this Qt here. That means all further steps in this section should use the Simulator Qt’s qmake.
* Run qmake -r <span class="caps">QMF</span>_INSTALL_ROOT=(simulator-qt-mobility-prefix) on <span class="caps">QMF</span> in a build directory of your choice that’s different from the one above.
* Build and install (<span class="caps">QMF</span>)/src/libraries/qmfclient.
* Build and install (<span class="caps">QMF</span>)/src/plugins/contentmanagers/qmfstoragemanager.
* Build and install Simulator Qt Mobility. Pass -prefix (simulator-qt-mobility-prefix) to configure. (set <span class="caps">PATH</span> to make sure the Simulator Qt’s qmake is used)
 
===Client applications===
 
Register the Simulator Qt you built in Qt Creator and select the Qt Simulator target to build client applications. Alternatively, use the Simulator Qt’s qmake directly.
 
==Development==


===Branches===
* Build the Simulator Qt, passing -simulator and -developer-build to configure. On linux, pass -opengl if you want to. Use only this Qt here. That means all further steps in this section should use the Simulator Qt's qmake.
* Run qmake -r QMF_INSTALL_ROOT=(simulator-qt-mobility-prefix) on QMF in a build directory of your choice that's different from the one above.
* Build and install (QMF)/src/libraries/qmfclient.
* Build and install (QMF)/src/plugins/contentmanagers/qmfstoragemanager.
* Build and install Simulator Qt Mobility. Pass -prefix (simulator-qt-mobility-prefix) to configure. (set PATH to make sure the Simulator Qt's qmake is used)


We categorize branches into:
=== Client applications ===


* maintenance branch: Maintenance for a released version. Can be merged into the development branch.
Register the Simulator Qt you built in Qt Creator and select the Qt Simulator target to build client applications. Alternatively, use the Simulator Qt's qmake directly.
* development branches: This is where new features go.
* staging branch for X: Will automatically be merged back and forth to and from X.
* active release branches: More stable branches used for future releases. No changes should be pushed to them. The release manager will cherry-pick fixes.
* inactive release branches: Previously active release branches that are kept for reference. Will not change.


These are the current branches:
== Development ==


* simulator/1.1: maintenance branch
=== Branches ===
* simulator/master: development branch
* simulator-qt/4.7: development branch, qt/4.7 is merged regularly
* simulator-qt/4.7.4: active release branch, qt-releases/4.7.4 is merged regularly
* simulator-mobility/1.1: maintenance and staging branch for qt-mobility/1.1
* simulator-mobility/1.2.0: active release branch, qtmobility-releases/1.2.0 is merged regularly
* simulator-mobility/master: development branch and staging branch for qt-mobility/master
* remotecontrolwidget/simulator: maintenance branch (use with simulator/1.1)
* remotecontrolwidget/simulator-master: development branch (use with simulator/master), remotecontrolwidget/simulator is merged regularly


Inactive branches:
We categorize branches into:<br />* maintenance branch: Maintenance for a released version. Can be merged into the development branch.<br />* development branches: This is where new features go.<br />* staging branch for X: Will automatically be merged back and forth to and from X.<br />* active release branches: More stable branches used for future releases. No changes should be pushed to them. The release manager will cherry-pick fixes.<br />* inactive release branches: Previously active release branches that are kept for reference. Will not change.


* simulator/1.0.1: inactive branch
These are the current branches:<br />* simulator/1.1: maintenance branch<br />* simulator/master: development branch<br />* simulator-qt/4.7: development branch, qt/4.7 is merged regularly<br />* simulator-qt/4.7.4: active release branch, qt-releases/4.7.4 is merged regularly<br />* simulator-mobility/1.1: maintenance and staging branch for qt-mobility/1.1<br />* simulator-mobility/1.2.0: active release branch, qtmobility-releases/1.2.0 is merged regularly<br />* simulator-mobility/master: development branch and staging branch for qt-mobility/master<br />* remotecontrolwidget/simulator: maintenance branch (use with simulator/1.1)<br />* remotecontrolwidget/simulator-master: development branch (use with simulator/master), remotecontrolwidget/simulator is merged regularly
* simulator-qt/4.7.0: inactive release branch
* simulator-qt/4.7.0-beta2: inactive release branch
* simulator-qt/4.7.0-beta1: inactive release branch
* simulator-qt/4.7.1: inactive release branch
* simulator-qt/4.7.2: inactive release branch
* simulator-mobility/1.0: maintenance and staging branch for qt-mobility/1.0
* simulator-mobility/1.1.1: inactive release branch, based on qtmobility-releases/1.1.1
* simulator-mobility/1.0.2: inactive release branch based on qt-mobility-releases/1.0.2
* simulator-mobility/1.0.1: inactive release branch based on qt-mobility-releases/1.0.1
* simulator-mobility/1.0.0: inactive release branch based on qt-mobility/1.0.0


===Categories:===
Inactive branches:<br />* simulator/1.0.1: inactive branch<br />* simulator-qt/4.7.0: inactive release branch<br />* simulator-qt/4.7.0-beta2: inactive release branch<br />* simulator-qt/4.7.0-beta1: inactive release branch<br />* simulator-qt/4.7.1: inactive release branch<br />* simulator-qt/4.7.2: inactive release branch<br />* simulator-mobility/1.0: maintenance and staging branch for qt-mobility/1.0<br />* simulator-mobility/1.1.1: inactive release branch, based on qtmobility-releases/1.1.1<br />* simulator-mobility/1.0.2: inactive release branch based on qt-mobility-releases/1.0.2<br />* simulator-mobility/1.0.1: inactive release branch based on qt-mobility-releases/1.0.1<br />* simulator-mobility/1.0.0: inactive release branch based on qt-mobility/1.0.0


* [[:Category:Qt-Labs-Projects|Qt Labs Projects]]
[[Category:Qt Labs Projects]]

Revision as of 09:21, 24 February 2015

English Italian

[toc align_right="yes&quot; depth="3&quot;]

Qt Simulator

A fast and lightweight simulator for Qt applications running on Nokia devices.

p=. Project Name: Qt Simulator
Platforms: Windows, Linux, Mac
Qt Version: Qt 4.7
License: "LGPL&quot;:http://www.gnu.org/licenses/lgpl.html
Blog entries: "http://labs.qt.nokia.com/category/qt-simulator/&quot;:http://labs.qt.nokia.com/category/qt-simulator/
Git repo: "http://qt.gitorious.org/qt-labs/simulator&quot;:http://qt.gitorious.org/qt-labs/simulator

Compiling

Building Qt Simulator and its dependencies is a little tedious at the moment. If you just want to use it, we recommend you install the Nokia Qt SDK instead. If you want to build from source, follow this step-by-step instruction. Note that the order of the steps is important.

Repositories

The simulator application itself requires Qt as well as code contained in these repositories:
* "Qt Simulator&quot;:http://qt.gitorious.org/qt-labs/simulator, the master branch
* "Remote Control Widget&quot;:http://qt.gitorious.org/qt-labs/remotecontrolwidget, the simulator-master branch
* "Qt Messaging Framework (QMF)":http://qt.gitorious.org/qt-labs/messagingframework, commit a4adb57b076e

For building applications destined to run inside Qt Simulator, you need:
* "Simulator Qt&quot;:http://qt.gitorious.org/~qtbynokia/qt/simulator-qt, the 4.7 branch
* "Simulator Qt Mobility&quot;:http://qt.gitorious.org/~qtbynokia/qt-mobility/simulator-mobility, the 1.2.0 branch

Preparation

Create two directories:
* (simulator-qt-mobility-prefix)
* (simulator-depends)

Set the environment variables to the matching paths:
* QT_NOKIA_SDK_PATH=(Simulator Qt source directory)
* QT_MOBILITY_SOURCE_PATH=(Simulator Qt Mobility source directory)
* QMF_INCLUDEDIR=(QMF source directory)/src/libraries/qmfclient
* QMF_LIBDIR=(simulator-qt-mobility-prefix)/lib
* SIMULATOR_DEPENDENCY_PATH=(simulator-depends)

Simulator application

  • Get a Qt 4.7. We call this the Desktop Qt. Use only this Qt here.
  • Run qmake -r QMF_INSTALL_ROOT=(simulator-depends) on QMF in a build directory of your choice.
  • Build and install (QMF)/src/libraries/qmfclient.
  • Build and install (QMF)/src/plugins/contentmanagers/qmfstoragemanager
  • Build and install Qt Mobility. Pass -modules "connectivity location contacts versit organizer&quot; -prefix (simulator-depends) to configure.
  • Build and install (Remote Control Widget)/library. Pass PREFIX=(simulator-depends) to qmake.
  • Build the simulator itself.

Dependencies for client applications

  • Build the Simulator Qt, passing -simulator and -developer-build to configure. On linux, pass -opengl if you want to. Use only this Qt here. That means all further steps in this section should use the Simulator Qt's qmake.
  • Run qmake -r QMF_INSTALL_ROOT=(simulator-qt-mobility-prefix) on QMF in a build directory of your choice that's different from the one above.
  • Build and install (QMF)/src/libraries/qmfclient.
  • Build and install (QMF)/src/plugins/contentmanagers/qmfstoragemanager.
  • Build and install Simulator Qt Mobility. Pass -prefix (simulator-qt-mobility-prefix) to configure. (set PATH to make sure the Simulator Qt's qmake is used)

Client applications

Register the Simulator Qt you built in Qt Creator and select the Qt Simulator target to build client applications. Alternatively, use the Simulator Qt's qmake directly.

Development

Branches

We categorize branches into:
* maintenance branch: Maintenance for a released version. Can be merged into the development branch.
* development branches: This is where new features go.
* staging branch for X: Will automatically be merged back and forth to and from X.
* active release branches: More stable branches used for future releases. No changes should be pushed to them. The release manager will cherry-pick fixes.
* inactive release branches: Previously active release branches that are kept for reference. Will not change.

These are the current branches:
* simulator/1.1: maintenance branch
* simulator/master: development branch
* simulator-qt/4.7: development branch, qt/4.7 is merged regularly
* simulator-qt/4.7.4: active release branch, qt-releases/4.7.4 is merged regularly
* simulator-mobility/1.1: maintenance and staging branch for qt-mobility/1.1
* simulator-mobility/1.2.0: active release branch, qtmobility-releases/1.2.0 is merged regularly
* simulator-mobility/master: development branch and staging branch for qt-mobility/master
* remotecontrolwidget/simulator: maintenance branch (use with simulator/1.1)
* remotecontrolwidget/simulator-master: development branch (use with simulator/master), remotecontrolwidget/simulator is merged regularly

Inactive branches:
* simulator/1.0.1: inactive branch
* simulator-qt/4.7.0: inactive release branch
* simulator-qt/4.7.0-beta2: inactive release branch
* simulator-qt/4.7.0-beta1: inactive release branch
* simulator-qt/4.7.1: inactive release branch
* simulator-qt/4.7.2: inactive release branch
* simulator-mobility/1.0: maintenance and staging branch for qt-mobility/1.0
* simulator-mobility/1.1.1: inactive release branch, based on qtmobility-releases/1.1.1
* simulator-mobility/1.0.2: inactive release branch based on qt-mobility-releases/1.0.2
* simulator-mobility/1.0.1: inactive release branch based on qt-mobility-releases/1.0.1
* simulator-mobility/1.0.0: inactive release branch based on qt-mobility/1.0.0