Eclipse IPK Plugin

Beschreibung

Dieses Plugin für die Eclipse Entwicklungsumgebung erleichtert die Erstellung von IPK Paketen mit Personal Java Programmen für Qtopia PDAs wie z.B. den Sharp Zaurus.

Das Plugin entstand im Rahmen der Einarbeitung in die Eclipse Plugin Schnittstelle und der SWT. Wir haben uns entschlossen das Plugin auch der Allgemeinheit unter der GPL zur Verfügung zu stellen. Sie können uns über das Kontaktformular gerne Anregungen zu diesem Plugin geben. Haben sie aber bitte Verständniss, daß wir keine kostenlose Unterstützung beim Einsatz diese Plugins geben können, da es sich in erster Linie um ein Übungsprojekt handelt.

Download

Das Plugin steht unter der GPL. Lesen sie sich die GPL bitte hier durch. Mit dem Download des Plugins akzeptieren sie die GPL. Eine inoffiziele Übersetzung der GPL können sie hier finden.

IPK Export Plugin Version 0.1 inkl. Quellcode für Eclipse 2.1. Getestet mit Eclipse 2.1 unter Windows und Linux.
IPK Export Plugin Version 0.2 für Eclipse 3.1. Getestet mit Eclipse 3.1 unter Windows und Linux. Achtung, daß Plugin funktioniert nicht mit Eclipse 3.
IPK Export Plugin Quellcode Version 0.2 für Eclipse 3.1.

Änderungen

Version 0.1:
- Erste veröffentlichte Version für Eclipse 2.1.
Version 0.2:
- Anpassungen für Eclipse 3.1.
- Einmal eingegebene Dialogeinstellungen werden nun in der Datei IPK_CONTROL.xml in den Projekt Resourcen für den nächsten Dialogaufruf gespeichert.

Installation

Entpacken Sie das Zip-Archiv mit dem IPK-Plugin einfach im selben Verzeichnis in dem sich die Eclipse Installation (Eclipse Verzeichnis) befindet. Das Plugin sollte sich Danach im Verzeichnis eclipse/plugins/de.inso-gmph.ipkplugin befinden. Nach einem Neustart von Eclipse sollten sie es über den Export-Menüpunkt nutzen können.

Bedienung

Nachfolgend finden sie eine kurze Anleitung zur Bedienung des IPK Plugins. Die Screenshots zeigen das Plugin unter Linux/GTK.

Auswahl Java Resourcen

Auf dieser Dialogseite werden die zu exportierenden Java Klassendateien bzw. andere Resourcen ausgewählt. Mit dieser Auswahl wird dann ein Jar-Archiv erstellt welches anschließend in das IPK-Paket eingebunden wird.

Folgende Bedienelemente stehen zur Verfügung:

Resourcenauswahl: Auswahl der Java Klassen und Resourcen die exportiert werden sollen.
Auswahl Hauptklasse: Auswahl der Klasse welche die statische Main-Methode enthält die beim Start des Programms aufgerufen werden soll.

Einstellungen Control-Datei

Diese Dialogseite enthält die Einstellungen zu der im IPK-Paket enthaltenen Control-Datei.

Folgende Einstellungsmöglichkeiten stehen zur Verfügung:

Name: Name des Pakets, der dann auch von IPK-Installationsprogrammen angezeigt wird. Entspricht dem Eintrag "Package" in der Control-Datei.
Version: Paket bzw. Programmversion. Entspricht dem Eintrag "Version" in der Control-Datei.
Beschreibung: Inhalts- bzw. Programmbeschreibung. Entspricht dem Eintrag "Description" in der Control-Datei.
Verwalter: Name und evtl. EMail-Adresse des Paketverwalters. Entspricht dem Eintrag "Maintainer" in der Control-Datei.
Paketabhängigkeit: Hier können Pakete angegeben werden, welche das Programm benötigt, damit es funktioniert. Mehrere Pakete sollten durch Komma getrennt werden. Entspricht dem Eintrag "Depends" in der Control-Datei.
Architektur: Geräte- / Prozessorarchitektur für die das Paket bestimmt ist. Personal Java Programme sollten hier in der Regel "all" verwenden. Entspricht dem Eintrag "Architecture" in der Control-Datei.
Priorität: Die meisten Programme sollten hier "optional" verwenden. Entspricht dem Eintrag "Priority" in der Control-Datei.
Kategorie: Eine Kategorie die am besten zu dem Programm paßt. Entspricht dem Eintrag "Section" in der Control-Datei.
IPK Name: Name der zu erstellenden IPK Datei. Dieses Feld dient nur zur Anzeige. Der Name kann nicht geändert werden und setzt sich immer wie folgt zusammen: < Name> _< Version> _< Architektur> .ipk.
IPK Verzeichnis: Verzeichnis in welches das fertige IPK-Paket gespeichert werden soll.

Einstellungen Desktop-Datei und Startskript

Diese Dialogseite enthält die Einstellungen zu der im IPK-Paket enthaltenen Desktop-Datei und des Startskripts. Dadurch wird z.B. festgelegt wo das Programm auf dem PDA installiert und über welches Symbol es gestartet wird.

Folgende Einstellungsmöglichkeiten stehen zur Verfügung:

Anwendungsname: Name des Programms wie er auf der PDA Oberfläche angezeigt wird. Entspricht dem Eintrag "Name" in der Desktop-Datei.
Programmname: Name des ausführbaren Programms. Diese Einstellung ist nicht änderbar. Sie entspricht hier immer dem Anwendungsnamen, allerdings komplett kleingeschrieben. Dieser Name ist der Name des Startskripts für die Personal Java-Anwendung. Entspricht dem Eintrag "Exec" in der Desktop-Datei.
Beschreibung: Kurze Beschreibung zum Programm. Entspricht dem Eintrag "Comment" in der Desktop-Datei.
Programmsymbol: Optionale PNG-Datei mit dem Symbol welches zum Starten des Programms auf der PDA Oberfläche verwendet werden soll. Diese Symbol wird unter dem Symbolname angezeigt und in das IPK-Paket exportiert. Es bekommt im IPK-Paket allerdings den Dateinamen < Anwendungsname> .png. Dieser geänderte Name entspricht dann dem Eintrag "Icon" in der Desktop-Datei.
Programmtyp: Typ des Programms. Legt auch gleichzeitig fest, auf welcher Seite des Programmmanagers das Programm auf dem PDA angezeigt wird. Entspricht dem Eintrag "Type" in der Desktop-Datei.
JVM Optionen: Zusätzliche Optionen die der JVM (EVM) beim Programmstart übergeben werden sollen. Diese Feld kann auch leer gelassen werden.
Anzahl der Kommandozeilenparameter: Legt die maximale Anzahl der Parameter fest, die das Startskript bei einem Start von der Kommandozeile der Java Main-Methode des Programms übergeben kann. Diese Feld kann auch leer gelassen werden.