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

Doc: update info about Linux-based devices

Browse Source 
Add info about the kits. Fix changed field names.

Change-Id: Ic8d10e17d3cef4082c0a151d15bfe8da14e7ad66
Reviewed-by: Christian Kandeler <christian.kandeler@nokia.com>
This commit is contained in:
Leena Miettinen
2012-09-07 12:52:54 +02:00
parent 5f03803cf8
commit fdd4a81542
12 changed files with 111 additions and 91 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
doc/images/qtcreator-dev-conf-maemo.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 6.9 KiB

After

Width:  |  Height:  |  Size: 6.3 KiB

BIN
doc/images/qtcreator-linux-device-configurations.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 14 KiB

BIN
doc/images/qtcreator-maemo-device-configurations.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 14 KiB

BIN
doc/images/qtcreator-maemo-emulator-connection.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 7.0 KiB

BIN
doc/images/qtcreator-meego-device-configurations.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 14 KiB

BIN
doc/images/qtcreator-meego-emulator-connection.png
View File

Binary file not shown.
Side by Side

Before

Width:  |  Height:  |  Size: 7.1 KiB

BIN
doc/images/qtcreator-screenshot-devconf.png
View File

Binary file not shown.
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 7.2 KiB

After

Width:  |  Height:  |  Size: 6.3 KiB

3
doc/src/linux-mobile/linuxdev-keys.qdocinc
View File

@@ -10,8 +10,7 @@
\list 1 \list 1
\o Select \gui {Tools > Options > Linux Devices > Device \o Select \gui Tools > \gui Options > \gui Devices > \gui {Create New}.
Configurations > Generate SSH Key}.
\image qtcreator-ssh-key-configuration.png "SSH Key Configuration dialog" \image qtcreator-ssh-key-configuration.png "SSH Key Configuration dialog"

7
doc/src/linux-mobile/linuxdev-processes.qdocinc
View File

@@ -1,13 +1,12 @@
\section2 Managing Device Processes \section2 Managing Device Processes
You can view processes running on devices and kill them. Select You can view processes running on devices and kill them. Select
\gui {Tools > Options > Linux Devices > Device Configurations > \gui Tools > \gui Options > \gui Devices > \gui {Remote Processes}.
Remote Processes}.
You can filter the processes by name in the \gui {List of Remote Processes} You can filter the processes by name in the \gui {List of Processes}
dialog. dialog.
To update the process list, select \gui {Update List}. To update the process list, select \gui {Update List}.
To kill a process, select it in the list, and then select \gui {Kill To kill a process, select it in the list, and then select \gui {Kill
Selected Process}. Process}.

13
doc/src/linux-mobile/linuxdev.qdoc
View File

@@ -39,7 +39,7 @@
create device configurations and select them in the \QC \l{glossary-buildandrun-kit}{kit} create device configurations and select them in the \QC \l{glossary-buildandrun-kit}{kit}
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
in \gui {Tools > Options > Devices > Devices}. in \gui Tools > \gui Options > \gui Devices.
\image qtcreator-linux-device-configurations.png "Devices dialog" \image qtcreator-linux-device-configurations.png "Devices dialog"
@@ -67,8 +67,8 @@
\list 1 \list 1
\o Select \gui {Tools > Options > Linux Devices > Devices > Add \o Select \gui Tools > \gui Options > \gui Devices > \gui Add
> Generic Linux Device > Start Wizard}. > \gui {Generic Linux Device} > \gui {Start Wizard}.
\image qtcreator-screenshot-devconf-linux.png "Connection Data wizard" \image qtcreator-screenshot-devconf-linux.png "Connection Data wizard"
@@ -103,13 +103,12 @@
\o Open a project for an application you want to develop for the \o Open a project for an application you want to develop for the
device. device.
\o Select \gui {Projects > Build & Run Settings > Add Kit}. \o Select \gui Projects > \gui {Build & Run} > \gui {Add Kit} to
add the kit that you specified above.
\o Select the kit that you added above.
\endlist \endlist
\o To specify run settings, select \gui Run. \o Select \gui Run to specify run settings.
\image qtcreator-run-settings-linux-devices.png "Run settings for embedded Linux devices" \image qtcreator-run-settings-linux-devices.png "Run settings for embedded Linux devices"

