Programmfehler melden

Folge der Anleitung auf dieser Seite, um einen Fehlerbericht zu erstellen. Es gibt eingeschränkte um Fehler zu beheben, sodass Fehler, die wenn die Informationen priorisiert werden. Unvollständige Fehlerberichte werden geschlossen. Wenn das senden Sie den Fehler erneut mit zusätzlichen Informationen.

Um sicherzustellen, dass Sie keinen Fehler melden, der bereits behoben wurde, Stellen Sie sicher, dass Sie die aktuelle Version der Tools verwenden. Sie können auch nach ähnlichen Problemen im Android Studio-Problemverfolgung um zu sehen, ob das Problem bereits gemeldet wurde.

Fehler melden

So melden Sie einen Fehler:

  1. Um einen Fehlerbericht von Android Studio zu öffnen, wähle Hilfe > Feedback geben.

    Dies ist die einfachste Methode, um einen Fehler zu starten, da er automatisch im Fehlerbericht erfasst wird. mit Ihrer Android Studio-Version, Kotlin- oder Java-Version und dem System Informationen, die erforderlich sind, um das Problem richtig zu reproduzieren.

    Sie können auch melde den Fehler hier und fügen Sie die Versionsinformationen selbst hinzu.

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

  3. Beschreiben Sie die genauen Schritte, mit denen das Problem reproduziert werden kann. Senden als möglichst viele Informationen enthalten, einschließlich Code-Snippets, mit denen der Fehler reproduziert werden kann, sowie Screenshots oder die Sie beobachten.

  4. Beschreiben Sie das Problem ausführlich. Erläutern Sie das erwartete Ergebnis. und was Sie stattdessen beobachtet haben.

  5. Wählen Sie einen aussagekräftigen Titel für den Fehlerbericht aus. Verwenden Sie eine aussagekräftigere „Titel“ vereinfacht das Sortieren nach Problem.

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

Details zu Android Studio-Programmfehlern

Gib zusätzliche Informationen an, um Fehler speziell für Android Studio zu melden wie in diesem Abschnitt beschrieben.

Wenn die IDE hängt

Wenn die IDE selbst sehr langsam oder vollständig eingefroren zu sein scheint, Erstellen Sie einige Thread-Dumps, wie auf dieser Seite beschrieben. und an den Fehlerbericht anhängen. Die Thread-Dumps zeigen, was die IDE tut das verlangsamt.

Wenn die IDE langsam, aber nicht eingefroren ist, hängen Sie die idea.log-Datei an Ihren Fehler an. Bericht. Um die Datei anzuhängen, wählen Sie Hilfe > Protokolle und Diagnosedaten erfassen oder auf Hilfe > Protokolldateien anzeigen (unter macOS über Hilfe > Protokoll im Finder anzeigen). Diese Datei zeigt, ob die IDE Fehler in das Log ausgibt.

Langsamkeit mithilfe von CPU-Profilen diagnostizieren

Wenn Android Studio zu langsam ist, können CPU-Profile kann es helfen, das Problem zu diagnostizieren.

Führen Sie die folgenden Schritte aus, um mit Android Studio ein CPU-Profil zu erfassen. Plug-in für Leistungstests:

  1. Installieren Sie das Plug-in.

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

    1. Wenn Android Studio langsam zu sein scheint, wählen Sie CPU-Nutzung starten Profilerstellung.
    2. Wiederholen Sie einige Aktionen, bei denen die Latenz problematisch ist. z. B. Codevervollständigung, Tippen und Warten auf Markierung, um nachzuholen.
    3. Klicken Sie auf CPU Usage Profiling beenden.
  3. Geben Sie die Profildatei frei.

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

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

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

Bericht zur Arbeitsspeichernutzung erstellen

So erstellen Sie einen Bericht zur Arbeitsspeichernutzung:

  1. Klicken Sie auf Hilfe > Arbeitsspeichernutzung analysieren aus.

    Android Studio gibt den Heap aus und fordert Sie auf, die IDE neu zu starten. Wenn Sie die IDE neu starten, wird die Heap-Dump-Analyse sofort gestartet. Andernfalls wird der Die Heap-Dump-Analyse wird gestartet, wenn Sie Android Studio das nächste Mal ausführen. In beiden erhalten Sie eine Benachrichtigung von der IDE, sobald der Bericht überprüfen, wie in Abbildung 1 dargestellt.

    <ph type="x-smartling-placeholder">
    </ph> Benachrichtigung, die besagt, dass ein Bericht zur Arbeitsspeichernutzung zum
     Rezension
    Abbildung 1: Gemerkte Informationen Verwende die Berichtsbenachrichtigung.
  2. Klicken Sie auf Bericht überprüfen.

    Bevor Sie den Bericht senden, können Sie die Informationen enthalten:

    <ph type="x-smartling-placeholder">
    </ph> Bericht zur Arbeitsspeichernutzung
    Abbildung 2: Die Arbeitsspeichernutzung Berichtsanalyse.
  3. Nachdem Sie die Überprüfung abgeschlossen haben, kopieren Sie den Inhalt der Bericht in einer Datei erstellen und diese Datei anhängen, den Fehler melden.

    Wenn Sie die Berichtsinformationen auf diese Weise senden, kann Android Studio kann Ihr Team über den Issue Tracker mit Ihnen kommunizieren, während Ihr Arbeitsspeicherprobleme.

