Tutorial

Install MIDPath

Read instructions here

Install a MIDlet

There is no MIDlet installer/deployer yet. You have to deploy MIDlets manually.

For this, you need to add the MIDlet jar to the JVM classpath and give the MIDlet class name to the MIDlet launcher.

For the example below we will use the MidpSSH MIDlet.

Download the midlet jar file (midpssh-full.jar)

We will refer to the directory which contains midpssh-full.jar as $DEPLOYED_DIR

Get MIDlet class name

You can find this info in the META-INF/MANIFEST.MF file inside the jar :

Manifest-Version: 1.0 MicroEdition-Configuration: CLDC-1.0 MIDlet-Name: MidpSSH Created-By: 1.4.2_06-b03 (Sun Microsystems Inc.) Ant-Version: Apache Ant 1.6.5 MIDlet-Permissions: javax.microedition.io.Connector.socket MIDlet-Vendor: XK72 MIDlet-1: MidpSSH, /small.png, app.Main MIDlet-Version: 1.4.20 MicroEdition-Profile: MIDP-2.0

Infos we are searching are in lines MIDlet-.

MIDlet-1: MidpSSH, /small.png, app.Main

The MIDlet 1 params are:

  • MidpSSH: name of the MIDlet
  • /small.png: the MIDlet icon
  • app.Main: the MIDlet class name

Modify the script example to start the MIDlet

Below you can see the bin/midpath-test.sh script modified for working with the MidpSSH MIDlet.

#!/bin/sh # Modify the next line to change the JVM JAVA_CMD=cacao if [ "$MIDPATH_HOME" = "" ]; then MIDPATH_HOME=$(pwd)/.. fi # Set the classpath CP=$MIDPATH_HOME/dist/midpath.jar:$MIDPATH_HOME/resources-embedded: \ $MIDPATH_HOME/dist/sdljava-j2se.jar:$MIDPATH_HOME/dist/escher-x11-cldc.jar:$MIDPATH_HOME/lib/kxml2-2.3.0.jar # Add the MIDlet jar to the classpath (must be loaded by the main # classloader yet) CP=$CP:$DEPLOYED_DIR/midpssh-full.jar # Path of the SDLJava native libraries JLP=$MIDPATH_HOME/dist CLASS=org.thenesis.midpath.MIDletLauncher # The classname of the MIDlet (we have to set it manually yet) MIDLET=app.Main $JAVA_CMD -Djava.library.path=${JLP} -cp ${CP} ${CLASS} ${MIDLET}

Usage

Key mapping is not configurable yet (planned). Default configuration is :

  • Left soft key (LSK): F1
  • Right soft key (RSK) : F2
  • Direction keys: arrow keys