Markus’ Blog > Java

I tried to run the LWUIT Demo with my MicroEmulator iPhone port. Here are some screenshots:

First Try. Got the clipping slightly wrong…

After a quick fix, clipping correct, but no text…

Changing to another theme…

… the text is there!

Menu is workin.

Setting some dialog properties, and…

… displaying it.

Some more screenshots…

Performance is slow as hell, not all graphics are rendered properly, but its working at least.

I have started porting microemulator to (jailbroken) iPhones. Here are some first screenshots.

I am using Maven2 for most Java projects. So I wanted to use it for Phone-Java development, too. This is a little tutorial on how it can be done.

iPhone Cydia Packages are Debian .deb files really and luckily there is the mvn-pkg-plugin that supports creating .deb files with Maven2. Unfortunatly the current version has a bug, so that it won’t work out of the box for creating iPhone packages. So you have to grab the latest svn-snapshot and apply the following patch.

Index: src/main/java/de/tarent/maven/plugins/pkg/map/Parser.java
===================================================================
--- src/main/java/de/tarent/maven/plugins/pkg/map/Parser.java	(revision 132)
+++ src/main/java/de/tarent/maven/plugins/pkg/map/Parser.java	(working copy)
@@ -62,7 +62,7 @@
 
       if (auxMapDocument != null)
         {
-          s = new State(packageMapDocument);
+          s = new State(auxMapDocument);
 
           s.nextMatch("package-maps");
           parsePackageMaps(s);

After applying the atch and doing a “mvn install”, we can start with the real work. Download the tutorial files from here. I will explain the contents of the archive later. For now unzip it and do a “mvn package” in its directory. It will compain about some missing dependencies, so grab the missing jars from your iPhone and install them in your Maven reposiory as directed in the error message. After you have done that another “mvn package” shoud produce a .deb file in the target subdirectory. You can upload this to your iphone and install it with dpkg. After a restart of the SpringBoard a new icon HelloMaven should be on your screen, that should start the demo program.

Now some explanation of how it works. The main part is done in the pom.xml. Here is the relavant excerpt form this file:

<plugin>
	<groupId>de.tarent.maven.plugins</groupId>
	<artifactId>maven-pkg-plugin</artifactId>
	<configuration>
		<defaultDistro>iphoneos</defaultDistro>
		<shortDescription>Arindal Tune Helper</shortDescription>
		<defaults>
			<mainClass>HelloJava</mainClass>
			<section>example</section>
			<architecture>iphoneos-arm</architecture>
			<datadir>/Applications/HelloMaven.app
			</datadir>
			<dataFiles>
				<dataFile>
					<from>Info.plist</from>
				</dataFile>
				<dataFile>
					<from>icon.png</from>
				</dataFile>
				<dataFile>
					<from>Starter</from>
				</dataFile>
			</dataFiles>
			<postinstScript>postInst.sh</postinstScript>
			<prermScript>preRm.sh</prermScript>
		</defaults>
		<auxPackageMapURL>file:${basedir}/pm-iphoneos.xml
		</auxPackageMapURL>
	</configuration>
	<executions>
		<execution>
			<phase>package</phase>
			<goals>
				<goal>pkg</goal>
			</goals>
		</execution>
	</executions>
</plugin>

The first important part is the defaultDistro tag. Here we tell the plugin, that we want to build a package for the iPhone. Unfortunatly there are no default iPhone mappings contained in the plugin. That is why we have the auxPackageMapURL tag, that tells the plugin where to look for the Maven-to-Cydia-Package-Mapping. Most other things should be pretty self explaining.

The files in the dataFiles Section have to reside in src/main/auxfiles icon.png and Info.plist should be pretty clear. The Starter entry needs some explanation though. The plugin automatically generates a start script in /usr/bin. This is good enough for console applications, but if you want to start a GUI-App some more work is needed. The Starter script sets the Java executable path to /Applications/Appname.app/Java and calls the generated script after that. For this to work the starter Script has to get executable permissions and jamvm has to be linked to /Applications/Appname.app/Java. This is done in the postInst.sh script. For more info about those scripts and what you can do there refer to the Debian documentation.

This should be enough to get you started, if cou have questions, please feel free to post them in the comments.

So die ersten Versuche mit iPhone Java Entwicklung sind gemacht. Hier mal ein Screenshot von ein paar Grafikausgaben. Reagiert auch schon auf Touch Events. Spaeter mehr davon.

Eine sehr nützliche Lib um Kommandozeilen in Java zu Parsen hat Panzi in seinem Blog beschrieben. Dazu werden die Felder im Java Code einfach mit bestimmten Annotations versehen und die Lib kümmert sich um das Parsing und schreibt die Werte direkt in die Felder.

Um Java CDC Anwendungen zu entwickeln braucht man eine entsprechende virtuelle Machine. Eine OpenSource VM wird im phoneME Projekt entwickelt. Es gibt dort verschiedenste Versionen für Linux, Windows, Windows Mobile und auch für Darwin/OS X. Allerdings ist bisher nur ein PowerPC Variante für OS X verfügbar. Die lässt sich auch auf einem Intel Mac benutzen, allerdings nur im Foundation-Profile, dass keine UI bereitstellt. Um AWT zu haben benötigt man das Personal-Profile, was jedoch QT verlangt. Und mit Fink kann man von QT keine Universal Binarys installieren.

Deshalb habe ich versucht die PowerPC Version von phoneME Advanced nach x86 zu portieren. Dazu war nicht sonderlich viel nötig. Ich habe lediglich einige Dateien durch die entsprechenden Linux x86 Versionen ersetzt.

Hier ist nun das Ergebnis:

Patch: phoneme-cdc-darwin-x86

Binary: phoneme-cdc-personal-darwin-x86-qt3-x11-bin

Die Dateien aus dem Patch-Archiv müssen in die entsprechenden Ordner der phoneME Sourcen kopiert werden. Dann kann im Verzeichnis cdc/build/darwin-x86-mac “make” aufgerufen werden um das Foundation Profil zu bauen und mit “make J2ME_CLASSLIB=personal” kann das Personal-Profil erzeugt werden. Dafür benötigt man QT3, das am einfachsten mit Fink installiert wird.

Die entstandene VM lässt sich am einfachsten mit “bin/cvm -jar democlasses.jar” testen.