Analizza i problemi di Firebase Crashlytics e Android vitals con gli approfondimenti sulla qualità delle app

Puoi visualizzare e intervenire sui dati sugli arresti anomali dell'app da Firebase Crashlytics e Android vitals direttamente in Android Studio. Questa integrazione estrae i dati di analisi dello stack e le statistiche sugli arresti anomali da Crashlytics e Google Play nella finestra dello strumento App Quality Insights nell'IDE di Studio, in modo da non dover passare dal nostro browser all'IDE. I team di sviluppo possono trarre vantaggio da funzionalità chiave, tra cui:

  • Visualizza le righe del codice evidenziate quando contengono dati sugli eventi di Crashlytics correlati.
  • Controlla l'analisi dello stack per gli arresti anomali principali e fai clic sull'analisi dello stack per passare alle righe pertinenti del codice.
  • Visualizza statistiche di riepilogo sugli eventi principali di arresto anomalo e non irreversibili, ad esempio raggruppate per produttore del dispositivo e versione di Android.
  • Filtra gli eventi in base ad attributi come gravità, ora e versione dell'app.
  • Ottieni un link del browser che apre la pagina della dashboard di Crashlytics con ulteriori dettagli sull'evento.
  • Ottieni insight 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 della tua app. Ecco come: apri l'Assistente Firebase in Android Studio selezionando Strumenti > Firebase, fai clic su Crashlytics e segui il tutorial per aggiungere Firebase e Crashlytics al tuo progetto. Per ulteriori informazioni sul flusso di lavoro dell'Assistente Firebase, consulta la 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 Approfondimenti sulla qualità delle app. Dovresti vedere i riquadri Problemi, Analisi dello stack di esempio e Dettagli che vengono completati con i report di Crashlytics.

Analizzare Android vitals

Approfondimenti sulla qualità delle app include dati di Android vitals. In questo modo puoi accedere più facilmente alle metriche principali raccolte da Google Play e migliorare l'esperienza utente. Usa Android vitals per risolvere problemi relativi alla stabilità dell'app e migliorare la qualità della tua app su Google Play.

Dati Android vitals in Android Studio.

Puoi visualizzare i problemi di Android vitals, filtrarli, passare dall'analisi dello stack alla programmazione direttamente dalla finestra dello strumento Approfondimenti sulla qualità delle app. Per iniziare, segui questi passaggi:

  1. Accedi al tuo account sviluppatore in Android Studio utilizzando l'icona del profilo alla fine della barra degli strumenti.
  2. Apri Approfondimenti sulla qualità delle app facendo clic sulla finestra degli strumenti in Android Studio oppure su Visualizza > Finestre degli strumenti > Statistiche sulla qualità delle app.
  3. Fai clic sulla scheda Android vitals in Approfondimenti sulla qualità delle app.
  4. (Facoltativo) Per utilizzare l'integrazione del controllo della versione per una build di cui è possibile eseguire il debug, aggiungi all'app l'SDK Firebase Crashlytics più recente (o la distinta base di Firebase Android). Quindi, aggiungi il seguente codice al file build.gradle.kts o build.gradle a livello di modulo. Per le build release (non disponibili per il debug) il flag è abilitato per impostazione predefinita.

Kotlin

android {
  buildTypes {
    getByName("debug") {
      vcsInfo {
        include = true
      }
    }
  }
}

trendy

android {
  buildTypes {
    debug {
      vcsInfo {
        include true
      }
    }
  }
}

La finestra dello strumento Approfondimenti sulla qualità delle app contiene dati avanzati che forniscono informazioni sugli eventi riscontrati dagli utenti, nonché link per accedere rapidamente alle sorgenti di questi eventi.

