| Aktuelle Version |
Dein Text |
| Zeile 1: |
Zeile 1: |
| <languages />
| | Wenn Du der [[Android Training/ Ein Android-Projekt erstellen|vorherigen Lektion]] zur Erstellung eines Android-Projektes gefolgt bist, erhält es einige Standard-''Hello World''-Quellcode-Dateien die Dir erlauben deine App sofort zu starten. |
| <translate>
| |
| <!--T:1-->
| |
| If you followed the [[Spezial:MyLanguage/Android Training/Creating an Android Project|previous lesson]] to create an Android project, it includes a default set of "Hello World" source files that allow you to immediately run the app.
| |
|
| |
|
| <!--T:2-->
| | Wie Du deine App ausführst hängt von zwei Dingen ab: ob Du ein echtes Android-Gerät hast und ob Du Eclipse benutzt. Diese Lektion zeigt Dir wie Du Deine App auf einem echten Gerät und im Android Emulator installierst und ausführst, in beiden Fällen jeweils mit Eclipse und Kommandozeilenwerkzeugen. |
| How you run your app depends on two things: whether you have a real device running Android and whether you're using Android Studio. This lesson shows you how to install and run your app on a real device and on the Android emulator, and in both cases with either Android Studio or the command line tools.
| |
|
| |
|
| == Run on a Real Device == <!--T:3-->
| | Bevor Du Deine App startest solltest Du ein paar Verzeichnisse und Dateien in dem Android-Projekt kennen: |
| | ; <code>AndroidManifest.xml</code> : Diese Manifest-Datei beschreibt die grundlegenden Charakteristiken der App und definiert jede ihrer Komponenten. Du wirst verschiedene Deklarationen in dieser Datei lernen wenn du weitere Lektionen liest. |
| | ; <code>src/</code> : Verzeichnis für die Haupt-Quellcode-Dateien deiner App. Standardmäßig enthält es eine <code>[http://developer.android.com/reference/android/app/Activity.html Activity]</code>klasse welche ausgeführt wird wenn deine App über das App-Icon gestartet wird. |
| | ; <code>res/</code> : Enthält einige Unterverzeichnisse für App-Ressourcen. Hier sind ein paar: |
| | :; <code>drawable-hdpi/</code> : Verzeichnis für Grafikobjekte (wie Bitmaps) die für Displays mit hoher Pixeldichte gestaltet wurden. Andere Grafikverzeichnisse enthalten Dateien die für andere Pixeldichten gestaltet sind. |
| | :; <code>layout/</code> : Verzeichnis für Dateien welche die Benutzeroberfläche Deiner App beschreiben. |
| | :; <code>values/</code> : Directory for other various XML files that contain a collection of resources, such as string and color definitions. |
|
| |
|
| <!--T:4--> | | When you build and run the default Android project, the default <code>[http://developer.android.com/reference/android/app/Activity.html Activity]</code> class in the <code>src/</code> directory starts and loads a layout file from the <code>layout/</code> directory, which includes a "Hello World" message. Not real exciting, but it's important that you understand how to build and run your app before adding real functionality to the app. |
| If you have a device running Android, here's how to install and run your app.
| |
|
| |
|
| === Set up your device === <!--T:5--> | | == Run on a Real Device == |
| # Plug in your device to your development machine with a USB cable. If you're developing on Windows, you might need to install the appropriate USB driver for your device. For help installing drivers, see the [http://developer.android.com/tools/extras/oem-usb.html OEM USB Drivers] document.
| |
| # Enable '''USB debugging''' on your device.
| |
| #* On most devices running Android 3.2 or older, you can find the option under '''Settings > Applications > Development'''.
| |
| #* On Android 4.0 and newer, it's in '''Settings > Developer options'''.
| |
| #: '''Note:''' On Android 4.2 and newer, '''Developer options''' is hidden by default. To make it available, go to'''Settings > About phone''' and tap '''Build number''' seven times. Return to the previous screen to find '''Developer options'''.
| |
|
| |
|
| === Run the app from Android Studio === <!--T:6-->
| | Whether you’re using Eclipse or the command line, you need to: |
| # Select one of your project's files and click '''Run''' from the toolbar.
| |
| # In the '''Choose Device''' window that appears, select the '''Choose a running device''' radio button, select your device, and click '''OK''' .
| |
| Android Studio installs the app on your connected device and starts it.
| |
|
| |
|
| === Run the app from a command line === <!--T:7-->
| | # Plug in your Android-powered device to your machine with a USB cable. If you’re developing on Windows, you might need to install the appropriate USB driver for your device. For help installing drivers, see the [http://developer.android.com/tools/extras/oem-usb.html OEM USB Drivers] document. |
| Open a command-line and navigate to the root of your project directory. Use Gradle to build your project in debug mode, invoke the <code>assembleDebug</code> build task using the Gradle wrapper script (<code>gradlew assembleRelease</code>).
| | # Ensure that '''USB debugging''' is enabled in the device Settings (open Settings and navitage to '''Applications > Development''' on most devices, or select '''Developer options''' on Android 4.0 and higher). |
|
| |
|
| <!--T:8-->
| | To run the app from Eclipse, open one of your project's files and click '''Run''' from the toolbar. Eclipse installs the app on your connected device and starts it. |
| This creates your debug <code>.apk</code> file inside the module <code>build/</code> directory, named <code>MyFirstApp-debug.apk</code>.
| |
|
| |
|
| <!--T:9-->
| | Or to run your app from a command line: |
| On Windows platforms, type this command:</translate>
| |
| > gradlew.bat assembleDebug
| |
| <translate>
| |
| <!--T:10-->
| |
| On Mac OS and Linux platforms, type these commands:</translate>
| |
| $ chmod +x gradlew
| |
| $ ./gradlew assembleDebug
| |
| <translate>
| |
| <!--T:11-->
| |
| After you build the project, the output APK for the app module is located in <code>app/build/outputs/apk/</code>
| |
|
| |
|
| <!--T:12--> | | # Change directories to the root of your Android project and execute:<pre>ant debug</pre> |
| '''Note:''' The first command (<code>chmod</code>) adds the execution permission to the Gradle wrapper script and is only necessary the first time you build this project from the command line. | | # Make sure the Android SDK <code>platform-tools/</code> directory is included in your <code>PATH</code> environment variable, then execute:<pre>adb install bin/MyFirstApp-debug.apk</pre> |
| | # On your device, locate ''MyFirstActivity'' and open it. |
|
| |
|
| <!--T:13-->
| | To start adding stuff to the app, continue to the [[Android Training/ Eine einfache Benutzeroberfläche erstellen|next lesson]]. |
| Make sure the Android SDK <code>platform-tools/</code> directory is included in your <code>PATH</code> environment variable, then execute:</translate>
| |
| adb install app/build/outputs/MyFirstApp-debug.apk
| |
| <translate>
| |
| <!--T:14-->
| |
| On your device, locate ''MyFirstApp'' and open it.
| |
|
| |
|
| <!--T:15-->
| | == Run on the Emulator == |
| 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]].
| | Whether you’re using Eclipse or the command line, you need to first create an [http://developer.android.com/tools/devices/index.html Android Virtual Device] (AVD). An AVD is a device configuration for the Android emulator that allows you to model different device configurations. |
| | [[Datei:Avds-config.png|thumb|The AVD Manager showing a few virtual devices.]] |
| | To create an AVD: |
|
| |
|
| == Run on the Emulator == <!--T:16-->
| | # Launch the Android Virtual Device Manager: |
| 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.
| | ## In Eclipse, select '''Window > AVD Manager''', or click the ''AVD Manager'' icon in the Eclipse toolbar. |
| [[Datei:Avds-config.png|thumb|'''Figure 1.''' The AVD Manager main screen shows your current virtual devices.]]
| | ## From the command line, change directories to <code><sdk>/tools/</code> and execute:<pre>./android avd</pre> |
| | # In the ''Android Virtual Device Device Manager'' panel, click '''New'''. |
| | # Fill in the details for the AVD. Give it a name, a platform target, an SD card size, and a skin (HVGA is default). |
| | # Click '''Create AVD'''. |
| | # Select the new AVD from the ''Android Virtual Device Manager'' and click '''Start'''. |
| | # After the emulator boots up, unlock the emulator screen. |
|
| |
|
| === Create an AVD === <!--T:17-->
| | To run the app from Eclipse, open one of your project's files and click '''Run''' from the toolbar. Eclipse installs the app on your AVD and starts it. |
| # Launch the Android Virtual Device Manager:
| | |
| #* In Android Studio, select '''Tools > Android > AVD Manager''', or click the AVD Manager icon in the toolbar.
| | Or to run your app from the command line: |
| #* Or, from the command line, change directories to <code>sdk/</code> and execute:</translate>
| |
| #: <code>tools/android avd</code>
| |
| #: <translate><!--T:18-->
| |
| '''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 === <!--T:19-->
| | # Change directories to the root of your Android project and execute:<pre>ant debug</pre> |
| # In '''Android Studio''', select your project and click '''Run''' from the toolbar. | | # Make sure the Android SDK <code>platform-tools/</code> directory is included in your <code>PATH</code> environment variable, then execute:<pre>adb install bin/MyFirstApp-debug.apk</pre> |
| # In the '''Choose Device''' window, click the '''Launch emulator''' radio button.
| | # On the emulator, locate ''MyFirstActivity'' and open it. |
| # 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 === <!--T:20-->
| | To start adding stuff to the app, continue to the [[Android Training/ Eine einfache Benutzeroberfläche erstellen|next lesson]]. |
| # 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:</translate>
| |
| #: <code>adb install app/build/outputs/MyFirstApp-debug.apk</code>
| |
| # <translate><!--T:21-->
| |
| 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]].
| |
| </translate>
| |
|
| |
|
| {{TNT|Android Training/Attribution}} | | {{Android Training/ Vorlage:Attribution}} |
| [[Kategorie:Android Training]]
| |
