feedc0de/qt-creator
1
0
Fork 0
forked from qt-creator/qt-creator
Code Pull Requests Activity

Doc: Harmattan target

Browse Source 
Reviewed-by: Christian Kandeler

Change-Id: Ica62fc3f04bbc4b0fea84ff44399ac12ea44c0da
Reviewed-on: http://codereview.qt.nokia.com/587
Reviewed-by: Qt Sanity Bot <qt_sanity_bot@ovi.com>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@nokia.com>
This commit is contained in:
Leena Miettinen
2011-06-14 15:59:30 +02:00
committed by Eike Ziller
parent 74d015d2a9
commit a6c0ce3c65
6 changed files with 254 additions and 130 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
doc/images/qmldesigner-new-project-qt-versions.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 31 KiB

After

Width:  |  Height:  |  Size: 29 KiB

BIN
doc/images/qtcreator-gs-build-example-targets.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 26 KiB

After

Width:  |  Height:  |  Size: 17 KiB

BIN
doc/images/qtcreator-maemo-deb-package.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 31 KiB

After

Width:  |  Height:  |  Size: 30 KiB

BIN
doc/images/qtcreator-mobile-project-qt-versions.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 32 KiB

After

Width:  |  Height:  |  Size: 17 KiB

137
doc/maemodev.qdoc
View File

