Zgłoś błąd

Aby wypełnić raport o błędzie, postępuj zgodnie z instrukcjami wyświetlanymi na tej stronie. Istnieją ograniczone do naprawiania błędów, usuwania wszystkich błędów informacje mają priorytet. Niekompletne raporty o błędach są zamykane. Jeśli prześlij zgłoszenie jeszcze raz, podając dodatkowe informacje.

Aby mieć pewność, że nie zgłosisz błędu, który został już naprawiony, sprawdź, czy używasz najnowszych wersji narzędzi. Możesz też wyszukaj podobne problemy na Narzędzie do śledzenia błędów w Android Studio aby sprawdzić, czy Twój problem został już zgłoszony.

Jak zgłosić błąd

Aby zgłosić błąd:

1. Aby otworzyć raport o błędzie w Android Studio, wybierz Pomoc > Prześlij opinię.

   To najprostszy sposób na uruchomienie błędu, bo zawiera on raport o błędzie. wersję Androida Studio, Kotlin lub Java które są niezbędne do prawidłowego odtworzenia problemu.

   Możesz też zgłoś błąd tutaj i samodzielnie dodaj informacje o wersji.

2. Załącz raport z diagnostyki, abyśmy mogli rozwiązać Twój problem. Aby wygenerować pliku ZIP z raportem diagnostycznym, kliknij kolejno Pomoc > Zbieranie logów i danych diagnostycznych.

3. Opisz dokładne czynności, które prowadzą do wystąpienia problemu. Prześlij jako jak najwięcej informacji, w tym fragmenty kodu, projekt GitHub które można wykorzystać do odtworzenia błędu, oraz zrzuty ekranu i nagrania które obserwujecie.

4. Szczegółowo opisz problem. Opisz oczekiwany wynik. i na podstawie obserwacji.

5. Wybierz opisowy tytuł raportu o błędzie. Użycie bardziej opisowego tytuł ułatwia sortowanie według problemu.

W przypadku niektórych błędów potrzebujemy dodatkowych informacji, zgodnie z w tych sekcjach:

• Szczegóły dotyczące błędów w Android Studio
• Szczegóły narzędzi do kompilacji i błędów Gradle
• Szczegóły błędów emulatora Androida

Szczegóły dotyczące błędów w Android Studio

Aby zgłosić błędy dotyczące Android Studio, podaj dodatkowe informacje jak opisano w tej sekcji.

Jeśli IDE zawiesza się

Jeśli samo IDE działa bardzo wolno lub całkowicie się blokuje, wygeneruj kilka zrzutów wątków zgodnie z opisem na tej stronie. i załącz je do raportu o błędzie. Zrzuty wątków pokazują działanie IDE który je spowalnia.

Jeśli IDE działa wolniej, ale nie jest zablokowane, dołącz do błędu plik idea.log. raport. Aby załączyć plik, wybierz kolejno Pomoc > Zbieranie logów i danych diagnostycznych lub Pomoc > Pokaż pliki logowania (w systemie macOS kliknij Pomoc > Pokaż log w Finderze). Ten plik pokazuje, czy IDE zgłasza błędy do logu.

Używaj profili procesora do diagnozowania powolnego działania

Jeśli Android Studio działa wolniej, profile procesora mogą może pomóc w diagnozowaniu problemu.

Aby przechwycić profil procesora za pomocą Android Studio, wykonaj te czynności Wtyczka Performance Testing:

1. Zainstaluj wtyczkę.

   • W Android Studio wyszukaj „Testy wydajności”. we wtyczce platformie handlowej.
   • Możesz też pobrać wersję zgodną z Androidem Studio ze witryny wtyczki.

2. Utwórz profil procesora.

   1. Jeśli Android Studio działa wolno, wybierz Rozpocznij wykorzystanie procesora”. Profilowanie.
   2. Powtórz kilka czynności, które powodują problemy z opóźnieniem. (uzupełnianie kodu, pisanie, oczekiwanie na wyróżnienie itd.).
   3. Kliknij Zatrzymaj profilowanie wykorzystania procesora.

