Editing MADDE/QtCreator integration for Mac

Warning: You are not logged in. Your IP address will be recorded in this page's edit history.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Learn more about Contributing to the wiki.

= QtCreator and MADDE on Mac OS X =

This is a guide on how to enable MADDE in QtCreator. This is part of the technology preview. After following this guidance you are able to build your sources within QtCreator for your device, and deploy, run and debug your applications with few mouse clicks from your OS X installation.

Requires:

* [[MADDE]] installed on your Mac
* If you want to compile your code natively then you have to have [http://developer.apple.com/tools/xcode/ XCode] installed on your machine

== Install latest QtCreator on your Mac ==

'''You cannot use the latest official QtCreator for this. The version has to be >= 1.3.80! For these instructions the version of the 2010-03-04 is used!''' Find the latest build of QtCreator for Mac OS X here:

http://qt.nokia.com/developer/qt-snapshots

== Add Qt for Maemo5 ==

You can change the configuration of the Qt-version in your QtCreator installation by clicking:

QtCreator -> Preferences -> Qt4 -> Qt Versions

'''Tip:''' If you do not see any Qt version by default here, you most likely haven't installed the needed Qt libraries to compile your Qt application for your Mac.

In the next step you have to add the Qt version for Maemo5 to the configuration of QtCreator. It is needed to compile your sources for your Maemo device. Click on the "+" in the upper-right corner. The configuration form will ask you to enter a "Version name" and to locate "qmake". You can find it in your MADDE installation folder under:

<MADDE_folder>/targets/<target_name>/bin

For the '''standard installation''' it would be for example:

Version name: Maemo Qt4.5
 qmake Location: /Users/<username>/.madde/0.6.14/targets/fremantle-qt-0951/bin/qmake

'''Tip:''' You cannot find the folder if you click on "Choose...", as it is hidden. But after entering "/Users/<username>/.madde/" in the text-field "qmake Location" you can select the rest via the "Choose..." button.

Now you will see Qt for Maemo as a new Qt Version in Qt Creator. But first you will see the red cross next to the Qt Version in the column "Debugging Helper". The last step you have to do now is clicking on "Rebuild" and after a while (you can follow the status in the QtCreator main window) it should look like this:

[[Image:01_mac_qtcreator_madde.png|500px]]

== Configure device run-time in Qt Creator ==

After setting up the connection between your Mac and your device, you will be able to compile, deploy, test and debug your application with a single mouse-click. The description shows the configuration for USB-networking and WLAN and is for each divided into two parts. It shows:

* what to install on device, and
* how to set-up your Mac

=== General device set-up ===

Please find the instructions on how to set up the device runtime from here:

* [[MADDE/QtCreator_integration_for_windows#Install_the_client | Install the client]]

=== Connect via USB-networking ===

==== Device configuration ====

The following guide shows you, what to do on your device to set up the USB connection. This has to be done '''before''' you connect your device with the Mac:

* [[MADDE/QtCreator_integration_for_windows#Configure_the_client_for_USB | Configure the client for USB networking]]

==== Mac configuration ====

Connect the device with your mac, open the network configurations out of the upcoming dialog and enter the following details. Finally click on "Apply". Then the connection should be established.

[[Image:02_mac_usbnetwork.png|400px]]

'''Possible connection problem:'''

In some versions of Mac OS X ''' < 10.5.8''', the system selects the [http://docwiki.gumstix.org/index.php/Setting_up_USBnet#USBnet_on_Mac_OS_X_10.5.X wrong interface] by default, so that you won't be able to connect your device as a network component with the Mac via USB. OS X detects the N900 in those cases as a modem and not as a network device. Follow these instructions to install the necessary driver information:

http://bugcommunity.com/wiki/index.php/Start_Guide_Mac_OS_X_10.5

After installing the patch, you can connect the device and configure the network interface as shown in the screen-shot above.

=== Connect via WLAN ===

If both devices are connected to the same wireless network the configuration is a bit easier, but be aware that the IP address might not be the same all the time. This effects the set up of your QtCreator configuration.

==== Device configuration ====

Please open the mad-developer application. If you are connected already to the wireless network, you can find the IP address in the initial window of the application:

[[Image:10_mac_mad-dev_wlan.png|300px]]

==== Mac configuration ====

Please just make sure, that your Mac and device are connected to the same network.

=== QtCreator Configuration ===

After the connection between your PC and the device is set up, you can configure QtCreator to deploy and run the built applications on device. You can add your device in the configuration. You will find it in:

QtCreator -> Preferences -> Qt4 -> Maemo Device Configurations

First get the password from the Mad Developer application. You get it by clicking on "Developer Password" in the main view. '''Be aware''' that each time you click on the button, a new password will be created and that the password is only valid for the time it is shown in the application.

[[Image:04_b_client_ready.png|300px]] [[Image:05_client_pw.png|300px]]

====Instructions for USB-network====

Add the password and all the data you see in the screenshot below. Check the box, that you want to use the password as the authentication method. After that click on "test" and see if the connection can be set up.

[[Image:03_mac_qtcreator_usbnetwork.png|300px]]

====Instructions for WLAN====

If your device is using the WLAN interface, please enter the IP address you can see in the mad-developer application on device.

[[Image:04_mac_qtcreator_wlan.png|300px]]

'''Tip''' You can use your ssh key for the connection. Click on "Deploy Key ..." and select your key. If the other settings are correct the key will be automatically deployed on your device, so that you don't have to worry about the passwords anymore.

== Use Maemo5 build settings ==

Now all the configuration is done and you can select Maemo as a build configuration. If you have a project, which you want to compile for Maemo, then click on the project button in the menu of the left side. Now you should seen a screen, like in the screen shot below. If you have the Qt libraries installed, then you will have the "Desktop" as the default option selected.

[[Image:06_mac_qtcreator_init.png]]

'''Tip:'''

* It might be that you don't see the "Desktop" widget in your project configuration. In this case it might be that the configuration of the MADDE is not correct, or that a little bug prevents the widget from showing up. In this case click on "Dependencies" and then go back to "Build".

* If you start a new project you can add the Maemo build-configuration at the beginning:

:[[Image:05_mac_qtcreator_select_madde.png|300px]]

Now press the plus in the widget, which shows, that "Desktop" is selected as default. This should open a new dialog, where you select "Maemo Device". After that you will find a new build-configuration:

[[Image:07_mac_qtcreator_maemo_build.png]]

Now click there on "Run" and select your device, which you have configured before. In the example it was called Maemo5 Device.

[[Image:08_mac_qtcreator_maemo_run.png]]

Finally you can now set in the down left corner, which build configuration you want to use:

[[Image:09_mac_qtcreator_final.png]]

Now you can click on the run button, and your application will be automatically compiled for the Maemo device, delpoyed, and started.

[[Category:Development]]

Please note that all contributions to maemo.org wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see maemo.org wiki:Copyrights for details). Do not submit copyrighted work without permission!

Summary:

Cancel | Editing help (opens in new window)

Templates used on this page:

Template:Ambox (view source) (semi-protected)
Template:MADDE (edit)

Retrieved from "https://wiki.maemo.org/MADDE/QtCreator_integration_for_Mac"

Personal tools

Navigation

Views

Editing MADDE/QtCreator integration for Mac

@@ Line 112: / Line 112: @@
 After the connection between your PC and the device is set up, you can configure QtCreator to deploy and run the built applications on device. You can add your device in the configuration. You will find it in:
-  QtCreator -> Preferences -> Projects -> Maemo Device Configurations
+  QtCreator -> Preferences -> Qt4 -> Maemo Device Configurations
@@ Line 135: / Line 135: @@
 '''Tip''' You can use your ssh key for the connection. Click on "Deploy Key ..." and select your key. If the other settings are correct the key will be automatically deployed on your device, so that you don't have to worry about the passwords anymore.
 == Use Maemo5 build settings ==