Meego Wiki
Views

SDK/Setup/Debugging MeeGo Applications

From MeeGo wiki
< SDK(Difference between revisions)
Jump to: navigation, search
(categorise)
 
(6 intermediate revisions not shown)
Line 1: Line 1:
-
==== ====
 
In Qt Creator you setup MeeGo device configurations to deploy your application to either a real hardware device or to a virtual machine, such as QEMU, running on your host.  Qt Creator treats these configurations in the same way.  When you start to debug your application Qt Creator will package your applications as an RPM, deploy it to the device you've selected in your project settings, install it, and run the executable.  The mad-developer package must be installed on the target OS.
In Qt Creator you setup MeeGo device configurations to deploy your application to either a real hardware device or to a virtual machine, such as QEMU, running on your host.  Qt Creator treats these configurations in the same way.  When you start to debug your application Qt Creator will package your applications as an RPM, deploy it to the device you've selected in your project settings, install it, and run the executable.  The mad-developer package must be installed on the target OS.
-
The developer follows these steps:
+
=== Create a MeeGo Device Configuration ===
-
<ol>
+
-
<li>Create one or more MeeGo Device Configurations</li>
+
-
<li>Select one of the configurations for the current project</li>
+
-
<li>Start the device (boot the hardware or virtual machine)</li>
+
-
<li>Start debugging the application.  Qt Creator deploys and starts the application on the remote system or virtual machine</li>
+
-
</ol>
+
-
 
+
-
=== 1. Create MeeGo Device Configurations ===
+
Open ''Tools'' > ''Options'' > ''Projects'' > ''MeeGo Device Configurations''
Open ''Tools'' > ''Options'' > ''Projects'' > ''MeeGo Device Configurations''
-
 
<table>
<table>
  <tr><td valign="top">
  <tr><td valign="top">
-
'''Create a QEMU virtual machine device configuration:'''
+
'''Create a hardware device configuration:'''
# In the dialog box, create a new Device Configuration by clicking on '''Add'''.
# In the dialog box, create a new Device Configuration by clicking on '''Add'''.
# Give the new Device Configuration a name in the Configuration Name text field, and add the following settings in the other test fields:
# Give the new Device Configuration a name in the Configuration Name text field, and add the following settings in the other test fields:
-
#* Device type: choose MeeGo emulator
+
#* Device type: Remote device
#* Authentication type: Password
#* Authentication type: Password
-
#* Host name: 127.0.0.1
+
#* Host name: <IP Address of remote device>
#* Ports, SSH: 6666
#* Ports, SSH: 6666
#*: Note that the emulator is setup with a redirect from port 6666 on localhost to the SSH port (22) of the emulated device.
#*: Note that the emulator is setup with a redirect from port 6666 on localhost to the SSH port (22) of the emulated device.
#* Ports, Gdb Server: 13219 (the default)
#* Ports, Gdb Server: 13219 (the default)
#: '''Note:''' If this port is not free, you can select another one.
#: '''Note:''' If this port is not free, you can select another one.
-
#* Connection Timeout: 30s
+
#* Connection Timeout: 30
#* User Name: root
#* User Name: root
#* Password: meego
#* Password: meego
# Click '''Apply'''
# Click '''Apply'''
-
  </td>
+
  </td>
-
  <td>[[File:sdk-docs-QtCreator-configuring-emulator-access.png|thumb|500px]]</td>
+
  <td valign="top">[[File:Qt-config-device-config.jpg|thumb|500px]]</td>
  </tr>
  </tr>
</table>
</table>
<table>
<table>
-
  <tr><td>
+
  <tr><td valign="top">
-
'''Create a hardware device configuration:'''
+
'''Create a QEMU virtual machine device configuration:'''
# In the dialog box, create a new Device Configuration by clicking on '''Add'''.
# In the dialog box, create a new Device Configuration by clicking on '''Add'''.
# Give the new Device Configuration a name in the Configuration Name text field, and add the following settings in the other test fields:
# Give the new Device Configuration a name in the Configuration Name text field, and add the following settings in the other test fields:
-
#* Device type: choose MeeGo emulator
+
#* Device type: MeeGo emulator
#* Authentication type: Password
#* Authentication type: Password
#* Host name: 127.0.0.1
#* Host name: 127.0.0.1
Line 45: Line 35:
#* Ports, Gdb Server: 13219 (the default)
#* Ports, Gdb Server: 13219 (the default)
#: '''Note:''' If this port is not free, you can select another one.
#: '''Note:''' If this port is not free, you can select another one.
-
#* Connection Timeout: 30
+
#* Connection Timeout: 30s
#* User Name: root
#* User Name: root
#* Password: meego
#* Password: meego
# Click '''Apply'''
# Click '''Apply'''
-
  </td>
+
  </td>
-
  <td>[[File:Qt-config-device-config.jpg|thumb|500px]]</td>
+
  <td valign="top">[[File:sdk-docs-QtCreator-configuring-emulator-access.png|thumb|500px]]</td>
  </tr>
  </tr>