3. Udostępnij plik profilu.

   Pojawi się dymek z nazwą pliku zrzutu procesora, ma format snapshot-NNN. Udostępnij ten plik zrzutu w raport o błędzie.

Jeśli w IDE zabraknie pamięci

Problemy z pamięcią w Android Studio są czasem trudne do odtworzenia raport. Aby rozwiązać ten problem, Android Studio uwzględnia wykorzystanie pamięci który możesz wysłać do zespołu Android Studio, źródła problemów z pamięcią.

Generowanie raportu o wykorzystaniu pamięci

Aby wygenerować raport o wykorzystaniu pamięci, wykonaj te czynności:

1. Kliknij Pomoc > > Analizuj wykorzystanie pamięci na pasku menu.

   Android Studio usuwa stertę i wyświetla prośbę o ponowne uruchomienie IDE. Jeśli ponownie uruchomić IDE, analiza zrzutu stosu rozpocznie się od razu. W przeciwnym razie analiza zrzutu stosu rozpocznie się, gdy następnym razem uruchomisz Android Studio. W: IDE powiadamia Cię, gdy raport o wykorzystaniu pamięci będzie gotowy jak widać na ilustracji 1.

   

   .

2. Kliknij Przejrzyj raport.

   Zanim wyślesz raport, możesz przejrzeć informacje, które są uwzględniono:

   

3. Po zakończeniu przeglądu skopiuj zawartość pliku raport do pliku i załącz go zgłoś błąd.

   Przesłanie raportu w ten sposób umożliwia Android Studio, komunikuje się z Tobą za pomocą narzędzia Issue Tracker podczas badania problemu problemy z pamięcią.

Jeśli IDE ulega awarii lub zgłasza wyjątki

W przypadku innych typów awarii dołącz znaleziony plik idea.log, wybierając Pomoc > Zbieraj dzienniki i dane diagnostyczne lub Pomoc > Pokaż pliki logowania (Pomoc > Pokaż log w Finderze w systemie macOS).

Generowanie zrzutu wątku

Zrzut wątku to wydruk wszystkich wątków uruchomionych w JVM. Dla każdej wartości , zawiera on wydruk wszystkich ramek stosu. Dzięki temu łatwo ją zauważyć czym zajmuje się IDE, zwłaszcza jeśli generujesz kilka że odstęp między nimi zmienia się o kilka sekund.

Gdy zgłaszasz błędy, w których IDE jest bardzo zajęte przez mocno obciążony procesor lub w którym IDE jest zablokowane, zrzut wątku może wskazać który kod wykonuje dużo pracy lub o które wątki rywalizują? zasobów i powodują zakleszczenie.

Pakiet JDK zawiera narzędzie o nazwie jstack, którego można użyć do wygenerowania zrzut wątku. Najpierw znajdź identyfikator procesu (PID) procesu w Android Studio. Aby to zrobić, użyj polecenia jps:

W systemie Linux lub macOS:

jps -mv | grep studio

Windows:

jps -mv | findstr studio

Powoduje to wydrukowanie długiej linii, np.:

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

Pierwsza liczba (w tym przykładzie 37605) to identyfikator procesu.

Następnie wygeneruj zrzut wątku i zapisz go w pliku dump.txt:

jstack -l pid >> dump.txt

Jeśli to nie zadziała, istnieją pewne dodatkowe metody, które działają w zależności od platformy może wygenerować zrzut wątku. Szczegółowe instrukcje znajdziesz w materiałach na temat Pomoc IntelliJ.

Szczegóły dotyczące narzędzi do kompilacji i błędów Gradle

Aby zgłosić błąd narzędzi do kompilacji lub Gradle, dołącz prawdziwy lub przykładowy projekt które ilustruje problem i umożliwia zapewnienie, że wszystkie informacje jest rejestrowany. Przed udostępnieniem usuń wszelkie informacje poufne.

