Programmfehler melden

Folge der Anleitung auf dieser Seite, um einen Fehlerbericht zu erstellen. Es gibt nur begrenzte Ressourcen zum Beheben von Fehlern, sodass Fehler mit vollständigen Informationen priorisiert werden. Unvollständige Fehlerberichte werden geschlossen. Senden Sie in diesem Fall den Fehler noch einmal mit zusätzlichen Informationen.

Damit du keinen Fehler meldest, der bereits behoben wurde, solltest du immer die neuesten Versionen der Tools verwenden. Sie können auch im Android Studio Issue Tracker nach ähnlichen Problemen suchen, um festzustellen, ob das Problem bereits gemeldet wurde.

Fehler melden

So meldest du einen Fehler:

  1. Wählen Sie zum Öffnen eines Fehlerberichts in Android Studio Hilfe > Feedback geben aus.

    Das ist die einfachste Methode, um einen Fehler zu starten. In den Fehlerbericht werden dann Ihre Android Studio-Version, Kotlin- oder Java-Version sowie Systeminformationen eingefügt, die erforderlich sind, um das Problem ordnungsgemäß zu reproduzieren.

    Sie können den Fehler auch hier melden und die Versionsinformationen selbst hinzufügen.

  2. Hängen Sie einen Diagnosebericht an, damit wir das Problem beheben können. Klicken Sie auf Hilfe > Protokolle und Diagnosedaten erfassen, um eine ZIP-Datei mit dem Diagnosebericht zu erstellen.

  3. Beschreiben Sie die genauen Schritte, mit denen das Problem reproduziert werden kann. Reichen Sie so viele Informationen wie möglich ein, einschließlich Code-Snippets, eines GitHub-Projekts, das zum Reproduzieren des Fehlers verwendet werden kann, sowie Screenshots oder Aufzeichnungen von dem, was Sie beobachten.

  4. Beschreiben Sie das Problem ausführlich. Erklären Sie das von Ihnen erwartete Ergebnis und was Sie stattdessen beobachtet haben.

  5. Wählen Sie einen aussagekräftigen Titel für den Fehlerbericht aus. Ein aussagekräftigerer Titel erleichtert die Sortierung nach Problem.

Bei bestimmten Fehlern benötigen wir zusätzliche Informationen, wie in den folgenden Abschnitten beschrieben:

Details zu Android Studio-Programmfehlern

Wenn Sie speziell für Android Studio spezifische Fehler melden möchten, fügen Sie die in diesem Abschnitt beschriebenen zusätzlichen Informationen hinzu.

Wenn die IDE hängt

Wenn die IDE selbst sehr langsam oder vollständig eingefroren ist, generieren Sie einige Thread-Dumps wie auf dieser Seite beschrieben und hängen Sie sie an den Fehlerbericht an. Die Thread-Dumps zeigen, was die IDE verlangsamt und damit verlangsamt wird.

Wenn die IDE langsam, aber nicht eingefroren ist, hängen Sie die Datei idea.log an Ihren Fehlerbericht an. Wählen Sie zum Anhängen der Datei Hilfe > Protokolle und Diagnosedaten erfassen oder Hilfe > Protokolldateien anzeigen aus (unter macOS Hilfe > Protokoll im Finder anzeigen). Diese Datei zeigt, ob die IDE Fehler in das Protokoll wirft.

CPU-Profile verwenden, um langsame Geschwindigkeit zu diagnostizieren

Wenn Sie Probleme in Android Studio haben, können CPU-Profile manchmal bei der Diagnose des Problems helfen.

So erfassen Sie ein CPU-Profil mit dem Android Studio-Plug-in für Leistungstests:

  1. Installieren Sie das Plug-in.

    • Suchen Sie in Android Studio im Plug-in-Marketplace nach „Performance Testing“.
    • Alternativ können Sie eine mit Android Studio kompatible Version von der Plug-in-Website herunterladen.
  2. Erstellen Sie das CPU-Profil.

    1. Wenn Android Studio langsam zu funktionieren scheint, wählen Sie Profilerstellung für CPU-Nutzung starten aus.
    2. Wiederholen Sie einige Aktionen, bei denen die Latenz problematisch ist (Codevervollständigung, Eingabe und Warten auf den Abschluss der Hervorhebung usw.).
    3. Klicken Sie auf CPU-Nutzungsprofilerstellung beenden.
  3. Geben Sie die Profildatei frei.

    Ein Info-Pop-up mit dem Dateinamen des CPU-Snapshots im Format snapshot-NNN wird angezeigt. Teilen Sie diese Snapshot-Datei in Ihrem Fehlerbericht.

