Puoi visualizzare e intervenire sui dati relativi agli arresti anomali delle app di Firebase Crashlytics e Android Vitals direttamente in Android Studio. Questa integrazione estrae i dati della traccia dello stack e le statistiche sugli arresti anomali da Crashlytics e Google Play nella finestra dello strumento App Quality Insights nell'IDE Studio, quindi non devi più passare dal browser all'IDE e viceversa. I team di sviluppo possono usufruire di funzionalità chiave, tra cui:
- Visualizza le righe del codice evidenziate quando contengono dati sugli eventi di Crashlytics correlati.
- Visualizza l'analisi dello stack per i principali arresti anomali e fai clic sull'analisi dello stack per passare alle righe pertinenti del codice.
- Visualizza le statistiche di riepilogo relative agli eventi di arresto anomalo e non irreversibili principali, ad esempio grouped by device manufacturer and Android version.
- Filtra gli eventi in base ad attributi quali gravità, ora e versione dell'app.
- Ricevi un link del browser che apre la pagina della dashboard di Crashlytics con ulteriori dettagli sull'evento.
- Visualizza approfondimenti che ti aiutano a comprendere e risolvere più facilmente le cause principali di determinati problemi.
I report Android Vitals sono disponibili per tutte le app pubblicate su Google Play. Se non utilizzi ancora Crashlytics e vuoi saperne di più sulle sue offerte, consulta Firebase Crashlytics.
Inizia
Per visualizzare i dati di Crashlytics in Android Studio, devi configurare Firebase e Crashlytics nel progetto dell'app. Ecco come: apri l'Assistente Firebase in Android Studio selezionando Strumenti > Firebase, fai clic su Crashlytics e poi segui il tutorial per aggiungere Firebase e Crashlytics al tuo progetto. Puoi approfondire il flusso di lavoro dell'Assistente Firebase nella guida introduttiva di Firebase per Android.
Se hai già aggiunto Firebase e Crashlytics alla tua app, accedi al tuo account sviluppatore nell'IDE facendo clic sull'icona dell'avatar.
Dopo aver eseguito l'accesso, fai clic sulla finestra dello strumento App Quality Insights (Approfondimenti sulla qualità dell'app)
. Dovresti vedere i riquadri compilati con i report di Crashlytics.
Analizzare Android vitals
App Quality Insights include i dati di Android vitals. In questo modo, puoi accedere più facilmente alle metriche di base raccolte da Google Play e migliorare l'esperienza utente. Utilizza Android vitals per risolvere i problemi relativi alla stabilità dell'app e contribuire a migliorare la qualità della tua app su Google Play.
Puoi visualizzare i problemi di Android vitals, filtrarli e passare dall'analisi dello stack al codice dalla finestra dello strumento App Quality Insights. Per iniziare, segui questi passaggi:
- Accedi al tuo account sviluppatore in Android Studio utilizzando l'icona del profilo
nella parte finale della barra degli strumenti.
- Apri App Quality Insights facendo clic sulla finestra dello strumento in Android Studio o su Visualizza > Finestre degli strumenti > App Quality Insights.
- Fai clic sulla scheda Android vitals in App Quality Insights (App Quality Insights).
(Facoltativo) Per utilizzare l'integrazione del controllo versione per una build di debug, aggiungi alla tua app l'SDK Firebase Crashlytics (o la distinta componenti di Firebase Android) più recente. Poi aggiungi il seguente codice al file
build.gradle.kts
obuild.gradle
a livello di modulo. Le build di release (non debbugabili) hanno il flag abilitato per impostazione predefinita.
Kotlin
android { buildTypes { getByName("debug") { vcsInfo { include = true } } } }
Groovy
android { buildTypes { debug { vcsInfo { include true } } } }
Analizzare i dati di Crashlytics in Android Studio
La finestra dello strumento App Quality Insights contiene dati completi che forniscono informazioni sugli eventi riscontrati dagli utenti e link che ti consentono di accedere rapidamente alle origini di questi eventi.
- Utilizza il menu a discesa ID applicazione per selezionare l'ID app da analizzare. Ad esempio, anche se potresti lavorare sulla versione di debug della tua app nell'IDE, potresti voler visualizzare i dati sugli eventi per la versione di produzione dell'app installata dagli utenti.
- Il riquadro Problemi mostra gli eventi principali per i quali Crashlytics dispone di dati e viene ordinato in base agli arresti anomali più significativi.
- Visualizza gli eventi per varianti o gruppi di eventi con analisi dello stack simili. L'analisi degli eventi per variante ti aiuta a identificare le cause principali di un arresto anomalo.
La scheda Traccia dello stack mostra i dettagli dell'ultima occorrenza dell'evento su cui fai clic nel riquadro Problemi. Puoi visualizzare la traccia dello stack dell'evento e fare clic sulla traccia dello stack per passare alle righe pertinenti nel codice di base. Se il codice è cambiato dall'evento di arresto anomalo, fai clic su Mostra differenze accanto all'errore nell'analisi dello stack per visualizzare le differenze tra il codice corrente e la versione della base di codice che ha generato l'arresto anomalo.
Sono inoltre disponibili informazioni sul tipo di dispositivo interessato, sulla relativa versione di Android e sull'ora in cui si è verificato l'evento, nonché un link all'evento nella dashboard di Firebase Crashlytics. Per sfogliare le informazioni su più eventi in un gruppo, utilizza le frecce sinistra e destra. Fai clic su Chiudi problema per chiudere un problema direttamente dal riquadro.
- Le schede Chiavi e Log mostrano coppie chiave-valore e log personalizzati per ogni report di Crashlytics.
- Il riquadro Dettagli suddivide i conteggi degli arresti anomali in base al tipo di dispositivo e alla versione di Android, in modo da poter determinare i gruppi di utenti più interessati. Inoltre, mostra le versioni dell'app in cui si è verificato l'arresto anomalo e il numero di utenti interessati.
- Leggi e allega note ai problemi in modo che siano visibili nella Console Firebase e ai tuoi colleghi. Per scrivere una nota su un problema, selezionalo
e apri il riquadro Note. Per scrivere note, devi disporre dell'autorizzazione di scrittura per il progetto Crashlytics. I problemi relativi alle note sono contrassegnati da un'icona "Note"
nel riquadro Problemi.
- Utilizza la varietà di filtri per concentrarti su determinati sottoinsiemi di eventi. Puoi selezionare o deselezionare gli eventi Fatale
, Non fatale
, e ANR
, nonché filtrare per ora, versione dell'app, indicatore Crashlytics, marca e modello del dispositivo e versione della piattaforma Android. Tieni presente che per gli stati di indicatore di Crashlytics, un problema è considerato regredito se è stato chiuso in passato e si è verificato di nuovo in una nuova versione dell'app.
Oltre a poter passare dalla traccia dello stack al codice, ora puoi anche saltare dal codice alla traccia dello stack: Android Studio ora annota le righe di codice correlate agli arresti anomali con un'icona di interruzione
in modo da poterli individuare e eseguire il debug facilmente.
Quando passi il mouse sopra l'icona dell'arresto anomalo, viene visualizzato un popup che mostra il numero di eventi coinvolti in quella riga di codice e le relative frequenze.
Fai clic sull'icona dell'errore per visualizzare un elenco più dettagliato degli eventi, inclusa la frequenza e il numero di utenti interessati da un determinato evento. Fai clic su un evento specifico per passare ai relativi dettagli nella finestra dello strumento App Quality Insights.
Numeri diversi tra Android Vitals e Crashlytics
Tieni presente che Android vitals e Crashlytics potrebbero riportare valori diversi per il numero di utenti ed eventi associati allo stesso arresto anomalo. Queste discrepanze si verificano perché Play e Crashlytics possono rilevare arresti anomali in momenti diversi e per utenti diversi. Ecco alcuni motivi per cui i conteggi di Google Play e Crashlytics potrebbero essere diversi:
- Google Play rileva gli arresti anomali a partire dall'avvio, mentre Crashlytics rileva gli arresti anomali che si verificano dopo l'inizializzazione dell'SDK Crashlytics.
- Se un utente disattiva la generazione di report sugli arresti anomali quando riceve un nuovo smartphone, questi arresti anomali non vengono segnalati a Play; tuttavia, Crashlytics rileva gli arresti anomali in base alle proprie norme sulla privacy.
Eseguire accertamenti con funzionalità limitate quando sei offline
Se effettui una nuova richiesta, ad esempio facendo clic su Aggiorna, e Android Studio non è in grado di comunicare con Crashlytics, la finestra App Quality Insights consente di attivare la modalità offline.
In questa modalità, puoi continuare a esaminare i problemi e gli eventi più recenti
dai dati memorizzati nella cache. Alcune funzionalità, come la modifica di alcune opzioni di filtro o la chiusura dei problemi, non sono disponibili. Per riprovare a connetterti a Crashlytics
e tornare a uno stato online, fai clic su Ricollega
.