Jeśli nie możesz udostępnić projektu, wskaż wersje narzędzi, których używasz . (przed zgłoszeniem problemu spróbuj użyć najnowszej wersji stabilnej lub testowej, ). Aby znaleźć wersje narzędzia:

• Wersja wtyczki Androida do obsługi Gradle:

  1. Wybierz Plik > Struktura projektu.
  2. Kliknij Projekt.
  3. Znajdź Wersja wtyczki Androida do obsługi Gradle.

• Wersja Gradle:

  1. Wybierz Plik > Struktura projektu.
  2. Kliknij Projekt.
  3. Znajdź Wersja Gradle.

• Wersja Android Studio:

  1. Wybierz Pomoc > Informacje.
  2. Odszukaj wersję Android Studio.

W razie potrzeby podaj również następujące informacje:

• Jeśli działanie zostało nieoczekiwanie zmienione z wcześniejszej wersji na bieżącej wersji, należy wskazać obie wersje.
• Jeśli kompilacja się nie udała z powodu błędu, uruchom ją z poziomu wiersza poleceń z opcją --stacktrace (np. ./gradlew <task> --stacktrace) i dodaj zrzut stosu do raportu o błędzie.
• Jeśli kompilacja trwa dłużej niż powinna, wypróbuj jedną z tych opcji:
  • Uruchom ./gradlew <task> --scan i udostępnij wygenerowany Skanowanie kompilacji Gradle w Twoim błędzie raport.
  • Uruchom ./gradlew <task> -Pandroid.enableProfileJson=true i udostępnij Śledzenie Chrome wygenerowane w katalogu <root-project>/build/android-profile.

Szczegóły błędów emulatora Androida

Wykonaj te czynności, aby zbierać informacje przy użyciu rozszerzonych ustawień emulatora i zgłoś błąd:

1. W panelu emulatora kliknij Więcej .

2. W oknie Rozszerzone elementy sterujące wybierz Raport o błędzie.

   Otworzy się ekran ze szczegółami dotyczącymi raportu o błędzie, takimi jak zrzut ekranu, informacje o konfiguracji AVD i dziennik raportów o błędach. Możesz wprowadzić kroki, aby odtworzyć je tutaj, lub poczekać i wpisać je w raport wygenerowany w następnym kroku.

3. Poczekaj na zakończenie zbierania raportu o błędzie, kliknij Wyślij do Google.

   Otworzy się okno, w którym możesz zapisać raport o błędzie w folderze. Twoja przeglądarka otwiera się także i tworzy w narzędziu Google Issue Tracker wszystkie niezbędne dane emulatora.

4. W raporcie podaj wszystkie pozostałe szczegóły, takie jak kroki odtworzyć błąd i załączyć pliki zapisane podczas jego tworzenia. raport.

W przeciwnym razie wpisz ręcznie te informacje:

• Wersja emulatora

  1. W emulatorze otwórz Rozszerzone elementy sterujące.
  2. Kliknij Pomoc.
  3. Aby znaleźć wersję emulatora, kliknij kartę Informacje.

• Wersja Android SDK Tools

  1. Wybierz Narzędzia > Menedżer pakietów SDK.
  2. Kliknij Narzędzia SDK.
  3. Znajdź Android SDK Tools.

• Model procesora hosta

  • W systemie Linux: otwórz /proc/cpuinfo.
  • W systemie Windows: kliknij prawym przyciskiem myszy Mój komputer i wybierz Właściwości.
  • W systemie macOS: wybierz ikonę Apple i kliknij O tym macOS

• Nazwa urządzenia

  1. W Menedżerze AVD kliknij, aby otworzyć menu w sekcji Działania. dla urządzenia.
  2. Wybierz Wyświetl szczegóły (lub otwórz plik $avdname.avd/config.ini).
  3. Znajdź wpis hw.device.name. Dla: przykład: hw.device.name=Nexus 5.