91
doc/src/linux-mobile/maemodev.qdoc
View File

@@ -48,7 +48,7 @@
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}.
\section1 Hardware and Software Requirements for Maemo Target \section1 Hardware and Software Requirements for Maemo Devices
To build and run Qt applications for Maemo 5, you need the following: To build and run Qt applications for Maemo 5, you need the following:
\list \list
@@ -222,7 +222,7 @@
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
in \gui {Tools > Options > Linux Devices > Device Configurations}. in \gui Tools > \gui Options > \gui Devices.
\image qtcreator-maemo-device-configurations.png "Maemo Device Configurations dialog" \image qtcreator-maemo-device-configurations.png "Maemo Device Configurations dialog"
@@ -282,21 +282,15 @@
\note If you experience connection problems due to a USB port issue, \note If you experience connection problems due to a USB port issue,
switch to a different port or use WLAN to connect to the device. switch to a different port or use WLAN to connect to the device.
\o Select \gui {Tools > Options > Linux Devices > Device \o Select \gui Tools > \gui Options > \gui Devices > \gui Add.
Configurations > Add}.
\o Select \gui {Device with MADDE support (Fremantle, Harmattan, \o Select \gui {Maemo5/Fremantle} > \gui {Start Wizard}.
MeeGo) > Start Wizard}, and add a new configuration for a
hardware device.
\image qtcreator-dev-conf-maemo.png "Maemo device configuration" \image qtcreator-dev-conf-maemo.png "Maemo device configuration"
\o In the \gui {The name to identify this configuration} field, \o In the \gui {The name to identify this configuration} field,
enter a name for the connection. enter a name for the connection.
\o In the \gui {The system running on the device} field, select
the software platform of the device.
\o In the \gui {The kind of device} field, select \o In the \gui {The kind of device} field, select
\gui {Hardware device}. \gui {Hardware device}.
@@ -321,21 +315,11 @@
\list a \list a
\o In \QC, select \gui {Tools > Options > Linux \o In \QC, select \gui Tools > \gui Options > \gui Devices >
Devices > Device Configurations > Add} to add a new \gui Add to add a new configuration.
configuration.
\image qtcreator-maemo-emulator-connection.png "Maemo emulator configuration"
\o In the \gui {The name to identify this configuration} field,
enter a name for
the connection.
\o In the \gui {The system running on the device} field, select
the software platform to emulate.
\o In the \gui {The kind of device} field, select \o In the \gui {The kind of device} field, select
\gui {Emulator (Qemu)}. \gui Emulator.
\o Click \gui Next. \o Click \gui Next.
@@ -345,30 +329,56 @@
\endlist \endlist
\endif \endif
\o To specify build and run settings: \o Select \gui Tools > \gui Options > \gui {Build & Run} >
\gui Kits > \gui Add to add a kit for building for the device:
\list a \list a
\o In the \gui {Device type} field, select
\gui {Maemo5/Fremantle}.
\o In the \gui Device field, select the device that you added
above.
\o In the \gui Sysroot field, specify the path to the sysroot.
By default, the \QSDK installer places sysroot in the
following folder:
\c{QtSDK\Maemo\4.6.2\sysroots\fremantle-arm-sysroot-20.2010.36-2-slim}.
\o In the \gui {Compiler type} field, select GCC.
\o In the \gui Compiler field, specify the path to the GCC
compiler. By default, the \QSDK installer places the
compiler in the following folder:
\c{QtSDK\Maemo\4.6.2\targets\fremantle-pr13\bin\}.
\o In the \gui Debugger field, specify the path to GDB. By
default, the \QSDK installer places the debugger
in the following folder:
\c{QtSDK\Maemo\4.6.2\targets\fremantle-pr13\bin\}.
\o In the \gui {Qt version} field, choose the MADDE Qt version
for Maemo5/Fremantle. By default, the \QSDK installer
places qmake in the following folder:
\c{QtSDK\Maemo\4.6.2\targets\fremantle-pr13\bin\}.
\endlist
You can leave the \gui {Qt mkspec} field empty.
\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
device. device.
\o Click \gui Projects to open the projects mode. \o Select \gui Projects > \gui {Build & Run} > \gui {Add Kit} to
add the kit that you specified above.
\o In the \gui{Build Settings} section, choose the MADDE Qt version \o Select \gui Run to specify run settings for the project.
that was registered by the installation program.
\image qtcreator-build-settings-maemo.png "Maemo build settings" \o The mobile application wizard automatically sets the folder
where the file is installed on the device in the \gui {Remote
\o In the \gui{Run Settings} section, in the Directory} field. For example, \c {/opt/usr/bin}. If the text
\gui {Device configuration} field, select the device \gui {<no target path set>} is displayed, click it to specify a
connection or the emulator connection. folder.
\image qtcreator-run-settings-maemo.png "Maemo run settings"
\o Click \gui {<no target path set>} in \gui {Remote Directory}
to specify the folder where the file is installed on the device.
For example, \c {/opt/usr/bin}.
\endlist
\endlist \endlist
@@ -386,8 +396,7 @@
\o To specify the password, enter the following command: \o To specify the password, enter the following command:
\c{/usr/lib/mad-developer/devrootsh passwd user} \c{/usr/lib/mad-developer/devrootsh passwd user}
\o In \QC, select \gui {Tools > Options Linux Devices > \o In \QC, select \gui Tools > \gui Options > \gui Devices.
Device Configurations}.
\o Specify the username \c user and the password in the device \o Specify the username \c user and the password in the device
configuration. configuration.