</table>
</table>
-
'''Test the settings'''
+
'''Test the settings''' <br>
-
# To test the settings, ensure that the emulated device is running, then click '''Test'''.
+
To test the settings, ensure that the emulated device is running, then click '''Test'''.
-
#: If successful, you'll see a dialog box with the message "Device configuration successful".
+
If successful, you'll see a dialog box with the message "Device configuration successful".
-
#: If the message "Could not connect to host" is displayed, check your setting selections and make sure that the network is connected.
+
If the message "Could not connect to host" is displayed, check your setting selections and make sure that the network is connected.
 +
 
 +
=== Set Run Configuration ===
 +
Click "Projects" on the left side. Select "Run" in the MeeGo Build/Run box at the top.
 +
Set the "Deploy to device" to the configuration created in the previous step.
 +
 
 +
=== Start the device (boot the hardware or virtual machine) ===
 +
If you are debugging with a remote device, boot the device.
 +
If you are debugging with QEMU VM, start the virtual machine.  You can do this from Qt Creator by clicking the "Start MeeGo Emulator" icon near the bottom left corner of the IDE.
-
=== 2. Select one of the configurations for the current project ===
+
=== (Optional) Set breakpoints in your code ===
 +
It is easy to create breakpoints by clicking to the left of the line you wish to break on.
 +
[[File:Qt-config-breakpoint.jpg]]
-
=== 3. Start the device (boot the hardware or virtual machine) ===
+
=== Start debugging the application ===
 +
Click the "Run" or "Debug" icon to start your application. Qt Creator will package and deploy your application to QEMU or tablet device and start it on the target.  Your application UI should appear on the remote device or virtual machine.  The IDE will change to debug mode where you can view variables and software stack.  You can view/step-through the code in the IDE while your application runs on the remote device or virtual machine.
-
=== 4. Start debugging the application ===
+
[[Category:SDK]]
 +
[[Category:Tutorial]]

Latest revision as of 13:32, 12 April 2011

In Qt Creator you setup MeeGo device configurations to deploy your application to either a real hardware device or to a virtual machine, such as QEMU, running on your host. Qt Creator treats these configurations in the same way. When you start to debug your application Qt Creator will package your applications as an RPM, deploy it to the device you've selected in your project settings, install it, and run the executable. The mad-developer package must be installed on the target OS.

Contents

Create a MeeGo Device Configuration

Open Tools > Options > Projects > MeeGo Device Configurations

Create a hardware device configuration:

  1. In the dialog box, create a new Device Configuration by clicking on Add.
  2. Give the new Device Configuration a name in the Configuration Name text field, and add the following settings in the other test fields:
    • Device type: Remote device
    • Authentication type: Password
    • Host name: <IP Address of remote device>
    • Ports, SSH: 6666
      Note that the emulator is setup with a redirect from port 6666 on localhost to the SSH port (22) of the emulated device.
    • Ports, Gdb Server: 13219 (the default)
    Note: If this port is not free, you can select another one.
    • Connection Timeout: 30
    • User Name: root
    • Password: meego
  3. Click Apply
Qt-config-device-config.jpg

Create a QEMU virtual machine device configuration:

  1. In the dialog box, create a new Device Configuration by clicking on Add.
  2. Give the new Device Configuration a name in the Configuration Name text field, and add the following settings in the other test fields:
    • Device type: MeeGo emulator
    • Authentication type: Password
    • Host name: 127.0.0.1
    • Ports, SSH: 6666
      Note that the emulator is setup with a redirect from port 6666 on localhost to the SSH port (22) of the emulated device.
    • Ports, Gdb Server: 13219 (the default)
    Note: If this port is not free, you can select another one.
    • Connection Timeout: 30s
    • User Name: root
    • Password: meego
  3. Click Apply
Sdk-docs-QtCreator-configuring-emulator-access.png

Test the settings
To test the settings, ensure that the emulated device is running, then click Test. If successful, you'll see a dialog box with the message "Device configuration successful". If the message "Could not connect to host" is displayed, check your setting selections and make sure that the network is connected.

Set Run Configuration

Click "Projects" on the left side. Select "Run" in the MeeGo Build/Run box at the top. Set the "Deploy to device" to the configuration created in the previous step.

Start the device (boot the hardware or virtual machine)

If you are debugging with a remote device, boot the device. If you are debugging with QEMU VM, start the virtual machine. You can do this from Qt Creator by clicking the "Start MeeGo Emulator" icon near the bottom left corner of the IDE.

(Optional) Set breakpoints in your code

It is easy to create breakpoints by clicking to the left of the line you wish to break on. Qt-config-breakpoint.jpg

Start debugging the application

Click the "Run" or "Debug" icon to start your application. Qt Creator will package and deploy your application to QEMU or tablet device and start it on the target. Your application UI should appear on the remote device or virtual machine. The IDE will change to debug mode where you can view variables and software stack. You can view/step-through the code in the IDE while your application runs on the remote device or virtual machine.

Personal tools