MeeGo SDK for Windows

Revision as of 10:09, 3 November 2010

Note: MeeGo SDK for Windows is still under development, and it has not been released yet.

Note: This page is work-in-progress (3 Nov 2010).

Note: This page contains instructions on install MeeGo SDK for Windows, and use it to build/deploy/debug apps.

How to contribute

Report bugs

• URL: http://bugs.meego.com .
• Product name: MeeGo SDK
• Bug summary: Please have "[Windows]" in the begining of your bug summary.

Update document

The current wiki page is the official document for MeeGo SDK for Windows. Feel free to edit it.

System requirements

• 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 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.
• Uninstaller is not in the start menu. You can find it at the directory where you installed MeeGo SDK.
• All stuff, including targets and runtimes, will be removed if you run the uninstaller of MeeGo SDK.
• If you cannot find QML Viewer, it is at <MEEGO_SDK>\MADDE\0.7.53\tools\qt-creator\bin\qmlviewer.exe. Replace <MEEGO_SDK> with the directory where you installed MeeGo SDK; the default is C:\MeeGoSDK;
• Please search [Windows] at http://bugs.meego.com for other known issues/bugs.

Setup the MeeGo SDK

1. Download the MeeGo SDK installer:

File	Description	Size
http://download3.meego.com/meego-sdk-installer-1103.exe	MeeGo SDK Windows offline installer	144MB

2. Double-click on the downloaded .exe file and follow the prompts to install the SDK.
3. After installation, launch MADDE Terminal with Start > All Programs > MeeGo SDK > MADDE Terminal.
1. Run something like "export http_proxy=XXX" if you are in an intranet.
2. Run "mad-admin create -f meego-handset-ia32-w32-1.1" to create target "meego-handset-ia32-w32-1.1". Some files will be downloaded automatically.
3. Run "mad-admin create -e -f meego-handset-ia32-pinetrail-mtf-1.0.90.2.20100914.1-sdk-1.1.80.20101023.1936-sda-runtime" to create a runtime "meego-handset-ia32-pinetrail-mtf-1.0.90.2.20100914.1-sdk-1.1.80.20101023.1936-sda-runtime". Some files will be downloaded automatically.
4. Launch Qt Creator with Start > All Programs > MeeGo SDK > QtCreator.
5. Configure Qt Creator to support MeeGo sysroot. Inside Qt Creator, follow these steps:
   1. From the Tools menu, choose Options.
   2. Click into the Qt4 section, and make sure the Qt Versions tab is open.
   3. Click the + button, and then fill the Version name and the qmake location of the MeeGo target:
      • Version name: meego-handset
      • qmake location: <MEEGO_SDK>\MADDE\0.7.53\targets\<target name>\bin\qmake.exe
        Replace <MEEGO_SDK> with the directory where you installed MeeGo SDK; the default is C:\MeeGoSDK; replace <target_name> with the name of the target (for example, meego-core-ia32).
      • 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.

             The result should look like this:
      
             
      

Use Qt Creator to develop MeeGo Applications

1. Create a MeeGo touch project (for handset) or Qt Gui project (for netbook)

Go to the menu: File -> New File or Project -> Qt Application Project -> Meego Touch Framework Application.


In "Project setup" dialog, choose "meego-handset".



2. Set up emulator: Install kqemu accelerator for QEMU on 32-bit Windows system

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]

TODO: Add instructions for Windows 7 system

Start the kqemu manually:

net start kqemu




3. Create an emulator runtime for MeeGo




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".


4. Set Run Configuration

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).
Note #1: When emulator pops up, please press left mouse button over the emulator screen, and press "Enter" key once. Or the system inside the emulator will not continue to boot. This is a workaround.
Note #2: After desktop is shown in emulator, please launch terminal inside it, and run command "xhost +" in it. This is a workaround.


5. Build, run and deploy the application

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.
Note: The screenshot need to be updated. The emulator does not have skin currently.





6. Debug the application

You can also debug the application by clicking the "Debug" icon. Setting breakpoints and stepping are the same as local applications.

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.

1. Launch QEMU with MeeGo image (step #5 above)
2. From a terminal on the host, connect to the running image

$ ssh meego@127.0.0.1 -p 6666

Two user accounts are available in the MeeGo images:
User: meego Password: meego
User: root      Password: meego

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:

1. 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



2. 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"



3. Click "Run" or "Debug" on the lower left corner of Qt Creator to run or debug your application on the configured Device.