|
|
| (7 intermediate revisions not shown) |
| Line 1: |
Line 1: |
| | This document describes how to configure Qt Creator to use the MeeGo toolchain. | | This document describes how to configure Qt Creator to use the MeeGo toolchain. |
| | | | |
| - | <h2>1. Configuring Qt Creator to use the MeeGo toolchain</h2>
| + | == Create a MeeGo touch project == |
| - | <ul>
| + | |
| - | <li>Start Qt Creator by selecting Applications > Programming > Qt Creator. </li>
| + | |
| - | <li>Configure Qt Creator to use MeeGo toolchain:
| + | |
| - | <ol>
| + | |
| - | <li>Go to Tools > Options > Qt4 > Qt Versions.
| + | |
| - | <li>On the right side of the Qt Versions view, click on the plus sign button to add a new version.
| + | |
| - | A blank, new version appears in the Qt Versions view.
| + | |
| - | <li>On the Version Name line, specify a name for the new version.
| + | |
| - | <li>On the qmake location line, specify a qmake location for the new version. The toolchain installs by default to usr/lib/madde/linux-i686/targets/<target>/bin/qmake.
| + | |
| - | <li>Click Rebuild, Apply and OK. <br />
| + | |
| - | <img src="https://otcshare.org/meego-tablet/system/files/qtcreator_sysroot_options.png" width=650 alt="Qt Creator - sysroot option"/>
| + | |
| - | </ol>
| + | |
| - | </li>
| + | |
| - | </ul>
| + | |
| | | | |
| - | <h2>2. Create a MeeGo touch project </h2>
| |
| | <ul> | | <ul> |
| | <li>Go to the menu: File > New File or Project > Qt Application Project > Meego Touch Framework Application. </li> | | <li>Go to the menu: File > New File or Project > Qt Application Project > Meego Touch Framework Application. </li> |
| - | <li>At the end of project creation, you will see the "Project setup" dialog. Choose the MeeGo toolchain you configured. <br /> | + | [[File:Qtcreator-mtf.png]] |
| - | <img src="https://otcshare.org/meego-tablet/system/files/qtcreator_mtf.png" width=650 alt="Qt Creator - create MTF application"/>
| + | <li>At the end of project creation, you will see the "Project setup" dialog. Choose a MeeGo QtVersion (The same of the QtVersion is the same as the target you selected during installing MeeGo SDK). <br /> |
| | + | [[File:Project-select-QtVersion.png]] |
| | </li> | | </li> |
| | </ul> | | </ul> |
| | | | |
| - | <h2>3. Build configuration of MeeGo project</h2>
| + | == Build, run and deploy the application== |
| - | <ul>
| + | |
| - | <li>Click the "Projects" icon on the left of Qt Creator. The "MeeGo" build and run configuration page will be shown. </li>
| + | |
| - | <li>Create a new build configuration by selecting the "Add" drop-down button and selecting the MeeGo toolchain you configured above.<br />
| + | |
| - | <img src="https://otcshare.org/meego-tablet/system/files/qtcreator_choose_sysroot.png" width=650 alt="Qt Creator - choose sysroot"/>
| + | |
| - | </li>
| + | |
| - | </ul>
| + | |
| | | | |
| - | <h2>4. Configuring device access in Qt Creator</h2>
| + | * First launch the QEMU MeeGo emulator. Click the "Start Meego emulator" icon near the bottom left corner of Qt Creator:<br />[[File:Start_qemu.png]] |
| - | Configuring device access in Qt Creator is slightly different depending on whether you are deploying to a real device or an emulated one.
| + | * Click the "Run" icon to run your application. Qt Creator will package and deploy your application to QEMU or tablet device and start it on the target. |
| | + | * You can see the window of your application in QEMU or tablet device.<br />[[File:Tablet-run-app.png]] |
| | | | |
| - | However, the mode of access is the same: Qt Creator deploys and installs an .rpm package on the device, and runs the executable.
| + | == Debug the application == |
| | | | |
| - | For instructions on configuring device access, see: | + | * You can debug the application by clicking the "Debug" icon. |
| | + | * You can also set breakpoints and step the same as local applications. |
| | + | * For more information on debugging, see [[SDK/Docs/1.1/Debugging with Qt Creator|Debugging with Qt Creator]] |
| | | | |
| - | <ul>
| + | == Known Issues == |
| - | <li> <a href="https://otcshare.org/meego-tablet/node/592">Configure Qt Creator for MeeGo emulator </a> </li>
| + | |
| - | <li> <a href="https://otcshare.org/meego-tablet/node/591">Configure Qt Creator for MeeGo device</a></li>
| + | |
| - | </ul>
| + | |
| | | | |
| - | <h2>5. Set Run Configuration</h2>
| + | * For QEMU, it is important to check your graphics capability. See [[SDK/Docs/1.1/MeeGo SDK Graphics Acceleration|SDK Graphics Acceleration]] |
| - | <ul>
| + | |
| - | <li>Click "Projects" again on the left side. Select "Run" in the MeeGo Build/Run box at the top. If the "Device configuration" is set to "MeeGo tablet emulator". This will ensure that QEMU is started when you run your application. </li>
| + | |
| - | <li>You can now launch the QEMU MeeGo emulator. Click the "Start Meego emulator" icon near the bottom left corner of Qt Creator <br />
| + | |
| - | <img src="https://otcshare.org/meego-tablet/system/files/qtcreator_runtime_configure.png" width=650 alt="Qt Creator - choose runtime option"/>
| + | |
| - | </li>
| + | |
| - | <li>if the "Device configuration" is set to "real device". This will ensure the application run in the tablet device.
| + | |
| - | </li>
| + | |
| - | </ul>
| + | |
| | | | |
| - | <h2>6. Build, run and deploy the application</h2>
| + | [[Category:SDK]] |
| - | <ul>
| + | [[Category:Meego-1.2]] |
| - | <li> Click the "Run" icon to run your application. Qt Creator will package and deploy your application to QEMU or tablet device and start it on the target. </li>
| + | [[Category:Linux]] |
| - | <li>You can see the window of your application in QEMU or tablet device. <br />
| + | |
| - | <img src="ttps://otcshare.org/meego-tablet/system/files/meego_emulator_mtf.png" width=650 alt="MeeGo emulator - MTF sample"/>
| + | |
| - | </li>
| + | |
| - | </ul>
| + | |
| - | | + | |
| - | <h2>7. Debug the application</h2>
| + | |
| - | <ul>
| + | |
| - | <li>You can debug the application by clicking the "Debug" icon. </li>
| + | |
| - | <li>You can also set breakpoints and step the same as local applications.<br />
| + | |
| - | <img src="https://otcshare.org/meego-tablet/system/files/qtcreator_debug.png" width=650 alt="Qt Creator - debug application"/>
| + | |
| - | </li>
| + | |
| - | <li>For more information on debugging, see <a href="http://wiki.meego.com/SDK/Docs/1.1/Debugging_with_Qt_Creator">Debugging with Qt Creator </a></li>
| + | |
| - | </ul>
| + | |
| - | | + | |
| - | <h1>Known Issues</h1>
| + | |
| - | <ul>
| + | |
| - | <li> The meegotouch development library has a bug which makes it conflict with the host Qt library. If you have installed another Qt library, you have to move the Qt libraries in /usr/lib to other place:
| + | |
| - | <code>
| + | |
| - | # sudo mkdir /usr/lib/qtbak
| + | |
| - | # sudo mv /usr/lib/libQt* /usr/lib/qtbak
| + | |
| - | </code>
| + | |
| - | </li>
| + | |
| - | <li> Qt application can be built & deployed to the emulator, but it cannot be shown correctly. Only a black screen.
| + | |
| - | </li>
| + | |
| - | <li>For QEMU, it is important to check your graphics capability. See <a href="https://otcshare.org/meego-tablet/node/586">SDK Graphics Acceleration</a>
| + | |
| - | </li>
| + | |
| - | </ul>
| + | |
This document describes how to configure Qt Creator to use the MeeGo toolchain.