Voraussetzungen PhoneGap

Node.js

PhoneGap basiert auf Node.js, die Installation ist im Vorfeld zwingend notwendig, für alle Plattformen gibt es einen komfortablen Installer bzw. ein Package.
Node.js herunterladen

Java SDK

Um die Android-Plattform zu unterstützen, ist selbstverständlich die Installation des Java SDK erforderlich.

Unter Windows sind zwei weitere Schritte erforderlich:

  • JAVA_HOME-Umgebungsvariable mit dem Pfad zum jre-Verzeichnis definieren
  • Die Windows PATH-Umgebungsvariable um %JAVA_HOME%\bin erweitern

Android SDK

Will man die Android-Binaries lokal übersetzen und mit dem Emulator testen (was sehr empfehlenswert ist), muss man das Android SDK installieren.
Auf allen Plattformen ist es in weiterer Folge erforderlich, dass man, mit Hilfe der SDK Manager GUI (befindet sich im /tools-Verzeichnis), die erforderlichen API-Levels, Emulatoren und Libraries, welche man verwenden möchte, nachinstalliert.
Hinweis: Abhängig vom Installations-Pfad ist ein Starten des SDK-Managers mit root/Administrator-Privilegien notwendig.

Weitere Schritte in Windows:

  • Die Windows PATH-Umgebungsvariable um das tools-Directory im Android-SDK Verzeichnis zu erweitern
  • Die Windows PATH-Umgebungsvariable um das platform-tools-Directory im Android-SDK Verzeichnis zu erweitern

Weitere Schritte in OSX:

  • Erstellen von ~/.bash_profile (wenn nicht schon vorhanden)
  • Die PATH-Variable mit Hilfe von export um die beiden Verzeichnisse tools und platform-tools aus dem Android SDK erweitern. Folgendes sollte also in der ~/.bash_profile zumindest stehen:
    export PATH=$PATH:/path/to/androidSDK/sdk/platform-tools:/path/to/androidSDK/sdk/tools
    Damit die Änderungen wirksam werden, muss man sich in der Konsole neu anmelden.

Apache ant

Unter Windows muss man noch das ant-Buildtool installieren, unter OSX ist dies nicht notwendig. Folgender Schritt ist in weiterer Folge noch notwendig:

  • Die Windows PATH-Umgebungsvariable um das \bin-Directory im ant-Installationsverzeichnis erweitern

Git

Damit man im Laufe der Entwicklung PhoneGap-Plugins installieren kann, ist die Source-Code-Management-Sofware Git zwingend erforderlich. Sowohl für Windows als auch für OSX steht ein komfortabler Installer bereit. Beim Installationsvorgang wird man gefragt, ob man die Git-Binaries in den PATH schreiben möchte, diese Option muss man auf jeden Fall auswählen.