|
|
| (41 intermediate revisions not shown) |
| Line 1: |
Line 1: |
| - | '''Note: This page contains instructions on install MeeGo SDK for Windows, and use it to build/deploy/debug apps.
| + | #REDIRECT [[SDK/Docs/1.1/Getting started with the MeeGo SDK for Windows]] |
| - | | + | |
| - | ==How to report bugs==
| + | |
| - | * URL: http://bugs.meego.com .
| + | |
| - | * Product name: MeeGo SDK
| + | |
| - | * Bug summary: Please have "[Windows]" in the begining of your bug summary.
| + | |
| - | | + | |
| - | ==System Requirement==
| + | |
| - | | + | |
| - | *Windows XP and Windows 7 are officially supported by MeeGo SDK. MeeGo SDK may work on Windows Vista, but it is not officially supported.
| + | |
| - | *Emulator can only work with 32-bit Windows. If you are using 64-bit Windows, you cannot use emulator.
| + | |
| - | | + | |
| - | ==Known issues and possible workarounds==
| + | |
| - | | + | |
| - | * Currently the emulator is for IA target only.
| + | |
| - | * MeeGo SDK ships Qt 4.7.0 within it, and Qt will always be installed to C:\Qt\4.7.0. This means:
| + | |
| - | ** MeeGo SDK cannot be installed to a system without disk "C".
| + | |
| - | ** Your selection for the install directory will only take effect to other parts of MeeGo SDK.
| + | |
| - | * You should better install MeeGo SDK to disk "C", as a workaround for bug #8926.
| + | |
| - | | + | |
| - | == Setup MeeGo SDK ==
| + | |
| - | | + | |
| - | <ol>
| + | |
| - | | + | |
| - | | + | |
| - | <li>Download MeeGo SDK installer. You can choose either offline or online installer:</li>
| + | |
| - | <table border='1' cellpadding='3px' style="padding: 0em">
| + | |
| - | <tr><th>File</th><th>Description</th><th>Size</th></tr>
| + | |
| - | <tr><td>N/A</td>
| + | |
| - | <td>MeeGo SDK Windows online installer</td>
| + | |
| - | <td>13.1MB</td>
| + | |
| - | </tr>
| + | |
| - | <tr><td> ftp://ftp.intel.com/pub/outgoing/meego-sdk-installer-1026.exe (external)<br>http://osve-files.sh.intel.com/pub/misc/sdk/meego-sdk-installer-1026.exe (Intel internal)</td>
| + | |
| - | <td>MeeGo SDK Windows offline installer</td>
| + | |
| - | <td>1.4GB</td>
| + | |
| - | </tr>
| + | |
| - | </table>
| + | |
| - | <li>After installation, go to Start->Programs->MeeGo SDK->QtCreator to launch QtCreator</li>
| + | |
| - | <li> '''Configure Qt Creator to support MeeGo sysroot''' </li>
| + | |
| - | Go to the menu: Tools -> Options -> Qt4 -> Qt Versions.<br\>
| + | |
| - | Click the "+" button, and then fill the "Version name" and the "qmake location" of MeeGo target:
| + | |
| - | * Version name: meego-handset
| + | |
| - | * qmake location: ${MEEGO_SDK}\MADDE\0.7.45\targets\<target name>\bin\qmake.exe (Where ${MEEGO_SDK} is the directory you choose to install MeeGo SDK, default to C:\MeeGoSDK) <br>
| + | |
| - | [[File:Meego sdk options windows.png|550px]]
| + | |
| - | | + | |
| - | </ol>
| + | |
| - | | + | |
| - | == Use Qt Creator to develop MeeGo Applications ==
| + | |
| - | <ol>
| + | |
| - | | + | |
| - | <li> '''Create a MeeGo touch project (for handset) or Qt Gui project (for netbook) ''' </li>
| + | |
| - | Go to the menu: File -> New File or Project -> Qt Application Project -> Meego Touch Framework Application. <br/>
| + | |
| - | [[File:Windows_sdk_2.png]]
| + | |
| - | | + | |
| - | In "Project setup" dialog, choose "meego-handset".
| + | |
| - | | + | |
| - | [[File:Windows_sdk_3.png]]
| + | |
| - | | + | |
| - | <li> '''Set up emulator: Install kqemu accelerator for QEMU on 32-bit Windows system'''</li>
| + | |
| - | Notice: The kqemu could only be used on 32-bit Windows. 64-bit Windows could not work with kqemu. You can not use emulator on 64-bit Windows. Use real device instead.
| + | |
| - | | + | |
| - | Download package from http://wiki.qemu.org/download/kqemu-1.4.0pre1.tar.gz
| + | |
| - | | + | |
| - | Get the kqemu.inf and kqemu.sys files from above package
| + | |
| - | | + | |
| - | For WindowsXP system, right click the kqemu.inf file and select "install".
| + | |
| - | | + | |
| - | For WindowsVista system, edit the kqemu.inf file to do below changes, and then right click the kqemu.inf, select "install".
| + | |
| - | | + | |
| - | [DefaultInstall.NT] --> [DefaultInstall]
| + | |
| - | [DefaultInstall.NT.Services] --> [DefaultInstall.Services]
| + | |
| - | [Uninstall.NT] --> [Uninstall]
| + | |
| - | [Uninstall.NT.Services] --> [Uninstall.Services]
| + | |
| - | | + | |
| - | <b>TODO: Add instructions for Windows 7 system</b>
| + | |
| - | | + | |
| - | Start the kqemu manually:
| + | |
| - | net start kqemu
| + | |
| - | | + | |
| - | | + | |
| - | | + | |
| - | <li> '''Create an emulator runtime for MeeGo''' </li>
| + | |
| - | | + | |
| - | | + | |
| - | | + | |
| - | Get to the menu: Tools -> Options -> Projects -> MeeGo Device Configurations. Click "Add" button to add a runtime for emulator. Set "Device type" to "MeeGo emulator"; set "Authentication type" to "Password"; set "Username" to "root"; set "Password" to "meego".<br/>
| + | |
| - | [[File:Meego sdk emulator.png|550px]]
| + | |
| - | | + | |
| - | <li> '''Set Run Configuration''' </li>
| + | |
| - | Click "Projects" again on the left side. Select "Run" in the MeeGo Build/Run box at the top. Make sure that the "Device configuration" is set to "MeeGo Emulator". This will ensure that QEMU is started when you run your application. You can now launch the QEMU MeeGo emulator. Click the "Start Meego emulator" icon near the bottom left corner of Qt Creator (circled in red in the screenshot below).<br>
| + | |
| - | [[File:Meego sdk run.png|550px]]
| + | |
| - | | + | |
| - | <li> '''Build, run and deploy the application'''</li>
| + | |
| - | After QEMU starts, click the "Run" icon to run your application. Qt Creator will package and deploy your application to QEMU and start it on the target. You can see the window of your application in QEMU.<br>
| + | |
| - | '''Image rotation: If you are using the MeeGo handset image, you can rotate the screen with ALT+SHIFT+R'''<br>
| + | |
| - | [[File:Meego mtf run.png|550px]]
| + | |
| - | | + | |
| - | '''Note: The emulator does not have skin currently.'''
| + | |
| - | | + | |
| - | <li> '''Debug the application'''</li>
| + | |
| - | You can also debug the application by clicking the "Debug" icon. Setting breakpoints and stepping are the same as local applications.<br>
| + | |
| - | [[File:Meego sdk debug.png|550px]]
| + | |
| - | </ol>
| + | |
| - | === SSH into QEMU Image ===
| + | |
| - | Anytime MeeGo is running in QEMU, you can use SSH to connect to the image from another terminal on the host system.
| + | |
| - | <ol><li>Launch QEMU with MeeGo image (step #5 above)</li>
| + | |
| - | <li>From a terminal on the host, connect to the running image</li>
| + | |
| - | $ ssh meego@127.0.0.1 -p 6666
| + | |
| - | </ol>
| + | |
| - | Two user accounts are available in the MeeGo images:<br>
| + | |
| - | User: meego Password: meego<br>
| + | |
| - | User: root Password: meego<br>
| + | |
| - | | + | |
| - | === Configure Qt Creator to work with real devices ===
| + | |
| - | Qt Creator working with QEMU is out of the box, but sometimes we need to work with real device. Here is how: <br/>
| + | |
| - | <ol>
| + | |
| - | <li> Go to Tools -> Options -> Projects -> MeeGo Device Configurations and click "Add" button. Select "Remote Device" for "Device type", input other information and give a name for this configuration</li>
| + | |
| - | [[File:real_device.png|550px]]
| + | |
| - | <li> Open your project and in the "Projects" mode, click "Run" in the little MeeGo target window, and select the configuration you just created in "Device Configuration"</li>
| + | |
| - | [[File:Select_run_configuration.png|550px]]
| + | |
| - | <li> Click "Run" or "Debug" on the lower left corner of Qt Creator to run or debug your application on the configured Device.</li>
| + | |
| - | </ol>
| + | |