84
doc/src/linux-mobile/meegodev.qdoc
View File

@@ -235,7 +235,7 @@
device. 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
in \gui {Tools > Options > Linux Devices > Device Configurations}. in \gui Tools > \gui Options > \gui Devices.
\image qtcreator-meego-device-configurations.png "MeeGo Device Configurations dialog" \image qtcreator-meego-device-configurations.png "MeeGo Device Configurations dialog"
@@ -294,21 +294,16 @@
port issue, switch to a different port or use WLAN to port issue, switch to a different port or use WLAN to
connect to the device. connect to the device.
\o Select \gui {Tools > Options > Linux Devices > Device \o Select \gui Tools > \gui Options > \gui Devices > \gui Add.
Configurations > Add}.
\o Select \gui {Device with MADDE support (Fremantle, Harmattan, \o Select \gui {MeeGo 1.2 Harmattan} > \gui {Start Wizard} to
MeeGo) > Start Wizard}, and add a new configuration for a add a new configuration for a device.
hardware device.
\image qtcreator-screenshot-devconf.png \image qtcreator-screenshot-devconf.png
\o In the \gui {The name to identify this configuration} field, \o In the \gui {The name to identify this configuration} field,
enter a name for the connection. enter a name for the connection.
\o In the \gui {The system running on the device} field, select
the software platform of the device.
\o In the \gui {The kind of device} field, select \o In the \gui {The kind of device} field, select
\gui {Hardware device}. \gui {Hardware device}.
@@ -322,7 +317,7 @@
\o Click \gui Next. \o Click \gui Next.
\o Follow the instructions of the wizard to create the \o Follow the instructions of the wizard to create the
connection. configuration.
\endlist \endlist
@@ -335,20 +330,16 @@
\list a \list a
\o In \QC, select \gui {Tools > Options > Linux \o In \QC, select \gui Tools > \gui Options > \gui Devices >
Devices > Device Configurations > Add} to add a new \gui Add to add a new configuration.
configuration.
\image qtcreator-meego-emulator-connection.png \o Select \gui {MeeGo 1.2 Harmattan} > \gui {Start Wizard}.
\o In the \gui {The name to identify this configuration} field, \o In the \gui {The name to identify this configuration} field,
enter a name for the connection. enter a name for the connection.
\o In the \gui {The system running on the device} field, select
the software platform to emulate.
\o In the \gui {The kind of device} field, select \o In the \gui {The kind of device} field, select
\gui {Emulator (Qemu)}. \gui Emulator.
\o Click \gui Next. \o Click \gui Next.
@@ -356,35 +347,59 @@
connection. connection.
SDK Connectivity is not needed for emulator connections, and SDK Connectivity is not needed for emulator connections, and
therefore, you do nt need to authenticate the emulator therefore, you do not need to authenticate the emulator
connection. connection.
\endlist \endlist
\endif \endif
\o To specify build and run settings: \o Select \gui Tools > \gui Options > \gui {Build & Run} >
\gui Kits > \gui Add to add a kit for building for the device:
\list a \list a
\o In the \gui {Device type} field, select
\gui {MeeGo 1.2 Harmattan}.
\o In the \gui Device field, select the device that you added
above.
\o In the \gui Sysroot field, specify the path to the sysroot.
By default, the \QSDK installer places sysroot in the
following folder:
\c{QtSDK\Madde\bin\sysroots\harmattan_sysroot_10.2011.34-1_slim}.
\o In the \gui {Compiler type} field, select GCC.
\o In the \gui Compiler field, specify the path to the GCC
compiler. By default, the \QSDK installer places the
compiler in the following folder:
\c{QtSDK\Madde\targets\harmattan_10.2011.34-1_rt1.2\bin\}.
\o In the \gui Debugger field, specify the path to GDB. By
default, the \QSDK installer places the debugger
in the following folder:
\c{QtSDK\Madde\targets\harmattan_10.2011.34-1_rt1.2\bin\}.
\o In the \gui {Qt version} field, choose the MADDE Qt version
for MeeGo 1.2 Harmattan. By default, the \QSDK installer
places qmake in the following folder:
\c{QtSDK\Madde\targets\harmattan_10.2011.34-1_rt1.2\bin\}.
\endlist
You can leave the \gui {Qt mkspec} field empty.
\o Open a project for an application you want to develop \o Open a project for an application you want to develop
for your device. for your device.
\o Click \gui Projects to open the projects mode. \o Select \gui Projects > \gui {Build & Run} > \gui {Add Kit} to
add the kit that you specified above.
\o In the \gui{Build Settings} section, choose the MADDE Qt \o Select \gui Run to specify run settings for the project.
version that was registered by the installation program.
\image qtcreator-screenshot-build-settings.png \o The Qt Quick project wizards automatically set the folder
\o In the \gui {Run Settings} section,
\gui {Device configuration} field, select the
device connection or the emulator connection.
\image qtcreator-screenshot-run-settings.png
\endlist
\note The new application wizards automatically set the folder
where the file is installed on the device in the \gui {Remote where the file is installed on the device in the \gui {Remote
Directory} field. For example, \c {/opt/usr/bin}. If the text Directory} field. For example, \c {/opt/usr/bin}. If the text
\gui {<no target path set>} is displayed, click it to specify a \gui {<no target path set>} is displayed, click it to specify a
@@ -408,8 +423,7 @@
\o To specify the password, enter the following command: \o To specify the password, enter the following command:
\c{/usr/lib/mad-developer/devrootsh passwd user} \c{/usr/lib/mad-developer/devrootsh passwd user}
\o In \QC, select \gui {Tools > Options Linux Devices > \o In \QC, select \gui Tools > \gui Options > \gui Devices.
Device Configurations}.
\o Specify the username \c user and the password in the device \o Specify the username \c user and the password in the device
configuration. configuration.