Quelltext der Seite Android Training/Running Your Application/de

<languages />
Wenn du der [[Spezial:MyLanguage/Android Training/Creating an Android Project|vorherigen Übung]] gefolgt bist um ein Android Projekt zu erstellen, enthält es standardmäßig einige "Hello World" Quellcode-Dateien, welche es dir erlauben die App sofort zu starten.

Wie du deine App startest hängt von zwei Dingen ab: Ob du ein real vorhandenes Gerät mit Android hast und ob du Android Studio verwendest. Diese Übung zeigt dir, wie du deine App auf einem realen Gerät und im Android Emulator installierst und startest, sowohl mit Android Studio, als auch mit den Kommandozeilen-Tools.

== Auf einem realen Gerät ausführen ==

Wenn du ein Gerät hast, auf welchem Android installiert ist, findest du hier die Schritte, wie du deine App installierst und startest.

=== Gerät vorbereiten ===
# Verbinde dein Gerät mit einem USB-Kabel mit deinem Entwicklungs-Rechner. Wenn du unter Windows entwickelst benötigst du ggf. die richtigen USB-Treiber für dein Gerät. Für Hilfe zur Installation der Treiber, siehe das [http://developer.android.com/tools/extras/oem-usb.html OEM USB Drivers] Dokument.
# Aktiviere '''[[USB Debugging]]''' bei deinem Gerät.
#* Bei den meisten Geräten, welche Android 3.2 oder älter installiert haben, findest du die Option unter '''EInstellungen > Apps > Entwicklung'''.
#* In Android 4.0 oder neuer, ist die EInstellung in '''Einstellungen > Entwickleroptionen''' zu finden.
#: '''Hinweis:''' In Android 4.2 und neuer sind die '''Entwickleroptionen''' standardmäßig versteckt. Um diese verfügbar zu machen, gehe zu '''Einstellungen > Über das Telefon''' und tippe sieben mal auf '''Build Nummer'''. Kehre dann zurück zur vorherigen Ansicht um '''Entwickleroptionen''' zu finden.

=== Starten der App aus Android Studio ===
# Wähle eine deiner Projektdateien aus und klicke '''Start''' in der Toolbar.
# In dem '''Wähle Gerät''' Fenster, welches erscheint, wähle das '''Wähle ein gestartetes Gerät''' Auswahlfeld aus, selektiere dein Gerät und klicke '''OK'''.

=== Starten der App von der Kommandozeile ===
Öffne ein Kommandozeilen-Fenster und navigiere zum Stammverzeichnis deines Projektes. Verwende Gradle um dein Projekt im Debug-Modus zu erstellen, indem du die <code>assembleDebug</code> Build-Aufgabe mit dem Gradle wrapper Script (<code>gradlew assembleRelease</code>) nutzt.

Das erstellt dir eine Debug <code>.apk</code> Datei mit dem Namen <code>MyFirstApp-debug.apk</code> im module <code>build/</code> Verzeichnis.

Für Windows-Betriebssysteme, führe diesen Befehl aus:
 > gradlew.bat assembleDebug
Für Mac OS und Linux Systeme, führe diese Befehle aus:
 $ chmod +x gradlew
 $ ./gradlew assembleDebug
Nachdem du das Projekt gebaut hast befindet sich die Ausgabe-APK für dein App-Modul im Ordner <code>app/build/outputs/apk/</code>

'''Hinweis:''' Der erste Befehl (<code>chmod</code>) fügt die ausführbar Berechtigung zum Gradle wrapper Script hinzu und wird benötigt, wenn du das Projekt das erste Mal von der Kommandozeile aus baust.

Make sure the Android SDK <code>platform-tools/</code> directory is included in your <code>PATH</code> environment variable, then execute:
 adb install app/build/outputs/MyFirstApp-debug.apk
On your device, locate ''MyFirstApp'' and open it.

That's how you build and run your Android app on a device! To start developing, continue to the [[Spezial:MyLanguage/Android Training/Building a Simple User Interface|next lesson]].

== Run on the Emulator ==
Whether you're using Android Studio or the command line, to run your app on the emulator you need to first create an [[Android Virtual Device]] (AVD). An AVD is a device configuration for the Android emulator that allows you to model a specific device.
[[Datei:Avds-config.png|thumb|'''Figure 1.''' The AVD Manager main screen shows your current virtual devices.]]

=== Create an AVD ===
# Launch the Android Virtual Device Manager:
#* In Android Studio, select '''Tools > Android > AVD Manager''', or click the AVD Manager icon in the toolbar.
#* Or, from the command line, change directories to <code>sdk/</code> and execute:
#: <code>tools/android avd</code>
#: '''Note:''' The AVD Manager that appears when launched from the command line is different from the version in Android Studio, so the following instructions may not all apply.
# On the AVD Manager main screen (figure 1), click '''Create Virtual Device'''.
# In the Select Hardware window, select a device configuration, such as Nexus 6, then click '''Next'''.
# Select the desired system version for the AVD and click '''Next'''.
# Verify the configuration settings, then click '''Finish'''.
For more information about using AVDs, see [http://developer.android.com/tools/devices/managing-avds.html Managing AVDs with AVD Manager].

=== Run the app from Android Studio ===
# In '''Android Studio''', select your project and click '''Run''' from the toolbar.
# In the '''Choose Device''' window, click the '''Launch emulator''' radio button.
# From the '''Android virtual device''' pull-down menu, select the emulator you created, and click '''OK'''.
It can take a few minutes for the emulator to load itself. You may have to unlock the screen. When you do, ''My First App'' appears on the emulator screen.

=== Run your app from the command line ===
# Build the project from the command line. The output APK for the app module is located in<code>app/build/outputs/apk/</code>.
# Make sure the Android SDK <code>platform-tools/</code> directory is included in your <code>PATH</code> environment variable.
# Execute this command:
#: <code>adb install app/build/outputs/MyFirstApp-debug.apk</code>
# On the emulator, locate ''MyFirstApp'' and open it.
That's how you build and run your Android app on the emulator! To start developing, continue to the [[Spezial:MyLanguage/Android Training/Building a Simple User Interface|next lesson]].

{{TNT|Android Training/Attribution}}
[[Kategorie:Android Training]]