Android User Hallo Android (Vorschau)

Devcorner
PhoneGap-Workshop
wärtskompatibilität für Sie sicher. Möchten
Sie die App allerdings auf einem echten
Gerät testen, dann müssen Sie unbedingt die
gleiche Android-Version wählen (bzw. den
gleichen API-Level) wie auf dem Gerät.
Im nächsten Dialog müssen Sie der App im
Feld Package Name einen Namen inklusive
Namespace geben. Mit einem Klick auf
Finish beenden Sie den Assistenten. Der legt
im Package Explorer Ihr Projekt mit den
grundlegenden Dateien an. Als Nächstes benötigen
Sie zwei Dateien, die im PhoneGap-
Paket unter lib/android enthalten sind,
phonegap‐1.4.1.jar und phonegap‐1.4.1.js
(beachten Sie die Versionsnummern!). Erzeugen
Sie im Root-Verzeichnis des oben erzeugten
Projekts zwei neue Verzeichnisse
/libs
/assets/www
Dann kopieren Sie phonegap‐1.4.1.jar nach
/libs und phonegap‐1.4.1.js nach /assets/
www. Öffnen Sie nun wieder Eclipse und aktualisieren
Sie die Projektansicht mit der Taste
[F5]. Nun werden auch die in das Projekt kopierte
Dateien im Package Explorer aufgeführt.
Als Nächstes legen Sie eine index.html in
Ihrem www-Ordner an. Sie können hierfür
einen Web-Editor Ihrer Wahl verwenden oder
per Rechtsklick auf die Datei und den Menüpunkt
Open with | Text editor den Editor von
Eclipse benutzen. Weisen Sie der Index-Datei
den Code aus dem Listing 1 zu.
Anpassungen
Nun gilt es einige Anpassungen an der
Hauptprojektdatei im src-Ordner vorzunehmen.
Benennen Sie die Klassenerweiterung
von Activity nach DroidGap um, und ersetzen
Sie die Zeile setContentView() durch folgenden
Code:
super.loadUrl("file:///android_asset/www/U
index.html");
Fügen Sie außerdem import com.phonegap.*;
im import-Segment hinzu. Sollte Eclipse eine
Fehlermeldung ausgegeben, dass es die JAR-
Datei phonegap‐1.4.1.jar nicht finden kann,
markieren Sie den libs-Ordner mit der rechten
Maustaste und korrigieren mit dem
Menü befehl Build Paths | Configure Build
Paths den Pfad. Wechseln Sie dazu zur Registerkarte
Libraries, und fügen Sie dort mit
einem Klick auf die Schaltfläche Add JARs
die Datei phonegap‐1.4.1.jar dem Projekt
hinzu.
Schließlich müssen Sie einige Berechtigungen
der Datei AndroidManifest.xml hinzufügen,
damit PhoneGap korrekt ausgeführt
wird. Dazu gehören auch jede Menge
Berechtigungen in der Grundeinstellung. Die
Einträge zeigt Listing 2. Fügen Sie diese vor
dem Abschnitt ein. Zudem
müssen Sie im Activity-Abschnitt die folgende
Zeile einfügen:
android:configChanges="orientation|keyboardU
Hidden"
Damit wird sichergestellt, dass die Index-Datei
nicht erneut geladen wird, wenn ein bestimmtes
Ereignis eintritt. Schließlich müssen
Sie noch den XML-Ordner, der Bestandteil
von PhoneGap ist, in den res-Ordner
Ihres Projekts kopieren. Damit haben Sie alle
notwendigen Schritte für Ihr erstes Android-
Projekt vorgenommen, und Sie können dieses
mit Ihrer Testumgebung ausführen. Dazu
klicken Sie in der Eclipse-Symbolleiste auf
die Run-Schaltfläche.
Lokale Simulation
Damit Sie ein Projekt auf Ihrem lokalen
Rechner simulieren können, benötigen Sie
einen Emulator, der Ihr Android-Gerät lokal
simuliert.
Unter Android heißt dieser Android Virtual
Device, kurz AVD. Das Schöne an Eclipse:
Sie können verschiedene Emulatoren
Listing 2: AndroidManifest.xml
Android-user.de April 2012 109