Wenn die IDE abstürzt oder Ausnahmen auslöst

Hängen Sie für andere Arten von Abstürzen die idea.log-Datei an, die Sie über Hilfe > Protokolle und Diagnosedaten erfassen oder Hilfe > Log-in-Dateien anzeigen (Unter macOS Hilfe > Log im Finder anzeigen).

Thread-Dump generieren

Ein Thread-Dump ist ein Ausdruck aller Threads, die in der JVM ausgeführt werden. Für jede enthält, enthält sie einen Ausdruck aller Stackframes. So lässt sich leicht erkennen, was die IDE tut, vor allem, wenn Sie gibt den Thread einige Sekunden auseinander.

Wenn Sie Fehler melden, bei denen die IDE sehr ausgelastet ist, weil die CPU oder der Prozessor in dem die IDE scheinbar eingefroren ist, kann ein Thread-Dump entweder welcher Code viel Arbeit macht oder um welche Threads konkurrieren und zu einem Deadlock führen.

Das JDK wird mit einem Tool namens jstack ausgeliefert, mit dem ein Thread-Dump. Suchen Sie zuerst nach der 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 einer dump.txt-Datei:

jstack -l pid >> dump.txt

Sollte das nicht funktionieren, gibt es noch weitere plattformspezifische Möglichkeiten, einen Thread-Dump generieren kann. Eine ausführliche Anleitung finden Sie unter IntelliJ-Support

Details zu Build-Tools und Gradle-Programmen

Wenn du einen Fehler für Build-Tools oder Gradle melden möchtest, musst du ein echtes Projekt oder ein Beispielprojekt anhängen der das Problem demonstriert, um sicherzustellen, die notwendig ist. Entfernen Sie vor der Freigabe alle vertraulichen Informationen.

Wenn Sie ein Projekt nicht teilen können, geben Sie die Versionen der verwendeten Tools an verwenden. Versuchen Sie, die aktuelle stabile Version oder die aktuelle Vorschauversion zu verwenden, bevor Sie einen Bug). So finden Sie die Versionen Ihres Tools:

  • Version des Android-Gradle-Plug-ins:

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

    1. Wählen Sie Datei > Projektstruktur.
    2. Klicken Sie auf Projekt.
    3. Suchen Sie die Gradle-Version.
  • Android Studio-Version:

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

Geben Sie außerdem gegebenenfalls die folgenden Informationen an:

  • Wenn sich ein Verhalten unerwartet von einer früheren Version zum aktuelle Version haben, geben Sie beide Versionen an.
  • Wenn der Build mit einem Fehler fehlgeschlagen ist, führen Sie den Build über die Befehlszeile aus mit der Option --stacktrace (z. B. ./gradlew <task> --stacktrace) und geben Sie in Ihrem Fehlerbericht einen Stacktrace an.
  • Wenn der Build länger als erwartet dauert, haben Sie folgende Möglichkeiten: <ph type="x-smartling-placeholder">
      </ph>
    • Führen Sie ./gradlew <task> --scan aus und geben Sie den generierten Gradle build scan in Ihrem Fehler Bericht.
    • Führen Sie ./gradlew <task> -Pandroid.enableProfileJson=true aus und geben Sie Folgendes frei: Chrome-Trace -Dateien, die im Verzeichnis <root-project>/build/android-profile erstellt wurden.

Details zu Fehlern im Android Emulator

Führen Sie die folgenden Schritte aus, um die erweiterten Steuerelemente des Emulators zum Erfassen von Informationen zu verwenden und melde den Fehler:

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

    Daraufhin wird ein Bildschirm mit Details zum Fehlerbericht geöffnet, z. B. Screenshot, die AVD-Konfigurationsinformationen und ein Protokoll des Fehlerberichts Sie können die Schritte zum Reproduzieren hier eingeben oder warten und sie dann in aus dem im nächsten Schritt erstellten Bericht.

  3. Warten Sie, bis der Fehlerbericht vollständig erfasst wurde, und Klicken Sie auf An Google senden.

    Ein Fenster wird geöffnet, in dem Sie den Fehlerbericht in einem Ordner speichern können. Ihr Browser wird ebenfalls geöffnet, um einen Bericht im Google Issue Tracker zu erstellen. die erforderlichen Emulator-Details ein.

  4. Geben Sie im Bericht alle verbleibenden Details ein, z. B. die Schritte zum den Fehler zu reproduzieren und die Dateien anzuhängen, die beim Erstellen des Fehlers gespeichert wurden Bericht.

Andernfalls geben Sie die folgenden Informationen manuell ein:

  • Emulator-Version

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

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

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

    1. Klicken Sie im AVD-Manager auf Aktionen, um das Menü zu öffnen. für das Gerät.
    2. Wählen Sie Details ansehen (oder öffnen Sie die Datei $avdname.avd/config.ini.
    3. Suchen Sie den Eintrag für hw.device.name. Für Beispiel: hw.device.name=Nexus 5.