Wenn der IDE nicht mehr genügend Arbeitsspeicher zur Verfügung steht

Speicherprobleme in Android Studio sind manchmal schwer zu reproduzieren und zu melden. Zur Lösung dieses Problems enthält Android Studio einen Bericht zur Arbeitsspeichernutzung, den Sie an das Android Studio-Team senden können, um die Ursache der Speicherprobleme zu ermitteln.

Bericht zur Arbeitsspeichernutzung erstellen

So erstellen Sie einen Bericht zur Arbeitsspeichernutzung:

  1. Klicken Sie in der Menüleiste auf Help > Analyze Memory Usage (Hilfe > Arbeitsspeichernutzung analysieren).

    Android Studio gibt den Heap aus und fordert Sie auf, die IDE neu zu starten. Wenn Sie die IDE neu starten, beginnt die Heap-Dump-Analyse sofort. Andernfalls beginnt die Heap-Dump-Analyse bei der nächsten Ausführung von Android Studio. In beiden Fällen werden Sie von der IDE benachrichtigt, sobald der Bericht zur Arbeitsspeichernutzung überprüft werden kann (siehe Abbildung 1).

    Benachrichtigung, die besagt, dass ein Bericht zur Arbeitsspeichernutzung geprüft werden kann
    Abbildung 1: Benachrichtigung zum Bericht zur Arbeitsspeichernutzung.
  2. Klicken Sie auf Bericht prüfen.

    Bevor Sie den Bericht senden, können Sie die enthaltenen Informationen überprüfen:

    Einen Bericht zur Arbeitsspeichernutzung
    Abbildung 2: Analyse des Berichts zur Arbeitsspeichernutzung.
  3. Kopieren Sie nach Abschluss der Überprüfung den Inhalt des Berichts in eine Datei und hängen Sie diese an, wenn Sie den Fehler melden.

    Wenn Sie die Berichtsinformationen auf diese Weise senden, kann das Android Studio-Team über die Problemverfolgung mit Ihnen kommunizieren und Ihre Arbeitsspeicherprobleme untersuchen.

Wenn die IDE abstürzt oder Ausnahmen auslöst

Bei anderen Arten von Abstürzen können Sie die Datei idea.log anhängen. Wählen Sie dazu Hilfe > Protokolle und Diagnosedaten erfassen oder Hilfe > Protokolldateien in Dateien anzeigen aus (unter macOS Hilfe > Protokoll im Finder anzeigen).

Thread-Dump generieren

Ein Thread-Dump ist ein Ausdruck aller Threads, die in der JVM ausgeführt werden. Für jeden Thread enthält sie einen Ausdruck aller Stackframes. So lässt sich leicht erkennen, was die IDE gerade tut, insbesondere wenn Sie mehrere Thread-Dumps generieren, die im Abstand von wenigen Sekunden erstellt werden.

Wenn Sie Fehler melden, bei denen die IDE stark überlastet ist oder die IDE eingefroren ist, kann ein Thread-Dump entweder feststellen, welcher Code viel Arbeit erledigt oder welche Threads um Ressourcen konkurrieren und einen Deadlock verursachen.

Im Lieferumfang des JDK ist ein Tool mit dem Namen jstack enthalten, mit dem ein Thread-Dump generiert werden kann. Ermitteln Sie zuerst die Prozess-ID (PID) des Android Studio-Prozesses. Verwenden Sie dazu den Befehl jps:

Unter Linux oder macOS:

jps -mv | grep studio

Unter Windows:

jps -mv | findstr studio

Dadurch wird eine lange Zeile ausgegeben, z. B.:

$ jps -mv | grep studio
37605 -Dfile.encoding=UTF-8 -ea -Dsun.io.useCanonCaches=false -Djava.net.preferIPv4Stack=true -Djna.nosys=true ...

Die erste Zahl (in diesem Beispiel 37605) ist die Prozess-ID.

Generieren Sie als Nächstes einen Thread-Dump und speichern Sie ihn in der Datei dump.txt:

jstack -l pid >> dump.txt

Wenn das nicht funktioniert, gibt es weitere plattformspezifische Möglichkeiten, einen Thread-Dump zu generieren. Ausführliche Informationen finden Sie auf der Hilfeseite IntelliJ.

Details zu Build-Tools und Gradle-Programmfehlern

Wenn Sie einen Fehler für Build-Tools oder Gradle melden möchten, hängen Sie ein echtes oder Beispielprojekt an, das das Problem demonstriert. So können Sie sicher sein, dass alle erforderlichen Informationen erfasst werden. Entfernen Sie vor der Freigabe alle vertraulichen Informationen.