@@ -34,20 +34,25 @@
\nextpage smartinstaller.html \nextpage smartinstaller.html
\endif \endif
\title Connecting Maemo Devices \title Connecting Maemo and MeeGo Harmattan Devices
Maemo 5 (Fremantle) is a software platform developed by Nokia for Maemo 5 (Fremantle) and MeeGo Harmattan are Linux-based software platforms
smartphones. The Maemo 5 SDK provides an open development environment developed by Nokia for mobile devices. They allow developers to create
for different applications on top of the Maemo platform. The necessary applications using the Qt framework.
tools from the Maemo 5 SDK are also included in the \QSDK.
The whole tool chain that you need to create, build, debug, run, and deploy The whole tool chain that you need to create, build, debug, run, and deploy
Maemo 5 applications is installed and configured when you install the Maemo 5 and Harmattan applications is installed and configured when you
install the
\QSDK. \QSDK.
\if defined(qcmanual) \if defined(qcmanual)
Maemo 5 is based on the Linux 2.6 operating system. For more For more
information about the Maemo 5 platform, see information about the Maemo 5 platform, see
\l{http://maemo.org/intro/platform/}{Software Platform} on the Maemo web site. \l{http://maemo.org/intro/platform/}{Software Platform} on the Maemo web site.
\omit
For more information about the Harmattan platform, see ##Add link.
\endomit
\endif \endif
For more information about developing applications for the Maemo 5 For more information about developing applications for the Maemo 5
@@ -55,20 +60,34 @@
or see or see
\l{http://doc.qt.nokia.com/qt-maemo/platform-notes-maemo5.html}{Platform Notes - Maemo 5}. \l{http://doc.qt.nokia.com/qt-maemo/platform-notes-maemo5.html}{Platform Notes - Maemo 5}.
For more information about developing applications for the Harmattan
platform, select \gui {Help > Index} and look for \gui {Platform Notes}.
\note \QSDK does not contain the tool chains for building applications for
other MeeGo devices than MeeGo Harmattan. You can try to run applications
from Qt Creator on other MeeGo devices, but it has not been tested, and the
instructions might not always apply.
\section1 Hardware and Software Requirements \section1 Hardware and Software Requirements
To build and run Qt applications for Maemo 5, you need the following: To build and run Qt applications for Maemo 5 or Harmattan, you need the
following:
\list \list
\o Nokia N900 device with software update release 1.3 (V20.2010.36-2)
or later installed. \o Test device:
\list
\o Maemo 5 device: Nokia N900 with software update release 1.3
(V20.2010.36-2) or later installed.
\o Harmattan device: Nokia N950
\endlist
\if defined(qcmanual) \if defined(qcmanual)
\o MADDE cross-platform Maemo development \o MADDE cross-platform Maemo development
tool (installed as part of the \QSDK). tool (installed as part of the \QSDK).
For more information about MADDE pertaining to its
installation, configuration, and deployment on the device, see
\l{http://wiki.maemo.org/MADDE}{Introduction to MADDE}.
\endif \endif
\o Nokia USB drivers. \o Nokia USB drivers.
@@ -83,15 +102,16 @@
\endlist \endlist
\note The only supported build system for Maemo 5 in Qt \note The only supported build system for Maemo 5 and Harmattan in Qt
Creator is qmake. Creator is qmake.
\section1 Setting Up the Nokia N900 \section1 Setting Up Connectivity in Devices
You can connect your device to your development PC using either a USB or You can connect your device to your development PC using either a USB or
WLAN connection. WLAN connection.
For the device, you need to use a tool called Mad Developer to create the For the device, you need to use a connectivity tool (Mad Developer on
Maemo 5 and SDK Connectivity on Harmattan) to create the
device-side end point for USB and WLAN connections. It provides no device-side end point for USB and WLAN connections. It provides no
diagnostics functions but is essential for creating connections between the diagnostics functions but is essential for creating connections between the
device and your development PC. device and your development PC.
@@ -100,16 +120,44 @@
it to the same WLAN as the development PC. The network address is displayed it to the same WLAN as the development PC. The network address is displayed
in the Mad Developer. in the Mad Developer.
To use a USB connection, you need to set up the Nokia N900 as a network device To use a USB connection, you need to set up the device as a network device
on the development PC. on the development PC.
\note If you plan to connect your development PC to the Nokia N900 only over WLAN, you can \note If you plan to connect your development PC to the device only over
WLAN, you can
ignore the USB-specific parts in the following sections. ignore the USB-specific parts in the following sections.
\section2 Installing and Configuring Mad Developer \section2 Starting SDK Connectivity on Nokia N950
Install Mad Developer on a device and configure SDK Connectivity application is preinstalled in the Nokia N950 and
a connection between the development PC and the device. available in developer mode.
To start SDK Connectivity:
\list
\o On the Nokia N950, select \gui {Settings > Security > Developer
mode} to turn on developer mode.
\o Select \gui {Applications > SDK Connectivity} to start the SDK
Connectivity application.
\o Select \gui {Select Connection} and then select the type of the
connection to create: \gui WLAN or \gui USB.
\o For a USB connection, select the operating system of the
development PC in \gui {Select Module}.
\endlist
\gui {Connectivity Details} displays the IP address and developer password.
The address 192.168.2.15 is used by default. You must enter the password in
Qt Creator.
\section2 Installing and Configuring Mad Developer on Nokia N900
Install Mad Developer on a Nokia N900 device and configure
a connection between the development PC and a device.
\note The following instructions describe Mad Developer 2.1. The process and \note The following instructions describe Mad Developer 2.1. The process and
text labels might differ on other Mad Developer versions. text labels might differ on other Mad Developer versions.
@@ -149,10 +197,11 @@
\image qtcreator-mad-developer-screenshot.png \image qtcreator-mad-developer-screenshot.png
\endlist \endlist
\section1 Installing Qt Mobility APIs \section1 Installing Qt Mobility Libraries
To develop applications that use the Qt Mobility APIs, you must install the To develop applications that use the Qt Mobility APIs, you must install the
APIs on the devices. The APIs are not available in the Nokia N900 package Qt Mobility Libraries on the devices. The APIs are not available in the
device package
manager, and therefore, you must install them from the command line as the manager, and therefore, you must install them from the command line as the
root user: root user:
@@ -182,8 +231,8 @@
for its USB connection by default, so you can create the network interface for its USB connection by default, so you can create the network interface
with a different address inside the same subnet too. with a different address inside the same subnet too.
\note If you have changed the IP address of the device when configuring \note If you have changed the IP address of the device in the connectivity
Mad Developer, you need to reflect those changes in your development PC USB tool, you need to reflect those changes in your development PC USB
network settings. network settings.
Run the following command in a shell as root user: Run the following command in a shell as root user:
@@ -219,15 +268,14 @@
Depending on Depending on
your version of Microsoft Windows you may have to unplug and re-plug the your version of Microsoft Windows you may have to unplug and re-plug the
Nokia N900 to reload the driver with its configuration accordingly. device to reload the driver with its configuration accordingly.
\section1 Configuring Connections in Qt Creator \section1 Configuring Connections in Qt Creator
To be able to run and debug applications on the Maemo emulator and To be able to run and debug applications on the Maemo or MeeGo Harmattan
devices, you must set up connections to the emulator and devices in the emulator and devices, you must set up connections to the emulator and
Qt Creator build and run settings. devices in the Qt Creator build and run settings. If you install \QSDK, the
If you install \QSDK, the connection to the emulator is configured automatically and you
connection to the Maemo emulator is configured automatically and you
only need to configure a connection to the device. only need to configure a connection to the device.
You use a wizard to create the connections. You can edit the settings later You use a wizard to create the connections. You can edit the settings later
@@ -248,9 +296,9 @@
You can protect the connections between Qt Creator and You can protect the connections between Qt Creator and
a Maemo device by using either a password or an SSH key. If you use a password, you a device by using either a password or an SSH key. If you use a password, you
must generate it in Mad Developer and enter it in Qt Creator every time must generate it in the connectivity tool and enter it in Qt Creator every time
you connect to the Maemo device. you connect to the device.
If you do not have an SSH key, you can create it in Qt Creator. If you do not have an SSH key, you can create it in Qt Creator.
Encrypted keys are not supported. For more Encrypted keys are not supported. For more
@@ -262,12 +310,12 @@
\endif \endif
To configure connections between Qt Creator and the Maemo To configure connections between Qt Creator and a
device: device:
\list 1 \list 1
\o To deploy applications and run them remotely on Maemo devices, \o To deploy applications and run them remotely on devices,
specify parameters for accessing devices: specify parameters for accessing devices:
\list a \list a
@@ -295,7 +343,7 @@
\gui {Hardware device}. \gui {Hardware device}.
\o In the \gui {The device's host name or IP address} field, enter \o In the \gui {The device's host name or IP address} field, enter
the IP address from the \gui usb0 or \gui wlan0 field in Mad Developer. the IP address from the connectivity tool on the device.
\o Click \gui Next. \o Click \gui Next.
@@ -305,7 +353,7 @@
\if defined(qcmanual) \if defined(qcmanual)
\o To test applications on the Maemo emulator (QEMU) separately, you must \o To test applications on the emulator (QEMU) separately, you must
create a connection to it from the development PC. If you installed create a connection to it from the development PC. If you installed
\QSDK, the connection is created automatically and you can omit this \QSDK, the connection is created automatically and you can omit this
step. step.
@@ -340,7 +388,7 @@
\list a \list a
\o Open a project for an application you want to develop for your \o Open a project for an application you want to develop for your
Nokia N900. device.
\o Click \gui Projects to open the projects mode. \o Click \gui Projects to open the projects mode.
@@ -354,7 +402,7 @@
give it a new name, click \gui Rename. give it a new name, click \gui Rename.
\o In the \gui {Device configuration} field, select the device \o In the \gui {Device configuration} field, select the device
connection or the Maemo emulator connection. connection or the emulator connection.
\image qtcreator-screenshot-run-settings.png \image qtcreator-screenshot-run-settings.png
\o Click \gui {<no target path set>} in \gui {Remote Directory} \o Click \gui {<no target path set>} in \gui {Remote Directory}
@@ -391,7 +439,7 @@
If you do not have an SSH public and private key pair, you can generate it If you do not have an SSH public and private key pair, you can generate it
in Qt Creator. You can specify key length and the key algorithm, RSA or DSA. in Qt Creator. You can specify key length and the key algorithm, RSA or DSA.
If you only use the keys to protect connections to the Maemo emulator or If you only use the keys to protect connections to the emulator or
device, you can use the default values. device, you can use the default values.
\list 1 \list 1
@@ -415,7 +463,8 @@
\section2 Managing Device Processes \section2 Managing Device Processes
You can view processes running on the Maemo device and kill them. You can view processes running on the Maemo or MeeGo Harmattan device and
kill them.
Select \gui {Tools > Options... > Maemo > Maemo Device Configurations > Select \gui {Tools > Options... > Maemo > Maemo Device Configurations >
Remote Processes...}. Remote Processes...}.
@@ -438,7 +487,7 @@
\table \table
\header \header
\o usb0 in Mad Developer on Device \o IP Address and Network on Device
\o USB Network on Development PC \o USB Network on Development PC
\o Host Name in Qt Creator Build Settings \o Host Name in Qt Creator Build Settings

247
doc/qtcreator.qdoc
View File

@@ -65,7 +65,7 @@
\o \l{Creating a Project} \o \l{Creating a Project}
\o \l{Opening a Project} \o \l{Opening a Project}
\o \l{Adding Libraries to Projects} \o \l{Adding Libraries to Projects}
\o \l{Connecting Maemo Devices} \o \l{Connecting Maemo and MeeGo Harmattan Devices}
\o \l{Connecting Symbian Devices} \o \l{Connecting Symbian Devices}
\o \l{Managing Sessions} \o \l{Managing Sessions}
\endlist \endlist
@@ -129,7 +129,7 @@
\o \l{Deploying Applications to Mobile Devices} \o \l{Deploying Applications to Mobile Devices}
\list \list
\o \l{Deploying Applications to Symbian Devices} \o \l{Deploying Applications to Symbian Devices}
\o \l{Deploying Applications to Maemo Devices} \o \l{Deploying Applications to Maemo or MeeGo Harmattan Devices}
\o \l{Publishing Maemo Applications to Extras-devel} \o \l{Publishing Maemo Applications to Extras-devel}
\o \l{Publishing Applications to Ovi Store} \o \l{Publishing Applications to Ovi Store}
\o \l{Building with Remote Compiler} \o \l{Building with Remote Compiler}
@@ -144,7 +144,7 @@
\o \l{Using Version Control Systems} \o \l{Using Version Control Systems}
\o \l{Adding Qt Designer Plugins} \o \l{Adding Qt Designer Plugins}
\o \l{Using External Tools} \o \l{Using External Tools}
\o \l{Using the Maemo Emulator} \o \l{Using Maemo or MeeGo Harmattan Emulator}
\o \l{Editing MIME Types} \o \l{Editing MIME Types}
\o \l{Showing Task List Files in the Build Issues Pane} \o \l{Showing Task List Files in the Build Issues Pane}
\o \l{Using Command Line Options} \o \l{Using Command Line Options}
@@ -337,10 +337,12 @@
or CMake, and specify that Qt Creator ignores your build system. or CMake, and specify that Qt Creator ignores your build system.
Qt Creator provides support for building and running Qt applications for Qt Creator provides support for building and running Qt applications for
desktop environment (Windows, Linux, and Mac OS) and mobile devices (Symbian and Maemo). desktop environment (Windows, Linux, and Mac OS) and mobile devices
(Symbian, Maemo, and MeeGo Harmattan).
Build settings allow you to quickly switch between build targets. Build settings allow you to quickly switch between build targets.
When you install the \QSDK, the build and run settings for the Maemo and Symbian When you install the \QSDK, the build and run settings for the Harmattan,
Maemo, and Symbian
targets are set up automatically. However, you need to install and configure some targets are set up automatically. However, you need to install and configure some
additional software on the devices to be able to connect to them from the additional software on the devices to be able to connect to them from the
development PC. development PC.
@@ -357,8 +359,9 @@
You can connect mobile devices to your development PC and debug processes You can connect mobile devices to your development PC and debug processes
running on the devices. running on the devices.
You can test applications that are intended for mobile devices in the Qt You can test applications that are intended for mobile devices in Qt
Simulator and Maemo Emulator, but you also need to test the applications Simulator and Maemo or MeeGo Harmattan emulator, but you also need to test
the applications
on real devices. on real devices.
\section2 Debuggers \section2 Debuggers
@@ -438,16 +441,21 @@
The Qt Simulator is installed as part of the \QSDK. After it is The Qt Simulator is installed as part of the \QSDK. After it is
installed, you can select it as a build target in Qt Creator. installed, you can select it as a build target in Qt Creator.
\section2 Maemo Emulator \section2 Maemo and MeeGo Harmattan Emulator
The Maemo 5 (Fremantle) and MeeGo Harmattan emulator are installed as part
of the \QSDK. After they are installed, you can start them from Qt Creator.
The Maemo 5 emulator emulates the Nokia N900 device environment. You can test The Maemo 5 emulator emulates the Nokia N900 device environment. You can test
applications in conditions practically identical to running the application applications in conditions practically identical to running the application
on a Nokia N900 device with the software update release 1.3 (V20.2010.36-2). on a Nokia N900 device with the software update release 1.3 (V20.2010.36-2).
However, it is faster to test on a real device connected to the development
PC.
The Maemo Emulator is installed as part of the \QSDK. After it is The Harmattan emulator emulates the Nokia N950 device environment.
installed, you can start it from Qt Creator.
With the emulators, you can test how your application reacts to hardware
controls, such as the power button, and to the touch screen.
Usually, it is faster to test on a real device connected to the development
PC than to use the emulators.
\section1 Deploying \section1 Deploying
@@ -456,7 +464,8 @@
The files can be copied to a location in the file system of the development PC The files can be copied to a location in the file system of the development PC
or to a mobile device. or to a mobile device.
Qt Creator allows you to create installation packages for Symbian and Maemo Qt Creator allows you to create installation packages for Symbian, Maemo,
and MeeGo Harmattan
devices that are suitable for publishing on Ovi Store and other channels. devices that are suitable for publishing on Ovi Store and other channels.
*/ */
@@ -521,6 +530,8 @@
\o Maemo 5 \o Maemo 5
\o MeeGo Harmattan
\o Symbian \o Symbian
\endlist \endlist
@@ -530,12 +541,13 @@
\table \table
\header \header
\o {1,4} Operating system \o {1,5} Operating system
\o {4,1} Platform \o {5,1} Platform
\header \header
\o Desktop \o Desktop
\o Qt Simulator \o Qt Simulator
\o Maemo \o Maemo 5
\o MeeGo Harmattan
\o Symbian \o Symbian
\row \row
@@ -544,17 +556,20 @@
\o Yes \o Yes
\o Yes \o Yes
\o Yes \o Yes
\o Yes
\row \row
\o Linux \o Linux
\o Yes \o Yes
\o Yes \o Yes
\o Yes \o Yes
\o Yes
\o Yes (by using Remote Compiler for building) \o Yes (by using Remote Compiler for building)
\row \row
\o Mac OS X \o Mac OS X
\o Yes \o Yes
\o Yes \o Yes
\o Yes \o Yes
\o Yes
\o Yes (by using Remote Compiler for building) \o Yes (by using Remote Compiler for building)
\endtable \endtable
*/ */
@@ -3040,7 +3055,8 @@
Compiler, is installed as a part of the \QSDK. For more information, see Compiler, is installed as a part of the \QSDK. For more information, see
\l{Building with Remote Compiler}. \l{Building with Remote Compiler}.
When you install the \QSDK, the build and run settings for the Maemo and When you install the \QSDK, the build and run settings for the Maemo, MeeGo
Harmattan, and
Symbian targets are set up automatically. However, you need to install and Symbian targets are set up automatically. However, you need to install and
configure some additional software on the devices to be able to connect to configure some additional software on the devices to be able to connect to
them from the development PC. them from the development PC.
@@ -3056,7 +3072,7 @@
\o \l{Creating a Project} \o \l{Creating a Project}
\o \l{Opening a Project} \o \l{Opening a Project}
\o \l{Adding Libraries to Projects} \o \l{Adding Libraries to Projects}
\o \l{Connecting Maemo Devices} \o \l{Connecting Maemo and MeeGo Harmattan Devices}
\o \l{Connecting Symbian Devices} \o \l{Connecting Symbian Devices}
\o \l{Managing Sessions} \o \l{Managing Sessions}
\endlist \endlist
@@ -3285,7 +3301,7 @@
By default, Qt Creator does a \l{glossary-shadow-build}{shadow build} and also By default, Qt Creator does a \l{glossary-shadow-build}{shadow build} and also
creates the directory. However, shadow building is not supported for the Symbian creates the directory. However, shadow building is not supported for the Symbian
Devices or Maemo5 target on Windows. Devices, Maemo5, or Harmattan target on Windows.
If you have built the project before, Qt Creator can use the existing build If you have built the project before, Qt Creator can use the existing build
configuration to make the exact same build as found in the directory available to configuration to make the exact same build as found in the directory available to
@@ -3796,7 +3812,7 @@
Qt Creator allows you to have multiple versions of Qt installed on Qt Creator allows you to have multiple versions of Qt installed on
your development PC and use different versions to build your projects for your development PC and use different versions to build your projects for
different targets. For example, \QSDK contains special Qt versions for different targets. For example, \QSDK contains special Qt versions for
Maemo and Symbian development. MeeGo Harmattan, Maemo, and Symbian development.
Qt Creator checks the directories listed in the \c{PATH} environment Qt Creator checks the directories listed in the \c{PATH} environment
variable for the qmake executable. If a qmake executable is found, it is variable for the qmake executable. If a qmake executable is found, it is
@@ -4303,21 +4319,22 @@
For more information about using the Qt Simulator, see the For more information about using the Qt Simulator, see the
\l{http://doc.qt.nokia.com/qtsimulator/index.html}{Qt Simulator Manual}. \l{http://doc.qt.nokia.com/qtsimulator/index.html}{Qt Simulator Manual}.
\section1 Running on Maemo \section1 Running on Maemo or MeeGo Harmattan
\list 1 \list 1
\o Build and run the application for \l{Running on Qt Simulator}{Qt Simulator}. \o Build and run the application for \l{Running on Qt Simulator}{Qt Simulator}.
\o Build and run the application for \l{Using the Maemo Emulator}{Maemo Emulator}. \o Build and run the application for
\l{Using Maemo or MeeGo Harmattan Emulator}
{the Maemo or MeeGo Harmattan emulator}.
\o Alternatively, you can build and run the application for a device: \o Alternatively, you can build and run the application for a device:
\list 1 \list 1
\o Set up the MADDE development environment and specify a connection \o Configure the device and specify a connection to it. For more
to the device. For more information, see information, see \l{Connecting Maemo and MeeGo Harmattan Devices}.
\l{Connecting Maemo Devices}.
\o Connect the device to the development PC. \o Connect the device to the development PC.
@@ -4332,13 +4349,14 @@
Qt Creator generates an installation package, installs it on the device, Qt Creator generates an installation package, installs it on the device,
and executes the selected application. and executes the selected application.
The application views are displayed on the Nokia N900. The application views are displayed on the device.
Command-line Command-line
output is visible in the Qt Creator \gui {Application Output} view. output is visible in the Qt Creator \gui {Application Output} view.
Choose \gui {Projects > Maemo Run} to view the settings for deploying the Choose \gui {Projects > Maemo Run} to view the settings for deploying the
application on the connected device and creating the installation package. application on the connected device and creating the installation package.
For more information, see \l{Specifying Run Settings for Maemo Devices}. For more information, see
\l{Specifying Run Settings for Maemo and MeeGo Harmattan Devices}.
Debugging also works transparently. Debugging also works transparently.
@@ -4443,7 +4461,8 @@
The \gui {Remote Compiler} target is an interface to a compilation service at The \gui {Remote Compiler} target is an interface to a compilation service at
Forum Nokia. It provides a simple, standardized environment for building Qt Forum Nokia. It provides a simple, standardized environment for building Qt
applications and creating installation packages for Symbian and Maemo devices applications and creating installation packages for Symbian, Maemo, and
MeeGo Harmattan devices
when you do not have the necessary tool chains and SDKs installed or they are when you do not have the necessary tool chains and SDKs installed or they are
not supported on the development PC. You can choose from a set of supported not supported on the development PC. You can choose from a set of supported
devices, such as S60 3rd Edition or S60 5th Edition devices. devices, such as S60 3rd Edition or S60 5th Edition devices.
@@ -4540,7 +4559,8 @@
This keeps the files generated for each target platform separate. This keeps the files generated for each target platform separate.
\note Shadow building is not supported by the Symbian build system. \note Shadow building is not supported by the Symbian build system.
Also, shadow building on Windows is not supported for Maemo. Also, shadow building on Windows is not supported for Maemo or
MeeGo Harmattan.
If you only build for one target platform, you can deselect If you only build for one target platform, you can deselect
the \gui{Shadow build} checkbox. the \gui{Shadow build} checkbox.
\endlist \endlist
@@ -4741,30 +4761,35 @@
publishing and installing applications on Symbian devices. For more information, publishing and installing applications on Symbian devices. For more information,
see \l{Deploying Applications to Symbian Devices}. see \l{Deploying Applications to Symbian Devices}.
\section2 Specifying Run Settings for Maemo Devices \section2 Specifying Run Settings for Maemo and MeeGo Harmattan Devices
To run an application on a Maemo device, create and select To run an application on a Maemo or MeeGo Harmattan device, create and
a device configuration in the Maemo run settings for your project. select a device configuration in the Maemo 5 or Harmattan run settings for
your project.
You can also pass command line arguments to your application. You can also pass command line arguments to your application.
\image qtcreator-screenshot-run-settings-maemo.png "Run settings for Maemo devices" \image qtcreator-screenshot-run-settings-maemo.png "Run settings for Maemo devices"
To run and debug applications on Maemo devices, you must create connections To run and debug applications on Maemo or MeeGo Harmattan devices, you must
create connections
from the development PC to the devices. Click \gui {Manage device from the development PC to the devices. Click \gui {Manage device
configurations} to create connections. For more information, see configurations} to create connections. For more information, see
\l {Configuring Connections in Qt Creator}. \l {Configuring Connections in Qt Creator}.
By default, Qt Creator runs the remote gdbserver daemon on the device for By default, Qt Creator runs the remote gdbserver daemon on the device for
debugging. However, if the sysroot does not match that of the device, you debugging. On Maemo 5, if the sysroot does not match that of the device,
you
can run remote GDB, instead. Select the \gui {Use remote GDB} option in can run remote GDB, instead. Select the \gui {Use remote GDB} option in
\gui {Debugging details}. Select the \gui {Set debugger} link to specify \gui {Debugging details}. Select the \gui {Set debugger} link to specify
settings for GDB. settings for GDB.
When you run the application on the \gui{Maemo} target, Qt Creator generates When you run the application on the \gui{Maemo5} or \gui Harmattan target,
Qt Creator generates
a Debian installation package in the build directory by default. You can deliver a Debian installation package in the build directory by default. You can deliver
the installation package to users for installation on Maemo devices that are of the installation package to users for installation on devices that are of
the same type and run the same firmware as the connected device. For more the same type and run the same firmware as the connected device. For more
information, see \l{Deploying Applications to Maemo Devices}. information, see
\l{Deploying Applications to Maemo or MeeGo Harmattan Devices}.
\section1 Specifying a Custom Executable to Run \section1 Specifying a Custom Executable to Run
@@ -4817,9 +4842,10 @@
\page creator-deployment-maemo.html \page creator-deployment-maemo.html
\nextpage creator-publishing-to-maemo-extras.html \nextpage creator-publishing-to-maemo-extras.html
\title Deploying Applications to Maemo Devices \title Deploying Applications to Maemo or MeeGo Harmattan Devices
You can specify settings for deploying applications to Maemo devices in the You can specify settings for deploying applications to Maemo 5 and MeeGo
Harmattan devices in the
project .pro file. You can view the settings in the \gui {Run Settings}. project .pro file. You can view the settings in the \gui {Run Settings}.
\image qtcreator-maemo-deployment.png "Deploy to device" \image qtcreator-maemo-deployment.png "Deploy to device"
@@ -4847,9 +4873,10 @@
\section1 Creating Debian Installation Packages \section1 Creating Debian Installation Packages
When you run the application on the \gui{Maemo} target, Qt Creator generates When you run the application on the \gui{Maemo5} or \gui Harmattan target,
Qt Creator generates
a Debian installation package in the build directory by default. You can deliver a Debian installation package in the build directory by default. You can deliver
the installation package to users for installation on Maemo devices that are of the installation package to users for installation on devices that are of
the same type and run the same firmware as the connected device. the same type and run the same firmware as the connected device.
\image qtcreator-maemo-deb-package.png "Create installation package" \image qtcreator-maemo-deb-package.png "Create installation package"
@@ -4872,7 +4899,8 @@
\note Qt Creator automates this process for you. \note Qt Creator automates this process for you.
Qt Creator provides templates for a set of files that must be included Qt Creator provides templates for a set of files that must be included
in Debian packages. When you create a Maemo target for a project, Qt Creator in Debian packages. When you create a \gui Maemo5 or \gui Harmattan target
for a project, Qt Creator
asks whether packaging files are to be added to the project and to version asks whether packaging files are to be added to the project and to version
control. If you plan to edit the packaging files, add them to version control. If you plan to edit the packaging files, add them to version
control. control.
@@ -4967,11 +4995,12 @@
channel, you must make sure that the installation file meets the requirements for channel, you must make sure that the installation file meets the requirements for
publishing and installing applications to Symbian or Maemo devices. The following publishing and installing applications to Symbian or Maemo devices. The following
sections describe the steps that you have to take to create installation packages sections describe the steps that you have to take to create installation packages
for Symbian and Maemo devices and for publishing on Ovi Store: for Symbian, Maemo, or MeeGo Harmattan devices and for publishing on Ovi
Store:
\list \list
\o \l{Deploying Applications to Symbian Devices} \o \l{Deploying Applications to Symbian Devices}
\o \l{Deploying Applications to Maemo Devices} \o \l{Deploying Applications to Maemo or MeeGo Harmattan Devices}
\o \l{Publishing Maemo Applications to Extras-devel} \o \l{Publishing Maemo Applications to Extras-devel}
\o \l{Publishing Applications to Ovi Store} \o \l{Publishing Applications to Ovi Store}
\o \l{Building with Remote Compiler} \o \l{Building with Remote Compiler}
@@ -5516,15 +5545,21 @@
You set the application name and installation folder in the You set the application name and installation folder in the
\gui {Run Settings} for the project. For more information, see \gui {Run Settings} for the project. For more information, see
\l{Deploying Applications to Maemo Devices}. Qt Creator specifies the correct \l{Deploying Applications to Maemo or MeeGo Harmattan Devices}. Qt Creator
specifies the correct
category settings by default when it creates the Debian directory and category settings by default when it creates the Debian directory and
the necessary files. the necessary files.
You can test the application on Qt Simulator and Maemo Emulator to make You can test the application on Qt Simulator and Maemo emulator to make
sure that it does not crash or hang and to check how it handles different sure that it does not crash or hang and to check how it handles different
memory situations. Before you submit the application to Ovi Publishing, you memory situations. Before you submit the application to Ovi Publishing, you
must also fully test it on a Maemo device. must also fully test it on a Maemo device.
\section1 Publishing Qt Content for MeeGo Harmattan Devices
You cannot publish applications that are built with the beta version of the
MeeGo Harmattan tool chain to Ovi Store.
*/ */
/*! /*!
@@ -5663,8 +5698,8 @@
\image qtcreator-mobile-project-qt-versions.png "Target Setup dialog" \image qtcreator-mobile-project-qt-versions.png "Target Setup dialog"
\o Select \gui {Maemo5}, \gui {Qt Simulator}, and \gui {Symbian \o Select \gui {Symbian Device}, \gui {Maemo5}, \gui Harmattan, and
Device} targets, \gui {Qt Simulator} targets,
and click \gui{Next}. and click \gui{Next}.
\note Targets are listed if you installed the appropriate development \note Targets are listed if you installed the appropriate development
@@ -5679,7 +5714,8 @@
behaves when the orientation of the device display rotates between portrait behaves when the orientation of the device display rotates between portrait
and landscape, and then click \gui{Next}. and landscape, and then click \gui{Next}.
\note This dialog opens only if you select \gui Maemo5 or \note This dialog opens only if you select \gui Maemo5, \gui Harmattan,
or
\gui {Symbian Device} target in the \gui {Target Setup} dialog. \gui {Symbian Device} target in the \gui {Target Setup} dialog.
The \gui {Symbian Specific} dialog opens. The \gui {Symbian Specific} dialog opens.
@@ -5697,7 +5733,8 @@
\image qtcreator-mobile-project-maemo-options.png "Maemo Specific dialog" \image qtcreator-mobile-project-maemo-options.png "Maemo Specific dialog"
\o In the \gui {Application icon (64x64)} field, select the application \o In the \gui {Application icon (64x64)} field, select the application
icon to use on Maemo targets, or click \gui Next to use the default icon. icon to use on Maemo 5 or Harmattan targets, or click \gui Next to use
the default icon.
The \gui{Project Management} dialog opens. The \gui{Project Management} dialog opens.
@@ -5859,13 +5896,18 @@
\endlist \endlist
\section1 Testing on the Maemo Emulator \section1 Testing on the Maemo or MeeGo Harmattan Emulator
The Maemo 5 (Fremantle) and MeeGo Harmattan emulator are installed as part
of the \QSDK. After they are installed, you can start them from Qt Creator.
The Maemo emulator emulates the Nokia N900 device environment. You can test The Maemo emulator emulates the Nokia N900 device environment. You can test
applications in conditions practically identical to running the application applications in conditions practically identical to running the application
on a Nokia N900 device with the software update release 1.3 (V20.2010.36-2). on a Nokia N900 device with the software update release 1.3 (V20.2010.36-2).
For more information, see \l{Using the Maemo Emulator}. The MeeGo Harmattan emulator emulates the Nokia N950 device environment.
For more information, see \l{Using Maemo or MeeGo Harmattan Emulator}.
*/ */
@@ -5889,7 +5931,8 @@
\image qtcreator-gs-build-example-open.png "Selecting an example" \image qtcreator-gs-build-example-open.png "Selecting an example"
\o Select targets for the project. Select at least Qt Simulator \o Select targets for the project. Select at least Qt Simulator
and one of the mobile targets, Maemo or Symbian Device, depending on and one of the mobile targets, Symbian Device, Maemo 5, or Harmattan,
depending on
the device you develop for. the device you develop for.
\image qtcreator-gs-build-example-targets.png "Selecting targets" \image qtcreator-gs-build-example-targets.png "Selecting targets"
@@ -7531,7 +7574,7 @@
The on-device mode is a special mode available for run configurations The on-device mode is a special mode available for run configurations
targeting mobile devices. It debugs processes running on mobile targeting mobile devices. It debugs processes running on mobile
devices using on-device debugging agents, such as CODA on Symbian and devices using on-device debugging agents, such as CODA on Symbian and
gdbserver on Maemo and MeeGo. gdbserver on Maemo and MeeGo Harmattan.
To launch the debugger in the on-device mode, open the project, select a To launch the debugger in the on-device mode, open the project, select a
run configuration that targets a mobile device, and click the run configuration that targets a mobile device, and click the
@@ -7569,7 +7612,8 @@
with and without the ability to use Python scripting. The Python enabled with and without the ability to use Python scripting. The Python enabled
versions are preferred, but they are not available on Mac and on older versions are preferred, but they are not available on Mac and on older
versions of Linux. versions of Linux.
On Windows, Symbian, and Maemo, only the Python version is supported. On Windows, Symbian, Maemo, and MeeGo Harmattan, only the Python version is
supported.
The non-Python versions use the compiled version of the debugging helpers, The non-Python versions use the compiled version of the debugging helpers,
that you must enable separately. For more information, see that you must enable separately. For more information, see
@@ -7633,6 +7677,12 @@
\o GDB \o GDB
\o Yes \o Yes
\o On-device \o On-device
\row
\o MeeGo Harmattan
\o GCC
\o GDB
\o Yes
\o On-device
\endtable \endtable
For more information on the debugger modes, see \l{Launching the Debugger in Different Modes}. For more information on the debugger modes, see \l{Launching the Debugger in Different Modes}.
@@ -9094,7 +9144,8 @@
behaves when the orientation of the device display rotates between portrait behaves when the orientation of the device display rotates between portrait
and landscape, and then click \gui Next. and landscape, and then click \gui Next.
\note This dialog opens only if you select \gui Maemo5 or \note This dialog opens only if you select \gui Harmattan, \gui Maemo5,
or
\gui {Symbian Device} target in the \gui {Target Setup} dialog. \gui {Symbian Device} target in the \gui {Target Setup} dialog.
The \gui {Symbian Specific} dialog opens. The \gui {Symbian Specific} dialog opens.
@@ -9118,7 +9169,7 @@
\image qmldesigner-new-project-maemo-options.png "Maemo Specific dialog" \image qmldesigner-new-project-maemo-options.png "Maemo Specific dialog"
\o In the \gui {Application icon (64x64)} field, select the application \o In the \gui {Application icon (64x64)} field, select the application
icon to use on Maemo targets, or use the default icon. icon to use on Maemo or Harmattan targets, or use the default icon.
The \gui {QML Sources} dialog opens. The \gui {QML Sources} dialog opens.
@@ -9142,7 +9193,7 @@
\endlist \endlist
Qt Creator creates the necessary boilerplate files. Some of the files are Qt Creator creates the necessary boilerplate files. Some of the files are
specific to the Symbian or Maemo platform. specific to the Symbian, Maemo, or MeeGo Harmattan platform.
\section1 Importing QML Applications \section1 Importing QML Applications
@@ -9946,40 +9997,48 @@
\page creator-maemo-emulator.html \page creator-maemo-emulator.html
\nextpage creator-mime-types.html \nextpage creator-mime-types.html
\title Using the Maemo Emulator \title Using Maemo or MeeGo Harmattan Emulator
The Maemo 5 (Fremantle) and MeeGo Harmattan emulator are installed as part
of the \QSDK. After they are installed, you can start them from Qt Creator.
The Maemo 5 emulator emulates the Nokia N900 device environment. You can test The Maemo 5 emulator emulates the Nokia N900 device environment. You can test
applications in conditions practically identical to running the application applications in conditions practically identical to running the application
on a Nokia N900 device with software update release 1.3 (V20.2010.36-2). on a Nokia N900 device with software update release 1.3 (V20.2010.36-2).
You can test user interaction by using the keypad and
touch emulation. The MeeGo Harmattan emulator emulates the Nokia N950 device environment.
With the emulators, you can test how your application reacts to hardware
controls, such as the power button, and to the touch screen.
To test the application UI, user interaction with the application, and To test the application UI, user interaction with the application, and
functionality that uses the mobility APIs, use the Qt Simulator, functionality that uses the mobility APIs, use the Qt Simulator,
instead. For more information, see the instead. For more information, see the
\l{http://doc.qt.nokia.com/qtsimulator/index.html}{Qt Simulator Manual}. \l{http://doc.qt.nokia.com/qtsimulator/index.html}{Qt Simulator Manual}.
The Maemo 5 emulator is installed and configured as part of the \QSDK The difference between Qt Simulator and the emulators is that when you
package. You can also install and configure the MADDE environment and compile your application binary for Qt Simulator, it is compiled against a
Maemo emulator separately. For more information, see host library. The binary run on the emulator is compiled for the actual
\l{Connecting Maemo Devices}. device, using the Maemo 5 or Harmattan tool chain.
\section1 Starting the Maemo Emulator \section1 Starting the Emulator
The \gui {Start Maemo Emulator} button is visible if you have a project The \gui {Start Maemo Emulator} button is visible if you have a project
open in Qt Creator for which you have added the Maemo build target. open in Qt Creator for which you have added the Maemo or MeeGo Harmattan
build target. It starts the Maemo or MeeGo Harmattan emulator, depending
on the selected target.
To start the Maemo emulator, click To start the emulator, click
\inlineimage qtcreator-maemo-emulator-button.png "Start Maemo Emulator button" \inlineimage qtcreator-maemo-emulator-button.png "Start Maemo Emulator button"
. .
Test your application on the Maemo emulator as on a device. For a list of Test your application on the Maemo emulator as on a device. For a list of
keyboard shortcuts that you can use to emulate Nokia N900 keys and functions, see keyboard shortcuts that you can use to emulate keys and functions, see
\l {Emulating Nokia N900 Keys}. \l {Emulating Device Keys}.
\section1 Rendering Graphics \section1 Rendering Graphics
The Maemo emulator supports OpenGL to improve graphics rendering. Hardware The emulators support OpenGL to improve graphics rendering. Hardware
acceleration produces better results than software rendering. By default, acceleration produces better results than software rendering. By default,
Qt Creator automatically detects, whether hardware acceleration is Qt Creator automatically detects, whether hardware acceleration is
supported on the development PC and tries to use it. However, sometimes supported on the development PC and tries to use it. However, sometimes
@@ -9987,20 +10046,20 @@
hardware acceleration might be selected even if it is actually not hardware acceleration might be selected even if it is actually not
available on the development PC. This causes the emulator to crash. available on the development PC. This causes the emulator to crash.
If the Maemo emulator crashes, you are asked whether you want to try If the emulator crashes, you are asked whether you want to try software
software rendering, instead. rendering, instead.
To specify the OpenGL mode, select \gui {Tools > Options... > Maemo > Qemu To specify the OpenGL mode, select \gui {Tools > Options... > Maemo > Qemu
Settings}. Settings}.
\section1 Emulating Nokia N900 Keys \section1 Emulating Device Keys
The following table summarizes the keyboard shortcuts that you can use The following table summarizes the keyboard shortcuts that you can use
to emulate Nokia N900 keys and functions. to emulate device keys and functions.
\table \table
\header \header
\o Nokia N900 Key \o Device Key
\o Keyboard Shortcut \o Keyboard Shortcut
\row \row
\o \list \o \list
@@ -10015,13 +10074,19 @@
\o Respective keys on the development PC keyboard. \o Respective keys on the development PC keyboard.
\row \row
\o Shift \o Shift
\o Left Shift key \o Left Shift key (Maemo 5)
Shift (Harmattan)
\row \row
\o Ctrl \o Ctrl
\o Left Ctrl key \o Left Ctrl key (Maemo 5)
Ctrl (Harmattan)
\row \row
\o Mode \o Mode
\o Left Alt key \o Left Alt key (Maemo 5)
Alt (Harmattan)
\row \row
\o Power \o Power
\o Esc \o Esc
@@ -10029,10 +10094,10 @@
\o Keypad slider open and close \o Keypad slider open and close
\o F1 \o F1
\row \row
\o Keypad lock \o Keypad lock (Maemo 5 only)
\o F2 \o F2
\row \row
\o Camera lens open and close \o Camera lens open and close (Maemo 5 only)
\o F3 \o F3
\row \row
\o Camera focus \o Camera focus
@@ -10040,9 +10105,10 @@
\row \row
\o Camera take picture \o Camera take picture
\o F5 \o F5
\note The actual camera functionality is not emulated. \note The actual camera functionality is not emulated.
\row \row
\o Stereo headphones connect and disconnect \o Stereo headphones connect and disconnect (Maemo 5 only)
\o F6 \o F6
\row \row
\o Volume down \o Volume down
@@ -10071,6 +10137,15 @@
\endtable \endtable
\note Each press of the accelerometer key turns the acceleration by 50
percent.
\section1 Closing the Emulator
To close the emulator, click the X at the top right corner of the device
emulator view. The emulator interprets this as a press of the power button
and displays the text \e {Shutting down} in the emulator window title pane.
The emulator closes shortly after this.
*/ */
@@ -10266,6 +10341,7 @@
\o Remember the processing limits of the device \o Remember the processing limits of the device
The memory available on devices is limited The memory available on devices is limited
and you should use it carefully. Although all mobile devices have common functionality, and you should use it carefully. Although all mobile devices have common functionality,
each device is individual in terms of both the resources available and extra features. each device is individual in terms of both the resources available and extra features.
@@ -11132,9 +11208,8 @@
\o Creating new CMake projects with Qt Creator is not supported. \o Creating new CMake projects with Qt Creator is not supported.
\o Building and packaging subprojects is not supported for Maemo devices. \o On Windows, you must create projects for Maemo 5 and Harmattan
targets on the same partition where
\o You must create projects for Maemo targets on the same partition where
you installed \QSDK, Qt Creator, and MADDE. you installed \QSDK, Qt Creator, and MADDE.
\o If error messages displayed in the \gui {Compile Output} pane contain \o If error messages displayed in the \gui {Compile Output} pane contain
@@ -11716,7 +11791,7 @@
\o \l{Using Version Control Systems} \o \l{Using Version Control Systems}
\o \l{Adding Qt Designer Plugins} \o \l{Adding Qt Designer Plugins}
\o \l{Using External Tools} \o \l{Using External Tools}
\o \l{Using the Maemo Emulator} \o \l{Using Maemo or MeeGo Harmattan Emulator}
\o \l{Editing MIME Types} \o \l{Editing MIME Types}
\o \l{Showing Task List Files in the Build Issues Pane} \o \l{Showing Task List Files in the Build Issues Pane}
\o \l{Using Command Line Options} \o \l{Using Command Line Options}