|
|
| (44 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.'''
| + | == Download and use the MeeGo SDK for Windows== |
| | + | * Latest [[SDK/Docs/1.2/Getting_started_with_the_MeeGo_SDK_for_Windows|MeeGo 1.2 SDK Preview for Windows]] |
| | + | * MeeGo 1.2 SDK Preview 3 for Windows with a snapshot of the tablet target - http://appdeveloper.intel.com/en-us/article/installing-meego-sdk-windows |
| | + | * [[SDK/Docs/1.1/Getting_started_with_the_MeeGo_SDK_for_Windows|MeeGo 1.1 SDK for Windows]] |
| | | | |
| - | ==Status== | + | ==Get support== |
| - | | + | * MeeGo Bugzilla |
| - | ===Nov 30, 2010===
| + | ** URL: http://bugs.meego.com |
| - | * Beta version released. | + | ** Product name: MeeGo SDK |
| - | [[User:Maxayu|Maxayu]] 01:33, 30 November 2010 (UTC)
| + | ** Bug summary: Please have "[Windows]" in the beginning of your bug summary. |
| - | | + | |
| - | ===History status===
| + | |
| - | | + | |
| - | Check [[SDK/History Status of MeeGo SDK for Windows]] for more history status.
| + | |
| - | | + | |
| - | ==Get support==
| + | |
| | * MeeGo SDK mailing list | | * MeeGo SDK mailing list |
| | **http://lists.meego.com/listinfo/meego-sdk | | **http://lists.meego.com/listinfo/meego-sdk |
| - | * Bugzilla
| |
| - | ** URL: http://bugs.meego.com
| |
| - | ** Product name: MeeGo SDK
| |
| - | ** Bug summary: Please have "[Windows]" in the begining of your bug summary.
| |
| - |
| |
| - | ==Join the community==
| |
| - | *Documentation
| |
| - | **The current wiki page is the official document for MeeGo SDK for Windows. Feel free to edit it.
| |
| - |
| |
| - | ==System requirements==
| |
| - |
| |
| - | *Windows XP 32-bit and Windows 7 32-bit are officially supported by MeeGo SDK. MeeGo SDK may work on Windows Vista, but it is not officially supported.
| |
| - | *MeeGo SDK should be installed to hardlink-capable filesystem such as NTFS. FAT* filesystems are not hardlink-capable, so they are not supported.
| |
| - | *QEMU emulator can only work with 32-bit Windows. If you are using 64-bit Windows, you cannot use emulator. QEMU emulator in the SDK relies on kqemu to provide CPU virtualization support, but so far we found that on some machines (seems to be related to CPU type), the image could not boot up. Below are some information for reference:
| |
| - | ** known to work: Intel(R) Core(TM)2 Quad CPU, Q8200; Intel(R) i5 and i7
| |
| - | ** known not to work: Intel(R) Core(TM)2 Due P9400 in Thinkpad T400; Intel(R) Core(TM)2 Q9400 in HP7900 Ultra-slim
| |
| - |
| |
| - | ==Known issues and possible workarounds==
| |
| - |
| |
| - | * Currently the emulator only works for the IA target.
| |
| - | * Only one target "meego-handset-ia32-w32-1.1" and one runtime "meego-handset-ia32-pinetrail-mtf-1.0.90.2.20100914.1-sdk-1.1.80.20101023.1936-sda-runtime" has been tested.
| |
| - | * All stuff, including targets and runtimes, will be removed if you run the uninstaller of MeeGo SDK.
| |
| - |
| |
| - | == Download and setup the MeeGo SDK ==
| |
| - |
| |
| - | <ol>
| |
| - | <li>Download the MeeGo SDK installer:</li>
| |
| - | <table border='1' cellpadding='3px' style="padding: 0em">
| |
| - | <tr><th>File</th><th>Description</th><th>Size</th><th>MD5SUM</th></tr>
| |
| - | <tr><td>http://download3.meego.com/MeeGoSDK/1.1/meego-1.1-sdk-beta-online-installer.exe</td>
| |
| - | <td>MeeGo SDK Windows online installer</td>
| |
| - | <td>14MB</td>
| |
| - | <td>0d1f92c90232641f8b638727886e6874</td>
| |
| - | </tr>
| |
| - | <tr><td> http://download3.meego.com/MeeGoSDK/1.1/meego-1.1-sdk-beta-offline-installer.exe</td>
| |
| - | <td>MeeGo SDK Windows offline installer</td>
| |
| - | <td>54MB</td>
| |
| - | <td>be824c3e19e849aa69582689f65eaafa</td>
| |
| - | </tr>
| |
| - | </table>
| |
| - | <li>Double-click on the downloaded <code>.exe</code> file and follow the prompts to install the SDK.</li>
| |
| - | <li>After installation, launch MADDE Terminal with ''Start > All Programs > MeeGo SDK > MADDE Terminal''.</li>
| |
| - | <ol>
| |
| - | <li> Run something like "export http_proxy=XXX" if you are in an intranet.</li>
| |
| - | <li> Run "mad-admin create -f meego-handset-ia32-w32-1.1" to create target "meego-handset-ia32-w32-1.1". Some huge files will be downloaded automatically.</li>
| |
| - | <li> Run "mad-admin create -e -f meego-handset-ia32-w32-qemu-1.1.20101031.2201-sda-runtime" to create a runtime "meego-handset-ia32-w32-qemu-1.1.20101031.2201-sda-runtime". Some huge files will be downloaded automatically.</li>
| |
| - | </ol>
| |
| - | <li>Launch Qt Creator with ''Start > All Programs > MeeGo SDK > QtCreator''.</li>
| |
| - | <li> Configure Qt Creator to support MeeGo sysroot. Inside Qt Creator, follow these steps:
| |
| - | <ol>
| |
| - | <li>From the ''Tools'' menu, choose ''Options''.</li>
| |
| - | <li>Click into the ''Qt4'' section, and make sure the ''Qt Versions'' tab is open.</li>
| |
| - | <li>Click the ''+'' button, and then fill the ''Version name'' and the ''qmake location'' of the MeeGo target:
| |
| - | <ul>
| |
| - | <li>''Version name:'' '''meego-handset'''</li>
| |
| - | <li>''qmake location:'' '''<MEEGO_SDK>\MADDE\targets\<target name>\bin\qmake.exe'''<br/>
| |
| - | Replace <MEEGO_SDK> with the directory where you installed MeeGo SDK; the default is <code>C:\MeeGoSDK_1.1</code>; replace <target_name> with the name of the target (for example, '''meego-core-ia32''').</li>
| |
| - | <li>Once added, select the new entry and click on the ''Rebuild'' button (bottom right) to build the debugging helper for this Qt version. This enables you to use debugging from Qt Creator.</li>
| |
| - | </ul>
| |
| - | The result should look like this:<br/>
| |
| - | [[File:Meego-sdk-qt4.png|800px]]
| |
| - | </li>
| |
| - | </ol>
| |
| - |
| |
| - | </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:Meego-sdk-project-setup.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 Windows XP system, right click the kqemu.inf file and select "install".
| |
| - |
| |
| - | For Windows 7 or Windows Vista 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]
| |
| - |
| |
| - | Start the kqemu manually. Select ''Start > All Programs > Accessories'', click right mouse button over ''Command Prompt'', and select "Run as administrator". In Command Prompt, run the following command:
| |
| - | net start kqemu
| |
| - | You need to start kqemu again after you reboot the system.
| |
| - |
| |
| - |
| |
| - | <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|800px]]
| |
| - |
| |
| - | <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-settings.png|800px]]
| |
| - |
| |
| - | <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>
| |
| - | [[File:Qemu-handset.png|800px]]
| |
| - |
| |
| - |
| |
| - |
| |
| - | <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:Qemu-handset-debug.png|800px]]
| |
| - | </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|800px]]
| |
| - | <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:Meego-sdk-run-settings-real-device.png|800px]]
| |
| - | <li> Launch terminal inside the device, and run command "xhost +" in it. </li>
| |
| - | <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>
| |
| - | == How to create QEMU images for Windows==
| |
| - | The QEMU images for SDK on Linux could be built from the [http://meego.gitorious.org/meego-os-base/image-configurations/trees/MeeGo1.1/SDK kick start file] by using mic-image-creator tool (command to run the mic-image-creator could be found in each ks file). Ideally the images are host platform independent. However, due to the booting time and some other issues with kqemu, minor changes were done on the images obtained from ks file so that they could boot up successfully on Windows. Suppose you have had a raw image, say abc.raw, built from kick start file in hand, below are the changes needed:
| |
| | | | |
| - | 1, mount into the image
| + | == BKMs on building the MeeGo SDK for Windows== |
| - | sudo mount -o loop,offset=512 abc.raw /mnt
| + | * [[SDK/Build MeeGo SDK for Windows]] |
| - | 2, edit /mnt/usr/sbin/meego-dm to add "sleep 1" to solve [http://bugs.meego.com/show_bug.cgi?id=10412 bug #10412: mouse udev not ready ...]
| + | |
| - | sleep 1 # new added line
| + | |
| - | shopt -s execfail
| + | |
| - | 3, edit /mnt/boot/extlinux/extlinux.conf to add kernel option "intel_idle.max-cstate=0" to solve [http://bugs.meego.com/show_bug.cgi?id=10149 bug #10149: Home screen can't show up ...]
| + | |
| - | append ro root=/dev/sda1 vga=current intel_idle.max-cstate=0 quiet
| + | |
| - | 4, unmount the image
| + | |
| - | sudo umount /mnt
| + | |