•  Print this page
    Print this page

MicroEmulator
 
 
With the MicroEmulator you can easily demonstrate midlets on a website thru applets.

The MicroEmulator, written by Bartek Teodorczyk, is a Java 2 Micro Edition (J2ME) CLDC/MIDP Emulator and it is based on J2SE 1.3. MicroEmulator is free software, distributed under the Lesser GNU Public License, which means it is distributed at no charge for commercial or non-commercial use.

More information about MicroEmulator can be found at:
http://www.microemu.org/

The latest MicroEmulator version can be downloaded from:
http://sourceforge.net/projects/microemulator/

A tutorial about how to skin the MicroEmulator to look like a real mobile phone can be found at: http://www.petitpub.com/labs/j2me/me/tutorial/

Quick guides







Installing MicroEmulator as an applet.



Information
The MicroEmulator comes with three different skins: Operating system used
Windows XP Home Edition Version 5.1 SP 2

Software prerequisites
Java 2 Standard Edition (J2SE) SDK, version 1.3 or later.

Procedure
  1. Create directory <docroot>/download/midlets

  2. Add your midlets (.jar files) inside the midlets directory.

  3. Create directory <docroot>/applets

  4. Download and unzip microemulator-applet-2.0.0.tar.gz

  5. Add the following microemulator jar files inside the applets directory:
    • me-applet.jar (required)
    • minimum.jar (optional: to display minimum skin)
    • large.jar (optional: to display large skin)
    • nokiaui.jar (optional: for Nokia APIs support)
    • siemensapi.jar (optional: for Siemens APIs support)

  6. Add the following code in the HTML file:

    • To display the default skin

      For example: The HTML file is located at <docroot>/download/demo.html

      <applet code="org.microemu.applet.Main"
          width="226" height="471"
          archive="../applets/me-applet.jar,../download/midlets/your_midlet_jar">
          <param name="midlet" value="your_midlet_application_main_class" />
      </applet>

      Show midlet MobileStatus.




    • To display the minimum skin

      For example: The HTML file is located at <docroot>/download/demo.html

      <applet code="org.microemu.applet.Main"
          width="157" height="285"
          archive="../applets/me-applet.jar,../applets/minimum.jar,
          ../download/midlets/your_midlet_jar">
          <param name="midlet" value="your_midlet_application_main_class" />
          <param name="device" value="org/microemu/device/minimum/device.xml" />
      </applet>

      Show midlet MobileStatus with minimum skin.

    • To display the minimum skin with mouse and color

      For example: The HTML file is located at <docroot>/download/demo.html

      <applet code="org.microemu.applet.Main"
          width="157" height="285"
          archive="../applets/me-applet.jar,../applets/minimum.jar,
          ../download/midlets/your_midlet_jar">
          <param name="midlet" value="your_midlet_application_main_class" />
          <param name="device" value="org/microemu/device/minimum/device-color.xml" />
      </applet>

      Show midlet MobileStatus with minimum color.

    • To display the large skin

      For example: The HTML file is located at <docroot>/download/demo.html

      <applet code="org.microemu.applet.Main"
          width="292" height="618"
          archive="../applets/me-applet.jar,../applets/large.jar,
          ../download/midlets/your_midlet_jar">
          <param name="midlet" value="your_midlet_application_main_class" />
          <param name="device" value="org/microemu/device/large/device.xml" />
      </applet>

      Show midlet MobileStatus with large skin.

  7. The MicroEmulator also supports Nokia APIs and Siemens APIs.
    In the example below the default skin is used. Add the following code in the HTML file:

    • Support Nokia APIs

      For example: The HTML file is located at <docroot>/download/demo.html

      <applet code="org.microemu.applet.Main"
          width="226" height="471"
          archive="../applets/me-applet.jar,../applets/nokiaui.jar
          ../download/midlets/your_midlet_jar">
          <param name="midlet" value="your_midlet_application_main_class" />
      </applet>

    • Support Siemens APIs

      For example: The HTML file is located at <docroot>/download/demo.html

      <applet code="org.microemu.applet.Main"
          width="226" height="471"
          archive="../applets/me-applet.jar,../applets/siemensapi.jar
          ../download/midlets/your_midlet_jar">
          <param name="midlet" value="your_midlet_application_main_class" />
      </applet>