Una segnalazione di bug contiene log dei dispositivi, analisi dello stack e altri dati diagnostici.
informazioni utili per trovare e correggere i bug nella tua app. Acquisire un bug
report dal tuo dispositivo, utilizza lo sviluppatore Apri segnalazione bug.
sul dispositivo, il menu Android Emulator,
o il comando adb bugreport sulla tua macchina di sviluppo.
Figura 1. Opzioni sviluppatore su un dispositivo.
Per effettuare una segnalazione di bug, devi avere Le Opzioni sviluppatore attivate sul tuo dispositivo per accedere all'opzione Crea segnalazione di bug.
Acquisisci una segnalazione di bug da un dispositivo
Figura 2. La segnalazione di bug è pronta.
Per ricevere una segnalazione di bug direttamente dal dispositivo, procedi nel seguente modo:
- Abilita sviluppatore Opzioni.
- In Opzioni sviluppatore, tocca Apri segnalazione bug.
- Seleziona il tipo di segnalazione di bug che vuoi e tocca Segnala.
Dopo qualche istante, riceverai una notifica che ti informa che la segnalazione di bug è pronta, come come mostrato nella figura 2.
- Per condividere la segnalazione di bug, tocca la notifica.
Acquisisci una segnalazione di bug dall'emulatore Android
Dall'emulatore Android, puoi utilizzare il pulsante Segnala un bug. nei controlli estesi:
- Fai clic su Altro
nella
Riquadro dell'emulatore. Nella finestra Controlli estesi, seleziona Segnalazione di bug.
Si apre una schermata in cui puoi vedere i dettagli della segnalazione di bug, come screenshot, le informazioni di configurazione della durata di visualizzazione media e il log della segnalazione di bug. Puoi digita anche un messaggio con i passaggi di riproduzione da salvare con il report.
Attendi il termine della raccolta della segnalazione di bug, quindi fai clic su Salva report.
Acquisisci una segnalazione di bug utilizzando ADB
Se hai collegato un solo dispositivo, puoi ricevere una segnalazione di bug utilizzando
adb, come segue:
$ adb bugreport E:\Reports\MyBugReports
Se non specifichi un percorso per la segnalazione di bug, questa viene salvata in nella directory locale.
Se hai più dispositivi connessi, devi specificare il dispositivo con il
Opzione -s. Esegui questi comandi adb per
recupera il numero di serie del dispositivo e genera la segnalazione di bug:
$ adb devices List of devices attached emulator-5554 device 8XV7N15C31003476 device $ adb -s 8XV7N15C31003476 bugreport
Salvare una segnalazione di bug precedente
Per impostazione predefinita, le segnalazioni di bug vengono salvate in /bugreports e possono essere visualizzate utilizzando
seguente comando:
$ adb shell ls /bugreports/ bugreport-foo-bar.xxx.YYYY-MM-DD-HH-MM-SS-dumpstate_log-yyy.txt bugreport-foo-bar.xxx.YYYY-MM-DD-HH-MM-SS.zip dumpstate-stats.txt
Dopodiché potrai estrarre il file ZIP tramite adb pull:
$ adb pull /bugreports/bugreport-foo-bar.xxx.YYYY-MM-DD-HH-MM-SS.zip
Ispeziona il file ZIP della segnalazione di bug
Per impostazione predefinita, il file ZIP è chiamato
bugreport-BUILD_ID-DATE.zip. Il file ZIP
può contenere più file, ma il file più importante è
bugreport-BUILD_ID-DATE.txt. Questo
c'è la segnalazione di bug, che contiene
output diagnostico per servizi di sistema (dumpsys), log degli errori (dumpstate),
e i log dei messaggi di sistema (logcat). I messaggi di sistema includono analisi dello stack
quando il dispositivo genera un errore e messaggi scritti da tutte le app con
Log.
Il file ZIP contiene un file di metadati version.txt che contiene
la lettera di rilascio di Android. Quando systrace è abilitato, anche il file ZIP
contiene un file systrace.txt. La
Strumento Systrace
aiuta ad analizzare il rendimento
della tua app acquisendo e mostrando i tempi di esecuzione
processi dell'app e altri processi del sistema Android.
Lo strumento dumpstate copia i file dal file system del dispositivo
nel file ZIP all'interno della cartella FS per potervi far riferimento. Ad esempio:
un file /dirA/dirB/fileC nel dispositivo genera un
Voce FS/dirA/dirB/fileC nel file ZIP.
Figura 3. Struttura del file della segnalazione di bug.
Per ulteriori informazioni, vedi Leggere le segnalazioni di bug.
Ricevi i report dagli utenti
L'acquisizione di segnalazioni di bug è utile durante l'utilizzo dell'app ma gli utenti finali non riescono a condividere facilmente questo tipo di segnalazioni di bug con te. Per ottenere report sugli arresti anomali con analisi dello stack di utenti reali, sfruttare i report sugli arresti anomali di Google Play e Firebase le funzionalità di machine learning.
Google Play Console
Puoi ottenere report dal Google Play Console. per visualizzare dati su arresti anomali e applicazioni non rispondere a errori (ANR) degli utenti che hanno installato la tua app da Google Play. I dati sono disponibili per i sei mesi precedenti.
Per ulteriori informazioni, vedi Visualizzare gli errori relativi ad applicazioni che non rispondono (ANR) e ad arresti anomali nella guida di Play Console.
Report sugli arresti anomali di Firebase
I report Firebase Crashlytics creano report dettagliati sugli errori nei dell'app. Gli errori vengono raggruppati in problemi in base ad analisi dello stack simili e valutate in base alla gravità dell'impatto sui tuoi utenti. Oltre ai modelli puoi registrare eventi personalizzati per acquisire i passaggi che hanno portato all'arresto anomalo.
Per iniziare a ricevere report sugli arresti anomali da qualsiasi utente, aggiungi il
Dipendenze Firebase
al tuo file build.gradle. Per ulteriori informazioni, vedi
Firebase Crashlytics.