Ausführen der Apache Cordova-App unter Android

Artikel
09/11/2015

Die Cordova-Tools sind in Visual Studio 2013 als Preview (CTP) Version veröffentlicht. Die Cordova-Tools werden Als Teil von Visual Studio 2015 veröffentlicht und wir empfehlen, zum Entwickeln von Apps Visual Studio 2015 RTM und die Visual Studio-Tools für Apache Cordova zu verwenden. Sie können Visual Studio aus dem Microsoft Download Center herunterladen.

Es gibt viele Möglichkeiten für die Ausführung Ihrer mit Visual Studio-Tools für Apache Cordova auf Android erstellten Apps. Von Visual Studio aus können Sie Android-Apps auf den folgenden Emulatoren und Geräten ausführen und debuggen:

Apache Ripple-Simulator (in einem separaten Artikel beschrieben)
Visual Studio-Emulator für Android
Android-Emulator
Genymotion-Emulator
Ein mit dem Computer verbundenes Android-Gerät

Informationen zum Umgang mit Fehlern beim Erstellen für Android finden Sie unter Tipps und Problemumgehungen.

Visual Studio-Emulator für Android (Hyper-V)

Befolgen Sie diese Anweisungen, um die App im Visual Studio-Emulator für Android auszuführen. Weitere Informationen zu den Systemanforderungen finden Sie unter Systemanforderungen für den Visual Studio-Emulator für Android

Wichtig

Der Visual Studio-Emulator für Android ist nur in Visual Studio 2015 verfügbar.

So führen Sie Ihre Anwendung auf dem Emulator aus

Stellen Sie sicher, dass Hyper-V auf dem PC aktiviert ist. Ihr PC muss die Systemanforderungen für den Visual Studio-Emulator für Android erfüllen.

Wichtig

Der Emulator wird in einer virtualisierten Umgebung nicht unterstützt.
Öffnen Sie Visual Studio mit der App, und wählen Sie Android aus der Liste der Projektmappenplattformen. Wenn die Liste nicht angezeigt wird, wählen Sie Projektmappenplattformen aus der Liste Schaltflächen hinzufügen/entfernen aus, um diese anzuzeigen.
Wählen Sie einen der Emulatoren aus, z. B. den VS-Emulator 5” KitKat (4.4) XHDPI Phone
Drücken Sie F5, um die App zu starten.

Visual Studio startet den Emulator und führt die Anwendung aus.

Konfigurieren eines Hochleistungs-Emulators (kein Hyper-V)

Wenn Sie über einen PC mit Intel-Prozessor verfügen, können Sie die Leistung der Android- und Genymotion-Emulatoren verbessern. So konfigurieren Sie einen Hochleistungs-Emulator:

Deaktivieren Sie Hyper-V. Sie können dies wie in den folgenden Verfahren beschrieben über die Systemsteuerung oder über eine Befehlszeile erreichen.

Warnung

Aufgrund der Deaktivierung von Hyper-V können Sie den Visual Studio-Emulator für Android und den Windows Phone-Emulator nicht verwenden.Allerdings können Sie weiterhin eine Bereitstellung über ein Windows Phone-Gerät vornehmen, wenn Hyper-V deaktiviert ist.
(Nur für Android-Emulator) Installieren Sie den leistungsstarken Intel Hardware Accelerated Execution Manager (HAXM)-Treiber, sofern dieser noch nicht installiert ist. (Weitere Informationen zum HAXM-Treiber)
Konfigurieren Sie den Android-Emulator, um die Hardwarebeschleunigung nutzen zu können.

So deaktivieren Sie Hyper-V in der Systemsteuerung

Wählen Sie über die Systemsteuerung die Option Programme und Funktionen und anschließend Windows-Funktionen ein- oder ausschalten.
Deaktivieren Sie das Kontrollkästchen für Hyper-V.
Starten Sie Ihren PC neu.

Sie können nun den HAXM-Treiber installieren.

Alternativ können Sie mithilfe der Befehlszeile Windows dergestalt konfigurieren, dass beim Starten Hyper-V automatisch aktiviert oder deaktiviert ist.

So deaktivieren Sie Hyper-V mithilfe der Befehlszeile

Öffnen Sie eine Eingabeaufforderung mit erweiterten Berechtigungen (mit Administratoranmeldeinformationen), und geben Sie Folgendes ein:
```
bcdedit /set hypervisorlaunchtype off
```
Warnung

Mit den Befehlen bcdedit kann verhindert werden, dass das System gestartet wird, wenn es nicht korrekt ausgeführt wird. Verwenden Sie diese Befehle umsichtig.

Wenn Sie einen entsprechenden Befehl zu einem Shell-Skript hinzufügen, verwenden Sie stattdessen Folgendes:
```
bcdedit /set hypervisorlaunchtype off
shutdown /r
```
Starten Sie Ihren PC neu.

