Wenn Sie Ihren Code ausführen, debuggen oder testen, verwendet Android Studio eine Run/Debug-Konfiguration, um zu bestimmen, wie der Vorgang ausgeführt werden soll. Normalerweise reicht die anfänglich erstellte Konfiguration aus, um eine App auszuführen oder zu debuggen. Sie können jedoch Konfigurationen ändern und neue erstellen sowie die Konfigurationsvorlagen an Ihren Entwicklungsprozess anpassen, wie auf dieser Seite beschrieben.
Weitere Informationen finden Sie auch in der folgenden IntelliJ-Dokumentation:
Ausführungs-/Fehlerbehebungskonfigurationen
In Ausführungs-/Fehlerbehebungskonfigurationen werden Details wie App-Installation, Start und Testoptionen angegeben. Sie können eine Konfiguration für die einmalige Verwendung definieren oder für die zukünftige Verwendung speichern. Nach dem Speichern können Sie die Konfiguration in der Symbolleiste in der Drop-down-Liste Konfiguration zum Ausführen/Debuggen auswählen auswählen. In Android Studio werden Konfigurationen als Teil des Projekts gespeichert.
Ursprünglich erstellte Ausführungs-/Fehlerbehebungskonfiguration
Wenn Sie ein Projekt zum ersten Mal erstellen, wird in Android Studio eine Konfiguration zum Ausführen/Debuggen für die Hauptaktivität auf Grundlage der Android-App-Vorlage erstellt. Zum Ausführen oder Debuggen Ihres Projekts muss immer mindestens eine Ausführungs-/Debugkonfiguration definiert sein. Aus diesem Grund empfehlen wir, die ursprünglich erstellte Konfiguration nicht zu löschen.
Projektumfang und Versionskontrolle
Ausführungs-/Fehlerbehebungskonfigurationen und Vorlagenänderungen gelten nur für das aktuelle Projekt. Sie können eine Run/Debug-Konfiguration (aber keine Vorlage) über Ihr Versionskontrollsystem freigeben. Weitere Informationen zum Freigeben einer Konfiguration finden Sie unter Konfigurationsoptionen benennen und freigeben.
Dialogfeld „Run/Debug Configurations“ öffnen
Wählen Sie Run > Edit Configurations aus, um das Dialogfeld „Run/Debug Configurations“ (Ausführungs-/Fehlerbehebungskonfigurationen) zu öffnen. Das Dialogfeld Run/Debug Configurations (Konfigurationen für Ausführung/Fehlerbehebung) wird angezeigt (siehe Abbildung 1).
Abbildung 1. Das Dialogfeld Run/Debug Configurations
Im linken Bereich des Dialogfelds werden Ihre definierten Konfigurationen nach Vorlagentyp gruppiert. Unten können Sie Konfigurationsvorlagen bearbeiten. Sie können die ausgewählte Konfiguration im rechten Bereich bearbeiten. Ändern Sie die Größe des Dialogfelds, um ausgeblendete Elemente zu sehen.
In diesem Dialogfeld haben Sie folgende Möglichkeiten:
- Neue Ausführungs-/Fehlerbehebungskonfigurationen erstellen
- Ausführungs-/Fehlerbehebungskonfigurationen bearbeiten
- Konfigurationsvorlagen bearbeiten
- Konfigurationen sortieren und gruppieren
Neue Ausführungs-/Fehlerbehebungskonfiguration erstellen
Sie können neue Run/Debug-Konfigurationen über das Dialogfeld Run/Debug Configurations, das Fenster Project oder den Code-Editor definieren. Die neue Konfiguration muss auf einer Konfigurationsvorlage basieren.
Im Dialogfeld „Run/Debug Configurations“ (Konfigurationen zum Ausführen/Debuggen) werden Ihre Konfigurationen zum Ausführen/Debuggen und die verfügbaren Konfigurationsvorlagen angezeigt. Sie können eine neue Konfiguration direkt aus einer Vorlage oder aus einer Kopie einer anderen Konfiguration erstellen. Anschließend können Sie die Feldwerte nach Bedarf ändern.
Alternativ können Sie mit der rechten Maustaste auf ein Element im Fenster Projekt klicken, um automatisch eine Konfiguration für dieses Element zu erstellen. Wenn Sie beispielsweise eine bestimmte Aktivität ausführen möchten, können Sie mit der rechten Maustaste auf die Java-Datei der Aktivität klicken und Ausführen auswählen. Je nach Element verwendet Android Studio eine Konfigurationsvorlage für Android-Apps, instrumentierte Android-Tests oder JUnit, um die Konfiguration zu erstellen.
Im Code Editor können Sie ganz einfach eine Test- und Ausführungs-/Debugkonfiguration für eine Klasse oder Methode erstellen und dann ausführen.
Wenn Sie eine Konfiguration außerhalb des Dialogfelds Run/Debug Configurations erstellen, ist sie temporär, sofern Sie sie nicht speichern. Standardmäßig können Sie bis zu fünf temporäre Konfigurationen im Projekt haben, bevor Android Studio sie entfernt. Wenn Sie diese Standardeinstellung ändern möchten, öffnen Sie die Android Studio-Einstellungen und ändern Sie Erweiterte Einstellungen > Ausführen/Debuggen > Limit für temporäre Konfigurationen. Weitere Informationen zu temporären Konfigurationen finden Sie unter Temporäre Ausführungs-/Debugkonfigurationen erstellen und speichern.
Konfiguration auf Grundlage einer Vorlage starten
So definieren Sie eine Konfiguration für das Ausführen/Debuggen basierend auf einer Vorlage:
- Dialogfeld „Run/Debug Configurations“ öffnen
- Klicken Sie auf Neue Konfiguration hinzufügen
.
- Wählen Sie eine Konfigurationsvorlage aus.
- Geben Sie in das Feld Name einen Namen ein.
- Ändern Sie die Konfiguration nach Bedarf.
- Klicken Sie auf Übernehmen oder OK.
Korrigieren Sie ggf. alle Fehler, die unten im Dialogfeld angezeigt werden.
Konfiguration aus einer Kopie starten
So definieren Sie eine Run/Debug-Konfiguration auf Grundlage einer Kopie einer anderen Konfiguration:
- Dialogfeld „Run/Debug Configurations“ öffnen
- Wählen Sie im linken Bereich eine vorhandene Ausführungs-/Debugkonfiguration aus.
- Klicken Sie auf Konfiguration kopieren
.
- Geben Sie in das Feld Name einen Namen ein.
- Ändern Sie die Konfiguration nach Bedarf.
- Klicken Sie auf Übernehmen oder OK.
Korrigieren Sie ggf. alle Fehler, die unten im Dialogfeld angezeigt werden.
Konfiguration für ein Element im Projekt definieren
Android Studio kann für einige Elemente, die im Fenster Project angezeigt werden, eine Konfiguration zum Ausführen/Debuggen erstellen. Die Konfiguration basiert auf einer Konfigurationsvorlage:
- Java-Datei für die Aktivität: Die Vorlage Android-App.
- Paket: Android Instrumented Tests oder Android JUnit-Vorlage, je nach Quellgruppe. Wenn Sie einen instrumentierten Test auswählen, wird die Vorlage „Android Instrumented Tests“ verwendet. Wenn Sie einen lokalen Einheitentest auswählen, wird die Android JUnit-Vorlage verwendet. Für einen lokalen Unittest können Sie optional die Codeabdeckung verwenden. Weitere Informationen finden Sie unter Code Coverage.
So erstellen Sie eine Run/Debug-Konfiguration für ein Element in Ihrem Projekt:
- Öffnen Sie ein Projekt in der Android- oder Projektansicht.
- Klicken Sie im Fenster Project (Projekt) mit der rechten Maustaste auf ein testbares Element und wählen Sie entweder Run filename (Ausführen filename) oder Debug filename (Debuggen filename) aus. Android Studio erstellt eine temporäre Ausführungs-/Fehlerbehebungskonfiguration und startet Ihre App.
- Öffnen Sie in der Symbolleiste die Drop-down-Liste Select Run/Debug Configuration (Ausführungs-/Fehlerbehebungskonfiguration auswählen).
- Wählen Sie in den Optionen neben der Konfiguration, die Sie speichern möchten, Konfiguration speichern aus.
Abbildung 2: Konfiguration speichern
Hinweis:Wenn Sie mit der rechten Maustaste auf dasselbe Element (aber nicht auf eine Aktivität) klicken und es ausführen oder debuggen, erstellt Android Studio eine neue Konfiguration.
Testkonfiguration für eine Klasse oder Methode definieren
In Android Studio können Sie eine Testlaufkonfiguration für eine Klasse oder Methode definieren und dann ausführen. Wenn Sie beispielsweise eine neue Klasse erstellen, können Sie einen Test dafür erstellen und ausführen. Wenn der Test erfolgreich ist, können Sie die Tests für den Rest des Projekts ausführen, um sicherzustellen, dass Ihr neuer Code an anderer Stelle nichts beschädigt.
In Android Studio wird je nach Quellset die Vorlage Android Instrumented Tests oder Android JUnit verwendet. Für einen lokalen Einheitentest können Sie optional Code Coverage ausführen.
So erstellen Sie eine Run/Debug-Konfiguration für eine Klasse oder Methode in Ihrem Java-Code:
- Öffnen Sie ein Projekt in der Android- oder Projektansicht.
- Öffnen Sie eine Java-Datei im Code-Editor.
- Wählen Sie eine Klasse oder Methode im Code aus und drücken Sie dann Strg+Umschalt+T (Befehlstaste+Umschalt+T).
- Wählen Sie im angezeigten Menü Neuen Test erstellen aus.
- Ändern oder legen Sie im Dialogfeld Test erstellen optional die Werte fest und klicken Sie auf OK.
- Wählen Sie im Dialogfeld Zielverzeichnis auswählen aus, wo in Ihrem Projekt Android Studio den Test platzieren soll. Sie können den Speicherort über die Verzeichnisstruktur oder durch Auswahl einer benachbarten Klasse angeben.
- Klicken Sie auf OK.
Der neue Test wird im Fenster Project im entsprechenden Testquellenset angezeigt.
- Führen Sie den Test auf eine der folgenden Arten aus:
- Klicken Sie im Fenster Project (Projekt) mit der rechten Maustaste auf den Test und wählen Sie Run (Ausführen) oder Debug (Fehlerbehebung) aus.
- Klicken Sie im Code-Editor mit der rechten Maustaste auf eine Klassendefinition oder einen Methodennamen in der Testdatei und wählen Sie Ausführen oder Debuggen aus, um alle Methoden in der Klasse zu testen.
- Öffnen Sie in der Symbolleiste die Drop-down-Liste Select Run/Debug Configuration (Ausführungs-/Fehlerbehebungskonfiguration auswählen).
- Wählen Sie in den Optionen neben der Konfiguration, die Sie speichern möchten, Konfiguration speichern aus.
Abbildung 3: Konfiguration speichern
App mit einer gespeicherten Konfiguration ausführen oder debuggen
Wenn Sie eine Ausführungs-/Fehlerbehebungskonfiguration gespeichert haben, können Sie sie auswählen, bevor Sie Ihre App ausführen oder Fehler in ihr beheben.
So verwenden Sie eine gespeicherte Konfiguration zum Ausführen/Debuggen:
- Wählen Sie die Ausführungs-/Debugkonfiguration in der Drop-down-Liste Ausführungs-/Debugkonfiguration auswählen in der Symbolleiste aus.
- Wählen Sie Run > Run (Ausführen > Ausführen) oder Run > Debug (Ausführen > Debuggen) aus.
Die Drop-down-Liste befindet sich links neben Ausführen
und Fehlerbehebung
, z. B. 
.
Alternativ können Sie auch auf Ausführen oder Debuggen
klicken.
Ausführungs-/Fehlerbehebungskonfiguration bearbeiten
So bearbeiten Sie eine Run/Debug-Konfiguration:
- Dialogfeld „Run/Debug Configurations“ öffnen
- Wählen Sie im linken Bereich eine Konfiguration aus.
- Ändern Sie die Konfiguration nach Bedarf.
- Klicken Sie auf Übernehmen oder OK.
Korrigieren Sie ggf. alle Fehler, die unten im Dialogfeld angezeigt werden.
Vorlage für Ausführungs-/Fehlerbehebungskonfiguration bearbeiten
Sie können die von Android Studio bereitgestellten Konfigurationsvorlagen an Ihren Entwicklungsprozess anpassen. Wenn Sie eine Vorlage bearbeiten, hat das keine Auswirkungen auf vorhandene Konfigurationen, in denen die Vorlage verwendet wird. Wenn Sie beispielsweise mehrere Konfigurationen eines bestimmten Typs erstellen müssen, können Sie die Vorlage bearbeiten und sie dann wieder ändern, wenn Sie fertig sind.
Sie können zwar keine neuen Vorlagen erstellen, aber Konfigurationen, die Sie ähnlich wie eine Vorlage verwenden können. Sie können eine Konfiguration kopieren und die Kopie bearbeiten, um neue Konfigurationen zu erstellen.
So bearbeiten Sie eine Vorlage:
- Dialogfeld „Run/Debug Configurations“ öffnen
- Klicken Sie auf Konfigurationsvorlagen bearbeiten….
- Wählen Sie eine Konfigurationsvorlage aus.
- Ändern Sie die Konfiguration nach Bedarf.
- Klicken Sie auf Übernehmen oder OK.
Korrigieren Sie ggf. alle Fehler, die unten im Dialogfeld angezeigt werden.
Konfigurationen sortieren und gruppieren
Im Dialogfeld Run/Debug Configurations können Sie Ihre Konfigurationen sortieren, um sie schnell zu finden. Sie können die Elemente im Ordner alphabetisch sortieren und neue Ordner erstellen, um Konfigurationen zu gruppieren.
So sortieren Sie Konfigurationen alphabetisch:
- Dialogfeld „Run/Debug Configurations“ öffnen
- Wählen Sie einen Ordner mit Konfigurationen aus.
- Klicken Sie auf Konfigurationen sortieren
.
- Klicken Sie auf OK, um das Dialogfeld zu schließen.
So gruppieren Sie Konfigurationen in Ordnern:
- Dialogfeld „Run/Debug Configurations“ öffnen
- Wählen Sie einen Ordner mit Konfigurationen aus.
- Klicken Sie auf Neuen Ordner erstellen
.
- Geben Sie in das Feld Ordnername einen Namen ein.
- Klicken Sie auf Übernehmen, um den Namen zu speichern.
Vorgänge vor dem Start definieren
Sie können Aufgaben angeben, die vor dem Anwenden der Ausführungs-/Debugkonfiguration ausgeführt werden sollen. Die Aufgaben werden in der Reihenfolge ausgeführt, in der sie in der Liste aufgeführt sind.
Hinweis:Das Definieren von Aufgaben vor der Einführung ist eine erweiterte Funktion. Statt diese Funktion zu verwenden, empfehlen wir, die Vorbereitungslogik als Aufgaben in Ihre build.gradle-Datei aufzunehmen, damit sie ausgeführt werden, wenn Sie über die Befehlszeile erstellen.
So erstellen Sie eine Aufgabenliste:
- Klicken Sie unten im Dialogfeld Ausführungs-/Fehlerbehebungskonfigurationen unter Vor dem Start (möglicherweise müssen Sie nach unten scrollen) auf Hinzufügen und wählen Sie einen Aufgabentyp aus. Füllen Sie im angezeigten Dialogfeld die Felder aus und klicken Sie auf OK.
- Fügen Sie nach Bedarf weitere Aufgaben hinzu.
- Wenn Sie die Reihenfolge der Aufgaben ändern möchten, ziehen Sie sie an die gewünschte Position oder wählen Sie eine Aufgabe aus und klicken Sie auf Nach oben
oder Nach unten
, um sie in der Liste nach oben oder unten zu verschieben. - Wählen Sie Show this page (Diese Seite anzeigen) aus, wenn Sie die Einstellungen für die Ausführungs-/Debugkonfiguration vor dem Anwenden sehen möchten.
Diese Option ist standardmäßig deaktiviert.
- Wählen Sie Active tool window (Aktives Toolfenster) aus, wenn das Toolfenster Run (Ausführen) oder Debug (Debuggen) aktiviert werden soll, wenn Sie Ihre App ausführen oder debuggen.
Diese Option ist standardmäßig aktiviert.
So entfernen Sie eine Aufgabe aus der Liste:
- Wählen Sie eine Aufgabe aus.
- Klicken Sie auf Entfernen
.
So bearbeiten Sie eine Aufgabe:
- Wählen Sie eine Aufgabe aus.
- Klicken Sie auf Bearbeiten
.
- Bearbeiten Sie die Aufgabeneinstellungen im Dialogfeld, das geöffnet wird, und klicken Sie dann auf OK.
In der folgenden Tabelle sind die verfügbaren Aufgaben aufgeführt, die Sie hinzufügen können.
| Aufgabe | Beschreibung |
|---|---|
| Externes Tool ausführen | Eine Anwendung ausführen, die sich außerhalb von Android Studio befindet Wählen Sie im Dialogfeld Externe Tools eine oder mehrere Anwendungen aus, die Sie ausführen möchten, und klicken Sie dann auf OK. Wenn die Anwendung noch nicht in Android Studio definiert ist, fügen Sie ihre Definition im Dialogfeld Create Tools (Tools erstellen) hinzu. Weitere Informationen finden Sie unter Drittanbietertools konfigurieren und Externe Tools. |
| Weitere Konfiguration ausführen | Führen Sie eine der vorhandenen Ausführungs-/Fehlerbehebungskonfigurationen aus. Wählen Sie im Dialogfeld Choose Configuration to Execute (Auszuführende Konfiguration auswählen) eine Konfiguration aus und klicken Sie dann auf OK. |
| Marke | Kompilieren Sie das Projekt oder das Modul. Android Studio führt den Make Module command (Befehl „Modul erstellen“) aus, wenn in der Run/Debug-Konfiguration ein bestimmtes Modul angegeben ist. Andernfalls wird der Make Project command (Befehl „Projekt erstellen“) ausgeführt. |
| Projekt erstellen | Kompilieren Sie das Projekt. In Android Studio wird der Make Project-Befehl ausgeführt. |
| Erstellen, keine Fehlerprüfung | Diese Option entspricht Make, mit dem Unterschied, dass Android Studio die Ausführungs-/Debugkonfiguration unabhängig vom Kompilierungsergebnis ausführt. |
| Build-Artefakte | Wird in Android Studio nicht unterstützt. |
| Gradle-Aufgabe ausführen | Führen Sie eine Gradle-Aufgabe aus. Geben Sie im Dialogfeld, das sich öffnet, die Details an und klicken Sie dann auf OK. Weitere Informationen finden Sie unter Gradle. |
| Gradle-kompatibles Make | Kompiliere das Projekt und führe Gradle aus. |
| App Engine-Gradle-Builder | Die App Engine-Gradle-Builder-Aufgabe synchronisiert das Projekt und erstellt dann das Modul. |
Konfigurationsvorlagen
Android Studio bietet Konfigurationsvorlagen, die Ihnen den Einstieg erleichtern. In den folgenden Abschnitten werden die Vorlagen beschrieben, die für die Android-Entwicklung mit Android Studio gelten:
Hinweis:In Android Studio 2.1.x und niedriger gab es eine Vorlage für native Anwendungen, die in neueren Versionen nicht mehr vorhanden ist. Wenn Sie in einem Projekt eine Vorlage für eine native Anwendung haben, wird diese beim Laden des Projekts von Android Studio in eine Android-App konvertiert. Ein Dialogfeld Convert Project (Projekt konvertieren) führt Sie durch den Prozess.
Nicht unterstützte Vorlagen
Die folgenden nicht unterstützten Vorlagen stammen aus IntelliJ IDEA und sind nicht spezifisch für die Android-Entwicklung mit Android Studio. Informationen zur Verwendung dieser Vorlagen finden Sie in der IntelliJ IDEA-Dokumentation.
- Anwendung
- Compound
- Gradle
- Groovy
- JAR-Anwendung
- Java Scratch
- JUnit
- Kotlin
- Kotlin-Skript
- Remote Debug
- Shell-Skript
- TestNG
Häufig verwendete Konfigurationsoptionen
Die Optionen Name, Parallelen Lauf zulassen und Als Projektdatei speichern sind für mehrere Konfigurationsvorlagen verfügbar. Weitere Informationen zu den allgemeinen Einstellungen
Android Studio speichert die freigegebene Ausführungs-/Debugkonfiguration in einzelnen XML-Dateien im Ordner project_directory/.idea/runConfigurations/.
Weitere Informationen finden Sie in der IntelliJ-Projektdokumentation unter Verzeichnisbasiertes Format.
Android-App
Sie können Android-Apps und ‑Aktivitäten auf virtuellen oder Hardwaregeräten ausführen oder debuggen, indem Sie Konfigurationen verwenden, die auf dieser Vorlage basieren.
Allgemein
Auf dem Tab Allgemein können Sie Installations-, Start- und Bereitstellungsoptionen festlegen. Der Tab Sonstiges enthält auch Installationsoptionen.
| Feld | Beschreibung |
|---|---|
| Modul | Wählen Sie ein Modul aus, auf das diese Konfiguration angewendet werden soll. |
| Installationsoptionen: Bereitstellen | Entscheiden Sie sich für eine Option:
|
| Installationsoptionen: Als Instant-App bereitstellen | Wenn Ihre App Instant-Funktionen unterstützt, d. h., wenn Sie beim Erstellen eines neuen Projekts Unterstützung für Instant Apps hinzufügen oder ein oder mehrere für Instant Apps aktivierte Funktionsmodule erstellen, können Sie diese Module bereitstellen, indem Sie das Kästchen neben Als Instant App bereitstellen anklicken. |
| Installationsoptionen: Bereitzustellende Funktionen |
Wenn Ihre App Funktionsmodule enthält, setzen Sie ein Häkchen neben jeder Funktion, die Sie bei der Bereitstellung Ihrer App einbeziehen möchten. Diese Option wird nur angezeigt, wenn Ihre App Funktionsmodule enthält.
Hinweis:Wenn Sie das Herunterladen und Installieren von Funktionsmodulen auf Anfrage testen möchten, müssen Sie dies nach der Veröffentlichung Ihres App-Bundles über den internen Test-Track der Play Console tun. Weitere Informationen |
| Installationsoptionen: Install-Flags | Geben Sie die gewünschten pm
install-Optionen für ADB ein. Formatieren Sie die Optionen genauso wie in der Befehlszeile, aber ohne Pfad. Hier einige Beispiele:
und
Standard: keine Optionen. |
| Startoptionen: Starten | Entscheiden Sie sich für eine Option:
|
| Startoptionen: Start-Flags | Geben Sie die gewünschten am
start-Optionen für ADB ein. Formatieren Sie die Optionen so, wie Sie es in der Befehlszeile tun würden, aber ohne Intention. Beispiel:
Diese Option wird nicht angezeigt, wenn Sie für Starten den Wert Nichts ausgewählt haben. Standard: keine Optionen. |
| Optionen für das Bereitstellungsziel: Ziel | Entscheiden Sie sich für eine Option:
|
Optionen für das Bereitstellungsziel: Dasselbe Gerät für zukünftige Starts verwenden |
Standardmäßig ist diese Option deaktiviert, sodass bei jedem Ausführen einer App das Dialogfeld Bereitstellung auswählen angezeigt wird, in dem Sie ein Gerät auswählen können. Wenn Sie diese Option auswählen und dann eine App ausführen, wird das Dialogfeld Select Deployment (Bereitstellung auswählen) angezeigt, in dem Sie ein Gerät auswählen können. Wenn Sie die App dann ausführen, wird sie auf dem ausgewählten Gerät gestartet, ohne dass das Dialogfeld Select Deployment (Bereitstellung auswählen) angezeigt wird. Wenn Sie die App auf einem anderen Gerät ausführen möchten, deaktivieren Sie entweder Use same device for future launches (Für zukünftige Starts dasselbe Gerät verwenden) oder beenden Sie die App mit Run > Stop app (Ausführen > Beenden) oder Stop  (Beenden) und starten Sie sie dann noch einmal. Das Dialogfeld Bereitstellung auswählen wird angezeigt, damit Sie ein Gerät auswählen können.
|
| vor Markteinführung | Weitere Informationen finden Sie unter Before Launch Operations definieren. |
Tab „Sonstiges“
Auf dem Tab Sonstiges können Sie Optionen für Logcat, Installation, Start und Bereitstellung angeben. Der Tab Allgemein enthält auch Installationsoptionen.
| Feld | Beschreibung |
|---|---|
| Logcat: Logcat automatisch anzeigen | Wenn diese Option ausgewählt ist, wird das Fenster Logcat jedes Mal geöffnet, wenn Sie eine App mit dieser Konfiguration bereitstellen und starten. Standardeinstellung: ausgewählt. |
| Logcat: Protokoll vor dem Start löschen | Wählen Sie diese Option aus, wenn Android Studio Daten aus vorherigen Sitzungen aus der Logdatei entfernen soll, bevor die App gestartet wird. Standard: deaktiviert. |
| Installationsoptionen: Installation überspringen, wenn sich das APK nicht geändert hat. | Wenn diese Option ausgewählt ist, wird Ihr APK nicht noch einmal bereitgestellt, wenn Android Studio erkennt, dass es sich nicht geändert hat. Wenn Sie möchten, dass Android Studio die Installation des APK erzwingt, auch wenn es sich nicht geändert hat, deaktivieren Sie diese Option. Standard: ausgewählt |
| Installationsoptionen: Ausführung der App erzwingen, bevor die Aktivität gestartet wird | Wenn diese Option ausgewählt ist und Android Studio erkennt, dass ein APK nicht neu installiert werden muss, weil es sich nicht geändert hat, wird die App beendet, damit sie über die Standard-Launcher-Aktivität gestartet wird. Wenn diese Option deaktiviert ist, wird die App nicht von Android Studio beendet. Diese Option funktioniert in Kombination mit der vorherigen Option, mit der gesteuert wird, ob ein APK installiert wird oder nicht. Lassen Sie beide Felder unter Installationsoptionen auf dem Standardwert, es sei denn, Sie möchten die Installation jedes Mal erzwingen. In einigen Fällen kann es sinnvoll sein, diese Option zu deaktivieren. Wenn Sie beispielsweise eine Eingabemethode (Input Method Engine, IME) entwickeln, wird die App durch das Erzwingen des Beendens als aktuelle Tastatur abgewählt, was Sie möglicherweise nicht möchten. Standard: ausgewählt |
| vor Markteinführung | Weitere Informationen finden Sie unter Vorgänge vor dem Start definieren. |
Tab „Debugger“
Geben Sie die Debugging-Optionen auf dem Tab Debugger an.
Für C- und C++-Code verwendet Android Studio den LLDB-Debugger. Zusätzlich zur normalen Android Studio-Benutzeroberfläche hat das Debugger-Fenster einen LLDB-Tab, auf dem Sie während des Debuggens LLDB-Befehle eingeben können. Sie können dieselben Befehle eingeben, die Android Studio verwendet, um Informationen in der Debugger-Benutzeroberfläche anzuzeigen, und zusätzliche Vorgänge ausführen.
Bei C- und C++-Projekten können Sie auf dem Tab Debugger Symbolverzeichnisse sowie LLDB-Start- und Post-Attach-Befehle hinzufügen. Dazu verwenden Sie Schaltflächen wie die folgenden:
- Hinzufügen
– Ein Verzeichnis oder ein Befehl wird hinzugefügt.
- Entfernen
– Wählen Sie ein Verzeichnis oder einen Befehl aus und klicken Sie dann auf diese Schaltfläche, um das Element zu entfernen.
- Nach oben
– Wählen Sie ein Verzeichnis oder einen Befehl aus und klicken Sie dann auf diese Schaltfläche, um das Element in der Liste nach oben zu verschieben.
- Nach unten
– Wählen Sie ein Verzeichnis oder einen Befehl aus und klicken Sie dann auf diese Schaltfläche, um das Element in der Liste nach unten zu verschieben.
Weitere Informationen zum Debuggen in Android Studio finden Sie unter App debuggen.
| Feld | Beschreibung |
|---|---|
| Debug-Typ | Wählen Sie eine der folgenden Optionen aus:
Die Option Automatisch erkennen wird empfohlen, da sie den richtigen Debugging-Typ für Ihr Projekt auswählt. |
| Symbolverzeichnisse | Wenn Sie Symboldateien hinzufügen möchten, um dem Debugger C- oder C++-Informationen zur Verfügung zu stellen, die außerhalb von Android Studio generiert wurden, können Sie hier ein oder mehrere Verzeichnisse hinzufügen. Android Studio verwendet vorzugsweise alle Dateien in diesen Verzeichnissen anstelle von Dateien, die vom Android-Plugin für Gradle generiert wurden. Der Debugger durchsucht die Verzeichnisse von oben nach unten, bis er findet, was er benötigt. Es wird rekursiv in den Dateien im Verzeichnis gesucht. Um die Liste zu optimieren und Zeit zu sparen, sollten Sie die am häufigsten verwendeten Verzeichnisse oben in der Liste platzieren. Wenn Sie ein Verzeichnis weiter oben in der Struktur angeben, kann es länger dauern, alle Unterverzeichnisse zu durchsuchen. Wenn Sie ein sehr spezifisches Verzeichnis hinzufügen, dauert die Suche weniger lange. Sie müssen das richtige Gleichgewicht zwischen Geschwindigkeit und dem Auffinden der für das Debugging erforderlichen Dateien finden. Wenn Sie beispielsweise ein Verzeichnis mit Unterverzeichnissen für verschiedene Android Binary Interfaces (ABIs) haben, können Sie ein Verzeichnis für eine bestimmte oder für alle ABIs hinzufügen. Die Suche im übergeordneten Verzeichnis kann zwar länger dauern, ist aber auch sicherer, wenn Sie auf einem anderen Gerät debuggen möchten. Sie müssen keine Verzeichnisse mit Gradle-Symboldateien hinzufügen, da der Debugger sie automatisch verwendet. |
| LLDB-Startbefehle | Fügen Sie LLDB-Befehle hinzu, die ausgeführt werden sollen, bevor der Debugger an den Prozess angehängt wird. Sie können beispielsweise Einstellungen für die Umgebung definieren, wie im folgenden Befehl gezeigt:
LLDB führt die Befehle in der Reihenfolge von oben nach unten aus. |
| LLDB-Befehle nach dem Anhängen | Fügen Sie LLDB-Befehle hinzu, die direkt nach dem Anhängen des Debuggers an den Prozess ausgeführt werden sollen. Beispiel:
LLDB führt die Befehle in der Reihenfolge von oben nach unten aus. |
| Arbeitsverzeichnis des Hosts | Geben Sie das LLDB-Arbeitsverzeichnis an. |
| Protokollierung: Zielkanäle | LLDB-Logoptionen angeben Android Studio legt die Standardoptionen basierend auf den Erfahrungen des Teams fest. Die Optionen sind also nicht zu langsam, enthalten aber die erforderlichen Informationen zur Fehlerbehebung. Das Log wird häufig für Fehlerberichte zu Android Studio angefordert. Der Standardwert ist
Sie können die Standardeinstellung ändern, um mehr Informationen zu erfassen. Mit den folgenden Log-Optionen werden beispielsweise Informationen zu einem bestimmten lldb process
platform:gdb-remote packets
Eine vollständige Liste der Log-Befehle erhalten Sie, wenn Sie den Befehl
In Android Studio werden Gerätelogs am folgenden Speicherort abgelegt. Dabei ist
Wenn mehrere Nutzer auf ein Gerät zugreifen, werden die Protokolle am folgenden Speicherort abgelegt, wobei
Informationen zur Verwendung von LLDB für das Remote-Debugging finden Sie unter Remote-Debugging. |
| vor Markteinführung | Weitere Informationen finden Sie unter Before Launch Operations definieren. |
Tab „Profiling“
Die Option Erweitertes Profiling aktivieren muss aktiviert sein, damit bestimmte Funktionen im Android Profiler verfügbar sind, wenn auf Ihrem Gerät Android 7.1 oder niedriger ausgeführt wird.
Android-Tests
Welche Testvorlage Sie verwenden sollten, hängt von Ihrem Quellset ab. Die Vorlage „Android Instrumented Tests“ ist für einen instrumentierten Test vorgesehen. Die Android JUnit-Vorlage ist für einen lokalen Einheitentest vorgesehen.
Hinweis:Wenn Sie Firebase Test Lab verwenden, um auf verschiedenen Geräten zu testen, können Sie das Android JUnit-Template verwenden, um Ihre Instrumentierungstests zu definieren. Weitere Informationen finden Sie unter Tests mit Firebase Test Lab ausführen.
In den folgenden Tab-Beschreibungen werden die Tabs und Felder für die Vorlage „Android Instrumented test“ (Instrumentierter Android-Test) beschrieben. Informationen zu den Tabs und Feldern für die Android JUnit-Testvorlage finden Sie auf der IntelliJ-Seite Run/Debug Configuration: JUnit.
Allgemein
Auf dem Tab Allgemein können Sie den Teststandort, den Instrumentation-Runner, die ADB-Shell und die Bereitstellungsoptionen angeben.
| Feld | Beschreibung |
|---|---|
| Modul | Wählen Sie ein Modul aus, auf das diese Konfiguration angewendet werden soll. |
| Test | Geben Sie in diesem Bereich den Speicherort der Tests an, die Sie ausführen möchten:
|
| Spezifischer Instrumentation-Runner (optional) | Geben Sie den Speicherort des Instrumentation-Runners ein. Klicken Sie auf Mehr, um ein Dialogfeld zu verwenden. In der Datei build.gradle wird der Speicherort des Instrumentation-Runners angegeben. Dieser Wert überschreibt ihn. Die Standardeinstellung ist in der Regel die Klasse AndroidJUnitRunner aus AndroidX Test.
|
| Zusätzliche Optionen | Geben Sie die gewünschten Standard: keine Optionen |
| Optionen für das Bereitstellungsziel: Ziel | Entscheiden Sie sich für eine Option:
|
| Optionen für das Bereitstellungsziel: Dasselbe Gerät für zukünftige Starts verwenden | Wenn Sie das Gerät, das Sie im Dialogfeld Bereitstellungsziel auswählen ausgewählt haben, in Zukunft automatisch verwenden möchten, wählen Sie diese Option aus. Wenn das Gerät nicht verfügbar ist, wird ein Dialogfeld angezeigt. Standard: nicht ausgewählt |
| vor Markteinführung | Weitere Informationen finden Sie unter Before Launch Operations definieren. |
Tab „Sonstiges“
Der Tab Sonstiges enthält Optionen für Logcat und die Installation.
| Feld | Beschreibung |
|---|---|
| Logcat: Protokoll vor dem Start löschen | Wählen Sie diese Option aus, wenn Android Studio Daten aus vorherigen Sitzungen aus der Logdatei entfernen soll, bevor die App gestartet wird. Standard: deaktiviert. |
| Installationsoptionen: Installation überspringen, wenn sich das APK nicht geändert hat | Wenn diese Option ausgewählt ist, wird Ihr APK nicht noch einmal bereitgestellt, wenn Android Studio erkennt, dass es unverändert ist. Wenn Sie möchten, dass Android Studio die Installation des APK erzwingt, auch wenn es sich nicht geändert hat, deaktivieren Sie diese Option. Standard: ausgewählt |
| Installationsoptionen: Ausführung der App erzwingen, bevor die Aktivität gestartet wird | Wenn diese Option ausgewählt ist und Android Studio erkennt, dass ein APK nicht neu installiert werden muss, weil es sich nicht geändert hat, wird die App beendet, damit sie über die Standard-Launcher-Aktivität gestartet wird. Wenn diese Option deaktiviert ist, wird die App nicht von Android Studio beendet. Diese Option funktioniert in Verbindung mit der vorherigen Option, mit der gesteuert wird, ob ein APK installiert wird oder nicht. Lassen Sie beide Felder unter Installationsoptionen auf dem Standardwert, es sei denn, Sie möchten die Installation jedes Mal erzwingen. In einigen Fällen kann es sinnvoll sein, diese Option zu deaktivieren. Wenn Sie beispielsweise eine Eingabemethode (Input Method Engine, IME) entwickeln, wird die App durch das Erzwingen des Beendens als aktuelle Tastatur abgewählt, was Sie möglicherweise nicht möchten. Standard: ausgewählt |
| vor Markteinführung | Weitere Informationen finden Sie unter Before Launch Operations definieren. |
Tab „Debugger“
Geben Sie die Debugging-Optionen auf dem Tab Debugger an.
Für C- und C++-Code verwendet Android Studio den LLDB-Debugger. Zusätzlich zur normalen Android Studio-Benutzeroberfläche hat das Debugger-Fenster einen LLDB-Tab, auf dem Sie während des Debuggens LLDB-Befehle eingeben können. Sie können dieselben Befehle eingeben, die Android Studio verwendet, um Informationen in der Debugger-Benutzeroberfläche anzuzeigen, und zusätzliche Vorgänge ausführen.
Bei C- und C++-Projekten können Sie auf dem Tab Debugger Symbolverzeichnisse sowie LLDB-Start- und Post-Attach-Befehle hinzufügen. Dazu verwenden Sie Schaltflächen wie die folgenden:
- Hinzufügen
– Ein Verzeichnis oder ein Befehl wird hinzugefügt.
- Entfernen
– Wählen Sie ein Verzeichnis oder einen Befehl aus und klicken Sie dann auf diese Schaltfläche, um das Element zu entfernen.
- Nach oben
– Wählen Sie ein Verzeichnis oder einen Befehl aus und klicken Sie dann auf diese Schaltfläche, um das Element in der Liste nach oben zu verschieben.
- Nach unten
– Wählen Sie ein Verzeichnis oder einen Befehl aus und klicken Sie dann auf diese Schaltfläche, um das Element in der Liste nach unten zu verschieben.
Weitere Informationen zum Debuggen in Android Studio finden Sie unter App debuggen.
| Feld | Beschreibung |
|---|---|
| Debug-Typ | Wählen Sie eine der folgenden Optionen aus:
Die Option Automatisch erkennen wird empfohlen, da sie den richtigen Debugging-Typ für Ihr Projekt auswählt. |
| Symbolverzeichnisse | Wenn Sie Symboldateien hinzufügen möchten, um dem Debugger C- oder C++-Informationen zur Verfügung zu stellen, die außerhalb von Android Studio generiert wurden, können Sie hier ein oder mehrere Verzeichnisse hinzufügen. Android Studio verwendet vorzugsweise alle Dateien in diesen Verzeichnissen anstelle von Dateien, die vom Android-Plugin für Gradle generiert wurden. Der Debugger durchsucht die Verzeichnisse von oben nach unten, bis er findet, was er benötigt. Es wird rekursiv in den Dateien im Verzeichnis gesucht. Um die Liste zu optimieren und Zeit zu sparen, sollten Sie die am häufigsten verwendeten Verzeichnisse oben in der Liste platzieren. Wenn Sie ein Verzeichnis weiter oben in der Struktur angeben, kann es länger dauern, alle Unterverzeichnisse zu durchsuchen. Wenn Sie ein sehr spezifisches Verzeichnis hinzufügen, dauert die Suche weniger lange. Sie müssen das richtige Gleichgewicht zwischen Geschwindigkeit und dem Auffinden der für das Debugging erforderlichen Dateien finden. Wenn Sie beispielsweise ein Verzeichnis mit Unterverzeichnissen für verschiedene Android Binary Interfaces (ABIs) haben, können Sie ein Verzeichnis für eine bestimmte oder für alle ABIs hinzufügen. Die Suche im übergeordneten Verzeichnis kann zwar länger dauern, ist aber auch sicherer, wenn Sie auf einem anderen Gerät debuggen möchten. Sie müssen keine Verzeichnisse mit Gradle-Symboldateien hinzufügen, da der Debugger sie automatisch verwendet. |
| LLDB-Startbefehle | Fügen Sie LLDB-Befehle hinzu, die ausgeführt werden sollen, bevor der Debugger an den Prozess angehängt wird. Sie können beispielsweise Einstellungen für die Umgebung definieren, wie im folgenden Befehl gezeigt:
LLDB führt die Befehle in der Reihenfolge von oben nach unten aus. |
| LLDB-Befehle nach dem Anhängen | Fügen Sie LLDB-Befehle hinzu, die direkt nach dem Anhängen des Debuggers an den Prozess ausgeführt werden sollen. Beispiel:
LLDB führt die Befehle in der Reihenfolge von oben nach unten aus. |
| Arbeitsverzeichnis des Hosts | Geben Sie das LLDB-Arbeitsverzeichnis an. |
| Protokollierung: Zielkanäle | LLDB-Logoptionen angeben Android Studio legt die Standardoptionen basierend auf den Erfahrungen des Teams fest. Die Optionen sind also nicht zu langsam, enthalten aber die erforderlichen Informationen zur Fehlerbehebung. Das Log wird häufig für Fehlerberichte zu Android Studio angefordert. Der Standardwert ist
Sie können die Standardeinstellung ändern, um mehr Informationen zu erfassen. Mit den folgenden Log-Optionen werden beispielsweise Informationen zu einem bestimmten lldb process
platform:gdb-remote packets
Eine vollständige Liste der Log-Befehle erhalten Sie, wenn Sie den Befehl
In Android Studio werden Gerätelogs am folgenden Speicherort abgelegt. Dabei ist
Wenn mehrere Nutzer auf ein Gerät zugreifen, werden die Protokolle am folgenden Speicherort abgelegt, wobei
Informationen zur Verwendung von LLDB für das Remote-Debugging finden Sie unter Remote-Debugging. |
| vor Markteinführung | Weitere Informationen finden Sie unter Before Launch Operations definieren. |
App Engine DevAppServer
Diese Konfiguration für das Ausführen/Debuggen gilt für die Google Cloud Platform. Wenn Sie diese Schritte ausführen und Ihr Projekt mit der Datei build.gradle synchronisieren, erstellt Android Studio eine App Engine DevAppServer-Konfiguration für Sie.
Die IntelliJ IDEA-Vorlage App Engine Server ist eine andere Vorlage, die in Android Studio nicht verfügbar ist.
| Feld | Beschreibung |
|---|---|
| Nur eine einzelne Instanz | Wenn Sie sicherstellen möchten, dass jeweils nur eine Instanz der Run/Debug-Konfiguration ausgeführt wird, wählen Sie diese Option aus. Es sind keine gleichzeitigen Mehrfachausführungen derselben Konfiguration möglich. Standard: ausgewählt |
| Modul | Wählen Sie ein Modul aus, auf das diese Konfiguration angewendet werden soll. |
| Mit build.gradle-Konfiguration synchronisieren | Wenn Sie ein App Engine-Modul hinzufügen und mit der Datei build.gradle synchronisieren, werden die Konfigurationsfelder für den App Engine DevAppServer automatisch ausgefüllt (empfohlen).
Wenn Sie File > Sync Project with Gradle Files (Datei > Projekt mit Gradle-Dateien synchronisieren) auswählen, wird das Projekt ebenfalls synchronisiert. Standard: ausgewählt
|
| App Engine SDK | Geben Sie einen Pfad zu einem Google App Engine SDK für Java auf dem lokalen Computer ein. Klicken Sie auf …, um sie in einem Dialogfeld auszuwählen. |
| Kriegspfad | Geben Sie einen Pfad zum WAR-Verzeichnis (Web Application Archive) der App ein, die Sie auf dem lokalen Entwicklungsserver bereitstellen. Klicken Sie auf …, um sie in einem Dialogfeld auszuwählen. |
| VM-Argumente | Geben Sie die Befehlszeilenoptionen an, die Sie an die VM übergeben möchten, um den DevAppServer zu starten. Beachten Sie beim Festlegen der Optionen Folgendes:
Weitere Informationen zu VM-Optionen finden Sie in der Dokumentation zu Ihrer J2SE-Version, z. B. Standard: keine Optionen |
| Serveradresse | Geben Sie die Hostadresse für den Server ein. Möglicherweise müssen Sie die Adresse angeben, um von einem anderen Computer in Ihrem Netzwerk aus auf den Entwicklungsserver zugreifen zu können. Eine Adresse wie 0.0.0.0 ermöglicht sowohl Localhost- als auch Hostname-Zugriff. Standardwert: localhost |
| Serverport | Geben Sie die Portnummer ein, die für den Server verwendet werden soll. Standard: 8080 |
| „Check for App Engine SDK Updates“ (Nach App Engine SDK-Updates suchen) deaktivieren | Wenn dies angegeben wird, stellt der Entwicklungsserver keine Verbindung zu App Engine her, um zu prüfen, ob eine neue Version des SDK verfügbar ist. Standardmäßig prüft der Server beim Start, ob eine neue Version vorhanden ist, und gibt ggf. eine entsprechende Nachricht zurück. |
| vor Markteinführung | Weitere Informationen finden Sie unter Before Launch Operations definieren. |
Wear OS-Konfigurationen für die Ausführung und Fehlerbehebung
Mit den Vorlagen für Wear OS-Zusatzfunktionen, ‑Kacheln und ‑Zifferblätter können Sie Wear OS-Apps auf virtuellen oder Hardwaregeräten ausführen oder debuggen. Die meisten Konfigurationsoptionen für Vorlagen sind dieselben wie die Optionen für Android-Apps. Hier sind die Optionen, die spezifischer für die Wear OS-Ausführungs-/Debugkonfigurationen sind:
- Für alle Wear-Konfigurationen zum Ausführen/Debuggen müssen Sie eine bestimmte Datenquelle für Komplikationen, eine Kachel oder ein Zifferblatt (je nach Vorlage) auswählen, auf die die Konfiguration angewendet werden soll. Im Allgemeinen entspricht jede dieser Einheiten einer Klasse in Ihrem Code.
- Für die Ausführungs-/Debug-Konfiguration für Wear OS-Zusatzfunktionen müssen Sie den Slot auswählen, in dem die von der Datenquelle der Zusatzfunktion bereitgestellten Daten platziert werden sollen. Sie können es oben, rechts, unten, links oder im Hintergrund des Zifferblatts platzieren.
- Für die Wear OS-Komplikationskonfiguration zum Ausführen/Debuggen müssen Sie auch den Typ der Komplikationsdaten auswählen, die von der Komplikationsdatenquelle bereitgestellt werden. Die verfügbaren Typen sind auf die beschränkt, die von der ausgewählten Datenquelle für die Komplikation bereitgestellt und vom ausgewählten Slot unterstützt werden. Eine Liste der Komplikationsdatentypen finden Sie unter Types and fields.
Alternativ können Sie diese Oberflächen auch über das Gutter-Symbol neben der Deklaration der Oberfläche ausführen, wie im folgenden Bild dargestellt. Wenn ein Fehler auftritt, z. B. „Fehler beim Festlegen der Kachel“, prüfen Sie, ob Sie die Oberfläche richtig konfiguriert haben, einschließlich der Deklaration der Oberfläche in Ihrem Manifest.
