Android-Plattform-Guide

Diese Anleitung zeigt wie Ihre Entwicklungsumgebung SDK eingerichtet, Cordova apps für Android-Geräte bereitzustellen. Finden Sie im folgenden detaillierte Plattform-spezifischen Informationen:

Die Befehlszeilentools, die oben beziehen sich auf Versionen vor 3.0 Cordova. Informationen über die aktuelle Schnittstelle finden Sie unter The Command-Line Interface.

Anforderungen und Unterstützung

Finden Sie die Systemanforderungen für das Android SDK.

Cordova unterstützt Android 2.2, 2.3 und 4.x. Als allgemeine Regel sind Plattformen veraltet, da sie weniger als 5 % auf Googles Verteilung Dashboard Tauchen.

Entwickler sollten verwenden das cordova -Dienstprogramm in Verbindung mit dem Android SDK. Finden Sie unter The Command-Line Interface Informationen installieren Sie es, Projekte, hinzufügen dann erstellen und Bereitstellen eines Projekts.

Das SDK installieren

Installieren Sie das Android SDK von developer.android.com/sdk. Sie können mit einer Wahl, wo das SDK installieren vorgelegt werden sonst die heruntergeladenen verschieben adt-bundle Baum, wo Sie Entwicklungstools zu speichern.

Für Cordova Kommandozeilen-Tools arbeiten, müssen Sie das SDK enthalten tools und platform-tools Verzeichnisse in Ihrer PATH-Umgebung. Auf Mac, können Sie einen Text-Editor zum Erstellen oder ändern die ~/.bash_profile -Datei eine Zeile wie die folgende, je nachdem, wo das SDK installiert:

export PATH=${PATH}:/Development/adt-bundle/sdk/platform-tools:/Development/adt-bundle/sdk/tools

Dies macht die SDK-Tools im neu eröffneten terminal-Fenster verfügbar. Sonst laufen Sie hier, um sie in der aktuellen Sitzung zur Verfügung stellen:

$ source ~/.bash_profile

Die PATH-Umgebung unter Windows 7 zu ändern:

  • Im Menü " Start " in der unteren linken Ecke des Desktops mit der rechten Maustaste auf Computer, klicken, Eigenschaften.

  • Klicken Sie in der Spalte auf der linken Seite auf Erweiterte Systemeinstellungen .

  • Drücken Sie im daraufhin angezeigten Dialogfeld Umgebungsvariablen.

  • Wählen Sie die PATH -Variable und klicken Sie Bearbeiten.

  • Fügen Sie Folgendes in den Pfad basierend auf dem Sie das SDK, zum Beispiel installiert:

    ;C:\Development\adt-bundle\sdk\platform-tools;C:\Development\adt-bundle\sdk\tools
    
  • Speichern Sie den Wert und schließen Sie beide Dialogfelder zu.

Sie müssen möglicherweise auch Java und Ant öffnen eine Eingabeaufforderung und geben aktivieren java , und geben Sie auch ant . Hängen Sie an den Pfad, welcher nicht ausgeführt:

    ;%JAVA_HOME%\bin;%ANT_HOME%\bin

Öffnen Sie ein Projekt im SDK

Verwendung der cordova Utility für ein neues Projekt, wie in der Cordova The Command-Line Interface beschrieben einrichten. Zum Beispiel in einem Quellcode-Verzeichnis:

    $ cordova create hello com.example.hello "HelloWorld"
    $ cd hello
    $ cordova platform add android
    $ cordova build

Einmal erstellt, wird hier das SDK zu verwenden, um es zu ändern:

  • Starten Sie die Eclipse -Anwendung.

  • Wählen Sie Neues Projekt .

  • Wählen Sie Android Projekt aus vorhandenem Code aus dem daraufhin angezeigten Dialogfeld, und klicken Sie auf weiter:

  • Navigieren Sie zu hello , oder welches Verzeichnis Sie für das Projekt erstellt, dann auf die platforms/android Unterverzeichnis.

  • Drücken Sie Fertig stellen.

Sobald das Eclipse-Fenster wird geöffnet, erscheint ein rotes X auf ungelöste Probleme hinweisen. Wenn ja, gehen Sie zusätzlichen folgendermaßen:

  • Rechtsklick auf das Projektverzeichnis.

  • Wählen Sie in den daraus resultierenden Eigenschaften im Navigationsbereich des Android .

  • Erstellen Sie Ziel für das Projekt zu, wählen Sie die höchste Android API-Ebene, die Sie installiert haben.

  • Klicken Sie auf OK.

  • Wählen Sie im Menü Projekt Clean . Dies sollten alle Fehler im Projekt korrigieren.

Bereitstellen auf Emulator

Können Sie das cordova -Dienstprogramm eine app in einem Emulator, oder Sie laufen kann es im SDK ausgeführt. In jedem Fall muss das SDK zuerst konfiguriert werden um mindestens ein Gerät anzuzeigen. Verwenden Sie hierzu das Android SDK Manager, eine Java-Anwendung, die separat von Eclipse verläuft. Es gibt zwei Möglichkeiten, es zu öffnen:

  • Führen Sie android in der Befehlszeile.

  • Drücken Sie von Eclipse, dieses Symbol in der Symbolleiste:

Nach dem Öffnen zeigt das Android SDK Manager verschiedene Laufzeit-Bibliotheken:

Wählen Sie Extras → Verwaltung AVDs (Android Virtual Devices), dann wählen Sie ein Element aus Gerätedefinitionen in dem daraufhin angezeigten Dialogfeld:

Presse AVD erstellen, ändern optional den Namen und drücken Sie OK um die Änderungen zu übernehmen.

Der AVD wird dann in der Liste Android Virtual Devices angezeigt:

Um den Emulator als separate Anwendung zu öffnen, wählen Sie den AVD, und drücken Sie Start. Es bringt viel, wie es auf dem Gerät mit zusätzliche Steuerelemente für Hardware-Tasten zur Verfügung:

An dieser Stelle können Sie das cordova -Dienstprogramm zum Bereitstellen der Anwendung für den Emulator von der Befehlszeile aus:

    $ cordova emulate android

Wenn Sie stattdessen in Eclipse arbeiten, Maustaste auf das Projekt, und wählen Sie Ausführen als → Android-Anwendung. Sie möglicherweise aufgefordert, eine AVD angeben, wenn keine bereits geöffnet.

Verwenden Sie für eine schnellere Erfahrung ein Intel-basierten Emulator-Image:

  • Installieren eine oder mehrere Intel x86 Atom System-Images als auch die Intel Hardware Accelerated Execution Manager , finden Sie unter Extras.

  • Führen Sie das Intel-Installationsprogramm aus, das innerhalb Ihres Android SDK unter verfügbar istextras/intel/Hardware_Accelerated_Execution_Manager.

  • Erstellen Sie eine neue AVD, mit dem Ziel, die auf einem Intel-Bild festgelegt.

  • Wenn Sie den Emulator zu starten, stellen Sie sicher, es gibt keine Fehlermeldungen angezeigt, der angibt, einer Störungsmeldung HAX Module laden.

Bereitstellung auf Gerät

Um eine app direkt auf das Gerät zu drücken, stellen Sie sicher, dass USB debugging auf dem Gerät wie beschrieben auf der Android Developer-Websiteaktiviert ist, und verwenden Sie einen Mini-USB-Kabel zu, um es an Ihr System anschließen.

Drücken Sie die app auf das Gerät von der Befehlszeile aus:

    $ cordova run android

Abwechselnd innerhalb von Eclipse, Maustaste auf das Projekt, und wählen Sie Ausführen als → Android-Anwendung.