Wenn Sie Hyper-V zu einem späteren Zeitpunkt erneut aktivieren möchten, verwenden Sie den folgenden Befehl. Starten Sie Ihren PC anschließend neu:
```
bcdedit /set hypervisorlaunchtype auto
```

Wenn Sie den Genymotion-Emulator verwenden, können Sie dieses Verfahren überspringen. Weitere Informationen finden Sie im Genymotion-Emulator.

So installieren Sie den Hochleistungs-HAXM-Treiber (ausschließlich Android-Emulator)

Öffnen Sie nach dem Deaktivieren von Hyper-V und nach dem Neustart den Android SDK Manager. Wechseln Sie zum Speicherort, und geben Sie android ein, um dies an einer Befehlszeile vorzunehmen.

Unter Windows befindet sich die "Android SDK Manager.exe" unter "C:\Program Files (x86)\Android\android-sdk".
Suchen Sie im Android SDK Manager unter Extras nach dem Intel x86 Emulator Accelerator (HAXM Installer). Wenn in der Statusspalte angezeigt wird, dass dieser nicht installiert ist, aktivieren Sie das entsprechende Kontrollkästchen. Wählen Sie dann Pakete installieren.
Installieren Sie den Treiber, indem Sie zum SDK-Pfad \extras\intel\Hardware_Accelerated_Execution_Manager navigieren und intelhaxm.exe ausführen.

Tipp

Wenn "Intel" nicht im Pfad aufgeführt ist, wurde der Treiber nicht installiert.

Sie können nun einen Emulator konfigurieren, um den Treiber zu verwenden. Wenn Sie einen Emulator erstellen oder bearbeiten, müssen Sie eine Intel-CPU verwenden und die Option Host-GPU verwenden auswählen. Weitere Informationen finden Sie im nächsten Abschnitt.

Android-Emulator

Verwenden Sie vor dem Ausführen der App über den Android-Emulator in Visual Studio den Android Virtual Device (AVD)-Manager, um eine Emulator-Konfiguration vorzunehmen. Starten Sie danach den Emulator über den AVD-Manager. Dies wird in den folgenden Schritten veranschaulicht: Weitere Informationen finden Sie in der AVD-Manager-Dokumentation.

So erstellen Sie eine Instanz des Emulators

Öffnen Sie den AVD-Manager. Wechseln Sie zum Speicherort, und geben Sie android avd ein, um dies an einer Befehlszeile vorzunehmen.

Unter Windows befindet sich die "AVD Manager.exe" unter "C:\Program Files (x86)\Android\android-sdk".
Wählen Sie im AVD-Manager Erstellen aus.
Konfigurieren Sie die Eigenschaften für den neuen Emulator.

Die erforderlichen Eigenschaften lauten AVD-Name, Gerät, Ziel, CPU/ABI und Skin. Ziel stellt eine installierte Version der Android SDK-Version (API-Satz) dar. Stellen Sie diese Eigenschaft auf API-Ebene 19 ein.

Tipp

Wenn Sie andere Android-Geräteversionen emulieren möchten, können Sie die Images mithilfe des Android-SDK-Managers installieren.
Wenn Sie den Hochleistungs-HAXM-Treiber im vorherigen Abschnitt installiert und eine Intel-CPU ausgewählt haben, aktivieren Sie das Kontrollkästchen Host GPU verwenden unter den Emulationsoptionen.

Wichtig

Um den Hochleistungs-Emulator verwenden zu können, müssen Sie auch einen Intel-Prozessor im Abschnitt CPU/ABI des AVD-Dialogfelds auswählen.
Wählen Sie OK, um das Konfigurationsdialogfeld zu schließen. Wählen Sie anschließend erneut OK in jenem Dialogfeld, in dem sämtliche Emulatoreinstellungen angezeigt werden.
Wählen Sie über den AVD-Manager den neuen Emulator aus. Wählen Sie dann Start.

So führen Sie die App im Emulator aus

Öffnen Sie Visual Studio mit der App, und wählen Sie Android aus der Liste der Projektmappenplattformen. (Wenn die Option nicht angezeigt wird, wählen Sie Projektmappenplattformen aus der Liste Schaltflächen hinzufügen/entfernen).
Wählen Sie in der Geräteliste den Android-Emulator.
Drücken Sie F5 zum Starten der App oder UMSCHALT + F5, um die App ohne Debuggen zu starten.

Android 4.4 wird benötigt, um den Debugger anzufügen. Anderenfalls wird die App ohne Debuggen ausgeführt.
Tipp
- Wenn Sie die Fehlermeldung erhalten, dass Sie eine neue Version von Android SDK installieren müssen, installieren Sie diese mit dem Android SDK Manager.Unter Windows können Sie den SDK-Manager öffnen, indem Sie in einer Befehlszeile den folgenden Befehl eingeben: android sdk.
- Über Visual Studio wird die App auf dem Android-Emulator bereitgestellt, der aktuell ausgeführt wird.Wenn kein Emulator ausgeführt wird, startet Visual Studio den letzten Emulator, der mithilfe des AVD-Managers erstellt wurde, und stellt dann die App bereit.
- Wenn Sie die App in Bezug auf die Android-Versionen 4.1.2–4.3 debuggen möchten, finden Sie Informationen über das jsHybugger-Plug-In im Artikel Debuggen der Multi-Device Hybrid-App.