Wenn Sie ein Projekt nicht freigeben können, geben Sie die Versionen der verwendeten Tools an. Versuchen Sie, die neueste stabile Version oder die aktuelle Vorschauversion zu verwenden, bevor Sie einen Fehler melden. So finden Sie Ihre Toolversionen:

  • Version des Android-Gradle-Plug-ins:

    1. Wählen Sie File > Project Structure (Datei > Projektstruktur) aus.
    2. Klicken Sie auf Projekt.
    3. Suchen Sie die Version des Android Gradle-Plug-ins.
  • Gradle-Version:

    1. Wählen Sie File > Project Structure (Datei > Projektstruktur) aus.
    2. Klicken Sie auf Projekt.
    3. Suchen Sie die Gradle-Version.
  • Android Studio-Version:

    1. Wähle Hilfe > Über aus.
    2. Suchen Sie die Android Studio-Version.

Geben Sie gegebenenfalls außerdem die folgenden Informationen an:

  • Wenn sich ein Verhalten unerwartet von einer früheren zur aktuellen Version geändert hat, geben Sie beide Versionen an.
  • Wenn der Build aufgrund eines Fehlers fehlgeschlagen ist, führen Sie ihn über die Befehlszeile mit der Option --stacktrace (z. B. ./gradlew <task> --stacktrace) aus und geben Sie einen Stacktrace in Ihren Fehlerbericht an.
  • Wenn der Build länger als erwartet dauert, haben Sie folgende Möglichkeiten:
    • Führen Sie ./gradlew <task> --scan aus und geben Sie den generierten Gradle Build-Scan in Ihrem Fehlerbericht an.
    • Führen Sie ./gradlew <task> -Pandroid.enableProfileJson=true aus und geben Sie die im Verzeichnis <root-project>/build/android-profile generierten Chrome-trace-Dateien frei.

Details zu Fehlern im Android-Emulator

Führen Sie die folgenden Schritte aus, um mit den erweiterten Steuerelementen des Emulators Informationen zu erfassen und einen Fehler zu melden:

  1. Klicken Sie im Emulator-Steuerfeld auf Mehr .
  2. Wählen Sie im Fenster Erweiterte Steuerelemente die Option Fehlerbericht aus.

    Daraufhin wird ein Bildschirm mit Details zum Fehlerbericht wie einem Screenshot, den AVD-Konfigurationsinformationen und einem Protokoll des Fehlerberichts geöffnet. Sie können die zu reproduzierenden Schritte hier eingeben oder warten und sie in den im nächsten Schritt generierten Bericht eingeben.

  3. Warten Sie, bis der Fehlerbericht fertig ist, und klicken Sie dann auf An Google senden.

    Ein Fenster wird geöffnet, in dem Sie den Fehlerbericht in einem Ordner speichern können. Der Browser wird auch geöffnet, um einen Bericht in der Google-Problemverfolgung zu erstellen, in dem die erforderlichen Emulatordetails eingetragen sind.

  4. Geben Sie im Bericht alle verbleibenden Details ein, z. B. die Schritte zum Reproduzieren des Fehlers, und hängen Sie die Dateien an, die Sie beim Erstellen des Fehlerberichts gespeichert haben.

Andernfalls geben Sie die folgenden Details manuell ein:

  • Emulator version

    1. Öffnen Sie im Emulator die erweiterten Steuerelemente.
    2. Klicken Sie auf Hilfe.
    3. Klicken Sie auf den Tab Info, um die Emulator-Version zu finden.
  • Version der Android SDK-Tools

    1. Wählen Sie Tools > SDK Manager aus.
    2. Klicken Sie auf SDK-Tools.
    3. Suchen Sie Android SDK-Tools.
  • Host-CPU-Modell

    • Unter Linux: Öffnen Sie /proc/cpuinfo.
    • Windows: Klicken Sie mit der rechten Maustaste auf Arbeitsplatz und wählen Sie Eigenschaften aus.
    • Unter macOS: Wählen Sie das Apple-Symbol und klicken Sie auf Über diesen Mac.
  • Gerätename

    1. Klicken Sie in AVD Manager auf das Menü in der Spalte Aktionen für das Gerät.
    2. Wählen Sie Details anzeigen aus oder öffnen Sie die Datei $avdname.avd/config.ini.
    3. Suchen Sie den Eintrag für hw.device.name. Beispiel: hw.device.name=Nexus 5.