Finestra dello strumento App Quality Insights (Approfondimenti sulla qualità delle app)

  1. Utilizza il menu a discesa ID applicazione per selezionare l'ID app da analizzare. Ad esempio, anche se potresti lavorare sulla versione di debug dell'app nell'IDE, potresti voler visualizzare i dati sugli eventi per la versione di produzione dell'app installata dagli utenti.
  2. Il riquadro Problemi mostra gli eventi principali per i quali Crashlytics dispone di dati e ordinati in base agli arresti anomali di maggiore impatto.
  3. Visualizza gli eventi per varianti o gruppi di eventi che hanno analisi dello stack simili. L'analisi degli eventi per variante consente di identificare le cause principali di un arresto anomalo.
  4. Il riquadro con l'analisi dello stack mostra i dettagli dell'ultima occorrenza dell'evento su cui fai clic sul riquadro Problemi. Puoi visualizzare l'analisi dello stack dell'evento e fare clic sull'analisi dello stack per passare alle righe pertinenti nel codebase. Se il codice è cambiato dopo l'arresto anomalo, fai clic su Mostra diff accanto all'errore nell'analisi dello stack per visualizzare una differenza tra il codice attuale e la versione del codebase che ha generato l'arresto anomalo.

    Opzione per mostrare le differenze nell'analisi dello stack dell'IQA.

    Nella dashboard di Firebase Crashlytics sono disponibili anche informazioni sul tipo di dispositivo interessato, la relativa versione di Android e l'ora in cui si è verificato l'evento, nonché un link all'evento. Fai clic sul pulsante Chiudi per chiudere un problema direttamente dal riquadro.

  5. Il riquadro Dettagli suddivide il numero di arresti anomali in base al tipo di dispositivo e alla versione di Android, in modo da poter determinare quali gruppi di utenti sono più interessati. Mostra anche le versioni dell'app che hanno subito l'arresto anomalo e il numero di utenti interessati.
  6. Leggi e allega note ai problemi in modo che siano visibili nella console Firebase e nei membri del tuo team. Per scrivere una nota su un problema, seleziona il problema e apri il riquadro Note. Per scrivere note, devi disporre dell'autorizzazione di scrittura per il progetto Crashlytics. I problemi relativi alle note vengono visualizzati con un'icona "Note" nel riquadro Problemi.
    Riquadro Note sulle informazioni sulla qualità delle app.
  7. Utilizza la varietà di filtri per concentrarti su determinati sottoinsiemi di eventi. Puoi selezionare o deselezionare gli eventi con stato irreversibile o non irreversibile , nonché filtrare per ora, versione dell'app, indicatore di Crashlytics, marca e modello del dispositivo e versione della piattaforma Android. Tieni presente che, per gli stati dell'indicatore di Crashlytics, un problema è considerato regredito quando è stato chiuso in passato e si è verificato di nuovo in una nuova versione dell'app.

Oltre a poter passare dall'analisi dello stack al codice, puoi anche passare dal codice all'analisi dello stack: Android Studio ora annota le righe di codice relative agli arresti anomali con un'icona di blocco degli arresti anomali per consentirti di individuarle ed eseguirne il debug facilmente.

Quando passi il mouse sopra l'icona di arresto anomalo, viene visualizzato un popup che mostra quanti eventi sono interessati da quella riga di codice e la frequenza degli eventi.

Riepilogo degli eventi quando passi il mouse sopra l'icona dell'arresto anomalo

Fai clic sull'icona dell'arresto anomalo per visualizzare un elenco più dettagliato degli eventi, inclusi la frequenza e il numero di utenti interessati da un determinato evento. Fai clic su un evento specifico per visualizzare i relativi dettagli nella finestra dello strumento App Quality Insights (Approfondimenti sulla qualità delle app).

Elenco di eventi quando fai clic sull'icona dell'arresto anomalo

Numeri diversi tra Android vitals e Crashlytics

Tieni presente che Android vitals e Crashlytics potrebbero segnalare valori diversi per il numero di utenti ed eventi associati allo stesso arresto anomalo. Queste discrepanze si verificano perché Play e Crashlytics possono rilevare gli arresti anomali in momenti diversi e per utenti diversi. Ecco un paio di motivi per cui i conteggi di Play e Crashlytics potrebbero essere diversi:

  • Play rileva gli arresti anomali a partire dal momento dell'avvio, mentre Crashlytics intercetta gli arresti anomali che si verificano dopo l'inizializzazione dell'SDK di Crashlytics.
  • Se un utente disattiva i report sugli arresti anomali quando acquista un nuovo telefono, questi arresti anomali non vengono segnalati a Play; tuttavia, Crashlytics rileva gli arresti anomali in base alle norme sulla privacy dell'app.

Indaga con funzionalità limitate quando sei offline

Se effettui una nuova richiesta, ad esempio facendo clic su Aggiorna, e Android Studio non riesce a comunicare con Crashlytics, la finestra Approfondimenti sulla qualità delle app ti consente di attivare la modalità offline.

Approfondimenti sulla qualità delle app offre 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 problemi di chiusura, non sono disponibili. Per ritentare la connessione a Crashlytics e tornare allo stato online, fai clic su Riconnetti.

Opzione di riconnessione per gli approfondimenti sulla qualità delle app in modalità offline.