Genymotion-Emulator

Der Genymotion-Emulator stellt eine beliebte Alternative zum Android-Emulator dar, welcher in der Android-SDK enthalten ist. Im Folgenden sind einige Tipps für die ersten Schritte mit dem Emulator aufgeführt:

Wenn beim Start des Emulators über eine Remoteverbindung Probleme auftreten, versuchen Sie diesen lokal zu starten. Stellen Sie bei Bedarf gegebenenfalls erneut eine Remoteverbindung her. Der Emulator benötigt zum Rendern OpenGL. Dies kann beim Starten des Emulators zu einem Konflikt führen.
Sie benötigen eine Grafikkarte und Treiber für die Grafikkarte, welche OpenGL unterstützen. Sie erhalten unter Umständen Meldungen, die darauf hinweisen. (Wenn Sie eine Remoteverbindung zum PC herstellen, wird eine entsprechende Meldung eventuell ebenfalls angezeigt. Wiederholen Sie den Vorgang, nachdem Sie eine lokale Verbindung hergestellt haben.)
Wenn Sie den Emulator zu starten versuchen, erhalten Sie möglicherweise eine Meldung, die auf die Notwendigkeit einer Überprüfung der VirtualBox-Netzwerkkonfiguration hinweist. Folgen Sie dem Link und den Anweisungen zum Ändern oder Entfernen des "Host-only-Netzwerkadapters" aus der VirtualBox. (VirtualBox ist in der Installation des Emulators enthalten.)
Deaktivieren Sie bei einer Hochleistungs-Emulation mit Genymotion Hyper-V vor dem Starten des Emulators wie weiter oben unter Einen Hochleistungs-Emulator konfigurieren beschrieben.

Die Android-Entwickler-Tools erkennen Genymotion als ein physisches Gerät. Wenn Sie Visual Studio verwenden, um die App ausführen, weisen Sie Visual Studio an, die Bereitstellung über ein Android-Gerät vorzunehmen.

So führen Sie die App im Genymotion-Emulator aus

Starten Sie den Genymotion-Emulator.
Öffnen Sie Visual Studio mit der App, und wählen Sie Android aus der Liste der Projektmappenplattformen. Wenn die Option nicht angezeigt wird, wählen Sie Projektmappenplattformen aus der Liste Schaltflächen hinzufügen/entfernen.
Wählen Sie in der Geräteliste das entsprechende Gerät.
Drücken Sie F5 zum Starten der App oder UMSCHALT + F5, um die App ohne Debuggen zu starten.

Android-Geräte

Bevor Sie Visual Studio zum Ausführen der App auf einem verbundenen Android-Gerät verwenden können, müssen Sie den erforderlichen Treiber installieren:

Geräte-spezifischer OEM-Treiber oder
Weitere Informationen zu Google Nexus-Geräten finden Sie unter Google-USB-Treiber

Sie müssen sich außerdem vergewissern, dass sich das Gerät im Entwicklermodus befindet. Anweisungen hierzu finden Sie unter "Aktivieren von Developer-Optionen am Gerät" und "Einrichten eines Geräts für die Entwicklung" auf der Seite Verwenden von Hardwaregeräten auf der Android-Website.

Zum Bereitstellen einer Freigabe- oder Verteilungskonfiguration der App müssen Sie diese zunächst signieren. Weitere Informationen finden Sie unter Packen der App.

So führen Sie die App auf einem Android-Gerät aus

Stellen Sie sicher, dass Sie den erforderlichen OEM- oder Google-USB-Treiber installiert haben.
Vergewissern Sie sich, dass sich das Android-Gerät im Entwicklermodus befindet (siehe Verwenden von Hardwaregeräten auf der Android-Website).
Stellen Sie sicher, dass Adb (Android-Debug-Bridge) das Gerät mithilfe der adb.exe angezeigt.
1. Öffnen Sie eine Visual Studio Developer-Eingabeaufforderung im Administratormodus.
2. Geben Sie folgenden Befehl ein:
```
"%ADT_HOME%\platform-tools\adb.exe" devices
```
  Ihr Gerät sollte wie in der folgenden Liste angezeigt werden.
Öffnen Sie Visual Studio mit der App, und wählen Sie Android aus der Liste der Projektmappenplattformen. (Wenn die Option nicht angezeigt wird, wählen Sie Projektmappenplattformen aus der Liste Schaltflächen hinzufügen/entfernen).
Wählen Sie in der Geräteliste das entsprechende Gerät.
Drücken Sie F5 zum Starten der App oder UMSCHALT + F5, um die App ohne Debuggen zu starten.
Wenn Sie dazu aufgefordert werden, wählen Sie die Option USB-Debugging zulassen.