Segui i passaggi in questa pagina per completare una segnalazione di bug. Sono disponibili
le risorse per correggere i bug, in modo che i bug
le informazioni hanno la priorità. Le segnalazioni di bug incomplete vengono chiuse. Se questo
, invia nuovamente il bug con informazioni aggiuntive.
Per assicurarti di non segnalare un bug già risolto,
assicurati di usare le versioni più recenti degli strumenti. Puoi anche
cercare problemi simili nel
Issue Tracker di Android Studio
per vedere se il problema che stai riscontrando è già stato segnalato.
Come segnalare un bug
Per segnalare un bug, procedi nel seguente modo:
Per aprire una segnalazione di bug da Android Studio, seleziona
Guida > Invia feedback.
Questo è il modo più semplice per avviare un bug, perché compila la segnalazione di bug
con la tua versione di Android Studio, Kotlin o Java e il sistema
necessarie per riprodurre correttamente il problema.
Puoi anche
segnala il bug qui
e aggiungi tu le informazioni sulla versione.
Allega un report diagnostico per consentirci di eseguire il debug del problema. Per generare un
file ZIP del report sui dati diagnostici, fai clic su Guida > Raccogli log e dati diagnostici.
Descrivi i passaggi esatti per riprodurre il problema. Invia come
il maggior numero possibile di informazioni, inclusi snippet di codice, un progetto GitHub
utilizzabili per riprodurre il bug e screenshot o registrazioni di
che stai osservando.
Descrivi il problema in modo dettagliato. Spiega il risultato che ti aspettavi
e a ciò che invece hai osservato.
Scegli un titolo descrittivo per la segnalazione di bug. L'utilizzo di un modello
che facilita l'ordinamento in base al problema.
Per alcuni bug, abbiamo bisogno di informazioni aggiuntive, come descritto in
sezioni seguenti:
Per segnalare bug specifici di Android Studio, includi informazioni aggiuntive
come descritto in questa sezione.
Se l'IDE si blocca
Se l'IDE stesso sembra essere molto lento o bloccato,
generare un paio di dump dei thread come descritto in questa pagina
e allegarli alla segnalazione di bug. I dump dei thread mostrano ciò che sta facendo l'IDE
che lo rallenta.
Se l'IDE è lento ma non bloccato, allega il file idea.log al bug
report. Per allegare il file, seleziona Guida > Raccogli log e dati diagnostici
o Guida > Mostra file di accesso (Guida > Mostra Finder nel Finder su macOS).
Questo file mostra se l'IDE genera errori nel log.
Usa i profili CPU per diagnosticare la lentezza
Se noti una lentezza in Android Studio, i profili CPU possono:
a volte aiutano a diagnosticare il problema.
Segui questi passaggi per acquisire un profilo CPU usando Android Studio
Plug-in Performance Testing:
Installa il plug-in.
In Android Studio, cerca "Test del rendimento". nel plug-in
marketplace.
In alternativa, puoi scaricare una versione compatibile con Android Studio
dal sito web del plug-in.
Crea il profilo CPU.
Quando Android Studio sembra lento, scegli Avvia utilizzo CPU
Profilazione.
Ripetere alcune azioni per le quali la latenza è problematica
(il completamento del codice, la digitazione e l'attesa dell'evidenziazione per recuperare e così via).
Fai clic su Interrompi profilazione utilizzo CPU.
Condividi il file del profilo.
Viene visualizzato un fumetto con il nome file dello snapshot CPU, che
segue il formato snapshot-NNN. Condividi il file dello snapshot nel tuo
segnalazione di bug.
Se l'IDE esaurisce la memoria
I problemi di memoria in Android Studio a volte sono difficili da riprodurre e
report. Per risolvere questo problema, Android Studio include una quantità di memoria utilizzata
che puoi inviare al team di Android Studio per aiutarti a identificare
l'origine dei problemi di memoria.
Eseguire un report sull'utilizzo della memoria
Per eseguire un report sull'utilizzo della memoria, segui questi passaggi:
Fai clic su Guida > Analizza l'utilizzo della memoria dalla barra dei menu.
Android Studio esegue il dump dell'heap e ti chiede di riavviare l'IDE. Se
riavvia l'IDE, l'analisi del dump dell'heap viene avviata immediatamente. In caso contrario,
l'analisi del dump dell'heap viene avviata la prossima volta che esegui Android Studio. In
caso, l'IDE ti avvisa quando il report sull'utilizzo della memoria è pronto
come mostrato nella figura 1.
Figura 1. Memoria
Utilizza la notifica di segnalazione. di Gemini Advanced.
Fai clic su Esamina report.
Prima di inviare la segnalazione, puoi esaminare le informazioni
inclusi:
Figura 2. L'uso della memoria
Analisi del rapporto.
Al termine della revisione, copia i contenuti del
segnalare in un file e allegarlo quando
segnalare il bug.
Se invii le informazioni del report in questo modo, Android Studio
comunicano con te utilizzando Issue Tracker durante l'analisi dei tuoi
o problemi di memoria.
Se l'IDE si arresta in modo anomalo o genera eccezioni
Per altri tipi di arresti anomali, allega il file idea.log trovato selezionando
Guida > Raccogli log e dati diagnostici o Guida > Mostra file di accesso
(Guida > Mostra Finder nel Finder su macOS).
Genera un dump del thread
Un dump dei thread è una stampa di tutti i thread in esecuzione nella JVM. Per ogni
include una stampa di tutti gli stackframe. In questo modo è facile vedere
di ciò che sta facendo l'IDE, soprattutto se generi un paio
il dump dei thread l'uno dall'altro.
Quando segnali bug in cui l'IDE è estremamente impegnato con una CPU ancorata o
in cui l'IDE sembra essere bloccato, un dump di thread può individuare
quale codice sta svolgendo molto lavoro o quali thread sono in concorrenza
delle risorse e causando un deadlock.
Il JDK viene fornito con uno strumento denominato jstack che può essere utilizzato per generare
il dump del thread. Innanzitutto, trova l'ID (PID) del processo di Android Studio.
Per farlo, utilizza il comando jps:
Il primo numero (37605, in questo esempio) è l'ID di processo.
Quindi, genera un dump di thread e salvalo in un file dump.txt:
jstack -l pid >> dump.txt
Se il problema persiste, esistono altri modi specifici delle piattaforme
può generare un dump dei thread. Per istruzioni dettagliate, vedi
Assistenza di Intelligence.
Dettagli per gli strumenti di creazione e i bug Gradle
Per segnalare un bug per gli strumenti di creazione o per Gradle, allega un progetto reale o di esempio
che evidenzi il problema per garantire che tutte le informazioni
necessaria. Rimuovi eventuali informazioni sensibili prima di condividerle.
Se non riesci a condividere un progetto, indica le versioni degli strumenti che utilizzi
che utilizzano. Prova a utilizzare l'ultima versione stabile o di anteprima prima di segnalare un
). Per trovare le versioni dello strumento:
Versione del plug-in Android per Gradle:
Seleziona File > Struttura del progetto.
Fai clic su Progetto.
Individua la versione del plug-in Android Gradle.
Versione Gradle:
Seleziona File > Struttura del progetto.
Fai clic su Progetto.
Individua Gradle Version.
Versione di Android Studio:
Seleziona Guida > Informazioni.
Individua Versione di Android Studio.
Inoltre, se possibile, includi le seguenti informazioni:
Se un comportamento è cambiato inaspettatamente da una versione precedente a
alla versione corrente, indica entrambe le versioni.
Se la build non è riuscita e si è verificato un errore, esegui la build dalla riga di comando
con l'opzione --stacktrace (ad esempio ./gradlew <task> --stacktrace)
e fornisci un'analisi dello stack nella segnalazione di bug.
Se la build richiede più tempo del previsto, prova una delle seguenti soluzioni:
Esegui ./gradlew <task> -Pandroid.enableProfileJson=true e condividi
Chrome-trace
generati nella directory <root-project>/build/android-profile.
Dettagli sui bug dell'emulatore Android
Segui questi passaggi per utilizzare i controlli estesi dell'emulatore per raccogliere informazioni
e segnala un bug:
Nel riquadro dell'emulatore, fai clic su More (Altro) .
Nella finestra Controlli estesi, seleziona Segnalazione di bug.
Si apre una schermata con i dettagli della segnalazione di bug come
screenshot, le informazioni di configurazione della durata di visualizzazione media e un log di segnalazione di bug.
Puoi inserire i passaggi per riprodurli qui o attendere e inserirli in
generato nel passaggio successivo.
Attendi il termine della raccolta della segnalazione di bug, quindi
Fai clic su Invia a Google.
Si apre una finestra in cui puoi salvare la segnalazione di bug in una cartella. Il tuo browser
si apre anche per creare un report nello strumento Issue Tracker di Google con
sono stati compilati i dettagli necessari dell'emulatore.
Nel report, completa i dettagli rimanenti, ad esempio i passaggi per
riproduci il bug e allega i file salvati durante la creazione del bug
report.
Altrimenti, inserisci manualmente i seguenti dettagli:
Versione dell'emulatore
Nell'emulatore, apri Controlli estesi.
Fai clic su Guida.
Fai clic sulla scheda Informazioni per trovare la versione dell'emulatore.
Versione di Android SDK Tools
Seleziona Strumenti > SDK Manager.
Fai clic su Strumenti SDK.
Individua Android SDK Tools.
Modello CPU host
Su Linux: apri /proc/cpuinfo.
Su Windows: fai clic con il tasto destro del mouse su Risorse del computer e seleziona Proprietà.
In macOS: seleziona l'icona Apple e fai clic su Informazioni su questo Mac
Nome del dispositivo
Da Gestione AVD, fai clic per aprire il menu nella sezione Azioni
colonna per il dispositivo.
Seleziona Visualizza dettagli (oppure
apri il file $avdname.avd/config.ini).
Trova la voce hw.device.name. Per
esempio: hw.device.name=Nexus 5.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
.