Questa pagina fornisce assistenza per la risoluzione dei problemi e risposte alle domande più frequenti sull'utilizzo di Crashlytics. Se non riesci a trovare quello che stai cercando o hai bisogno di ulteriore aiuto, contatta l'assistenza Firebase .
Risoluzione dei problemi generali/FAQ
Potresti notare due formati diversi per i problemi elencati nella tabella Problemi nella console Firebase. E potresti anche notare una funzionalità chiamata "varianti" in alcuni dei tuoi problemi. Ecco perché!
All'inizio del 2023, abbiamo implementato un motore di analisi migliorato per il raggruppamento degli eventi, nonché un design aggiornato e alcune funzionalità avanzate per i nuovi numeri (come le varianti!). Dai un'occhiata al nostro recente post sul blog per tutti i dettagli, ma puoi leggere di seguito per i punti salienti.
Crashlytics analizza tutti gli eventi della tua app (come arresti anomali, eventi non fatali e ANR) e crea gruppi di eventi chiamati problemi : tutti gli eventi in un problema hanno un punto di errore comune.
Per raggruppare gli eventi in questi problemi, il motore di analisi migliorato ora esamina molti aspetti dell'evento, inclusi i frame nell'analisi dello stack, il messaggio di eccezione, il codice di errore e altre caratteristiche della piattaforma o del tipo di errore.
Tuttavia, all'interno di questo gruppo di eventi, le analisi dello stack che portano all'errore potrebbero essere diverse. Un'analisi dello stack diversa potrebbe significare una causa principale diversa. Per rappresentare questa possibile differenza all'interno di un problema, ora creiamo varianti all'interno dei problemi: ciascuna variante è un sottogruppo di eventi in un problema che hanno lo stesso punto di errore e una traccia dello stack simile. Con le varianti, puoi eseguire il debug delle analisi dello stack più comuni all'interno di un problema e determinare se diverse cause principali stanno causando l'errore.
Ecco cosa sperimenterai con questi miglioramenti:
Metadati rinnovati visualizzati nella riga del problema
Ora è più semplice comprendere e valutare i problemi nella tua app.Meno problemi duplicati
Una modifica del numero di riga non comporta un nuovo problema.Debug più semplice di problemi complessi con varie cause principali
Utilizza le varianti per eseguire il debug delle analisi dello stack più comuni all'interno di un problema.Avvisi e segnali più significativi
Un nuovo problema rappresenta in realtà un nuovo bug.Ricerca più potente
Ogni numero contiene più metadati ricercabili, come il tipo di eccezione e il nome del pacchetto.
Ecco come verranno implementati questi miglioramenti:
Quando riceviamo nuovi eventi dalla tua app, controlleremo se corrispondono a un problema esistente.
Se non c'è corrispondenza, applicheremo automaticamente il nostro algoritmo di raggruppamento degli eventi più intelligente all'evento e creeremo un nuovo problema con il design dei metadati rinnovato.
Questo è il primo grande aggiornamento che stiamo apportando al nostro raggruppamento di eventi. Se hai feedback o riscontri problemi, faccelo sapere inviando una segnalazione.
Se non visualizzi metriche prive di arresti anomali (come utenti e sessioni senza arresti anomali) e/o avvisi di velocità, assicurati di utilizzare l'SDKCrashlytics SDK v18.6.0+ (o Firebase BoM v32.6.0+).
Se non visualizzi i log breadcrumb , ti consigliamo di controllare la configurazione della tua app per Google Analytics. Assicurati di soddisfare i seguenti requisiti:
Hai abilitato Google Analytics nel tuo progetto Firebase.
Hai abilitato la condivisione dei dati per Google Analytics. Scopri di più su questa impostazione in Gestisci le impostazioni di condivisione dei dati di Analytics
Hai aggiuntoaggiunto l'SDK Firebase per Google Analyticsalla tua app. Questo SDK deve essere aggiunto in aggiunta all'SDK di Crashlytics.
Stai utilizzando le ultime versioni dell'SDK di Firebasele ultime versioni dell'SDK di Firebaseper tutti i prodotti che utilizzi nella tua app.
In particolare, verifica di utilizzare almeno la seguente versione dell'SDK Firebase per Google Analytics:
Android : v17.2.3+ (distinta base v24.7.1+) .
Crashlytics supporta la segnalazione ANR per le app Android da dispositivi che eseguono Android 11 e versioni successive. L'API sottostante che utilizziamo per raccogliere ANR ( getHistoricalProcessExitReasons ) è più affidabile di SIGQUIT o degli approcci basati su watchdog. Questa API è disponibile solo su dispositivi Android 11+.
Se in alcuni dei tuoi ANR mancano i relativi BuildId , risolvi il problema come segue:
Assicurati di utilizzare una versione aggiornata dell'SDK Android di Crashlytics e del plug-in Crashlytics Gradle.
Se ti mancano
BuildIdper Android 11 e alcuni ANR di Android 12, è probabile che tu stia utilizzando un SDK, un plug-in Gradle o entrambi non aggiornati. Per raccogliere correttamenteBuildIdper questi ANR, è necessario utilizzare le seguenti versioni:- SDK Android Crashlytics v18.3.5+ (Firebase BoM v31.2.2+)
- Plug-in Crashlytics Gradle v2.9.4+
Controlla se stai utilizzando una posizione non standard per le tue librerie condivise.
Se ti mancano solo
BuildIdper le librerie condivise della tua app, è probabile che non stai utilizzando la posizione standard predefinita per le librerie condivise. In questo caso, Crashlytics potrebbe non essere in grado di individuare iBuildIdassociati. Ti consigliamo di prendere in considerazione l'utilizzo del percorso standard per le librerie condivise.Assicurati di non rimuovere
BuildIddurante il processo di compilazione.Tieni presente che i seguenti suggerimenti per la risoluzione dei problemi si applicano sia agli ANR che agli arresti anomali nativi.
Controlla se i
BuildIdesistono eseguendoreadelf -nsui tuoi binari. Se iBuildIdsono assenti, aggiungi-Wl,--build-idai flag per il tuo sistema di compilazione.Controlla di non rimuovere involontariamente i
BuildIdnel tentativo di ridurre le dimensioni dell'APK.Se conservi versioni eliminate e non eliminate di una libreria, assicurati di puntare alla versione corretta nel tuo codice.
Potrebbe verificarsi una mancata corrispondenza tra il conteggio degli ANR tra Google Play e Crashlytics. Ciò è previsto a causa della differenza nel meccanismo di raccolta e comunicazione dei dati ANR. Crashlytics segnala gli ANR al successivo avvio dell'app, mentre Android Vitals invia i dati ANR dopo che si è verificato l'ANR.
Inoltre, Crashlytics mostra solo gli ANR che si verificano su dispositivi con Android 11+, rispetto a Google Play che mostra gli ANR da dispositivi con servizi Google Play e consenso alla raccolta dati accettato.
Le toolchain LLVM e GNU hanno impostazioni predefinite e trattamenti distinti per il segmento di sola lettura dei file binari della tua app, che potrebbero generare analisi dello stack incoerenti nella console Firebase. Per mitigare questo problema, aggiungi i seguenti flag del linker al processo di compilazione:
Se stai utilizzando il linker
llddalla toolchain LLVM, aggiungi:-Wl,--no-rosegmentSe stai utilizzando il linker
ld.golddalla toolchain GNU, aggiungi:-Wl,--rosegment
Se continui a riscontrare incoerenze nell'analisi dello stack (o se nessuno dei due flag è pertinente alla tua toolchain), prova invece ad aggiungere quanto segue al processo di compilazione:
-fno-omit-frame-pointer
Il plugin Crashlytics raggruppa un generatore di file di simboli Breakpad personalizzato . Se preferisci utilizzare il tuo codice binario per generare file di simboli Breakpad (ad esempio, se preferisci creare tutti gli eseguibili nativi nella catena di compilazione dall'origine), utilizza la proprietà di estensione facoltativa symbolGeneratorBinary per specificare il percorso dell'eseguibile.
È possibile specificare il percorso del generatore binario del file di simboli Breakpad in due modi:
Opzione 1 : specifica il percorso tramite l'estensione
firebaseCrashlyticsnel filebuild.gradleAggiungi quanto segue al file
build.gradlea livello di app:android { // ... buildTypes { // ... release { // ... firebaseCrashlytics { // existing; required for either symbol file generator nativeSymbolUploadEnabled true // Add this optional new block to specify the path to the executable symbolGenerator { breakpad { binary file("/PATH/TO/BREAKPAD/DUMP_SYMS") } } } } }Opzione 2 : specifica il percorso tramite una linea di proprietà nel file delle proprietà Gradle
Puoi utilizzare la proprietà
com.google.firebase.crashlytics.symbolGeneratorBinaryper specificare il percorso dell'eseguibile.Puoi aggiornare manualmente il file delle proprietà di Gradle o aggiornare il file tramite la riga di comando. Ad esempio, per specificare il percorso tramite la riga di comando, utilizzare un comando come il seguente:
./gradlew -Pcom.google.firebase.crashlytics.symbolGenerator=breakpad \ -Pcom.google.firebase.crashlytics.symbolGeneratorBinary=/PATH/TO/BREAKPAD/DUMP_SYMS \ app:assembleRelease app:uploadCrashlyticsSymbolFileRelease
Se vedi la seguente eccezione, è probabile che tu stia utilizzando una versione di DexGuard incompatibile con l'SDK Firebase Crashlytics:
java.lang.IllegalArgumentException: Transport backend 'cct' is not registered
Questa eccezione non provoca l'arresto anomalo dell'app ma le impedisce di inviare report sugli arresti anomali. Per risolvere questo problema:
Assicurati di utilizzare l'ultima versione di DexGuard 8.x. La versione più recente contiene le regole richieste dall'SDK Firebase Crashlytics.
Se non desideri modificare la versione di DexGuard, prova ad aggiungere la seguente riga alle regole di offuscamento (nel file di configurazione di DexGuard):
-keepresourcexmlelements manifest/application/service/meta-data@value=cct
Quando un'app utilizza un offuscatore che non espone l'estensione del file, Crashlytics genera ogni problema con un'estensione del file .java per impostazione predefinita.
Affinché Crashlytics possa generare problemi con l'estensione file corretta, assicurati che la tua app utilizzi la seguente configurazione:
- Utilizza Android Gradle 4.2.0 o versione successiva
- Utilizza R8 con l'offuscamento attivato. Per aggiornare la tua app alla R8, segui questa documentazione .
Tieni presente che dopo l'aggiornamento alla configurazione descritta sopra, potresti iniziare a vedere nuovi problemi .kt che sono duplicati di problemi .java esistenti. Consulta le domande frequenti per saperne di più su tale circostanza.
A partire da metà dicembre 2021, Crashlytics ha migliorato il supporto per le applicazioni che utilizzano Kotlin.
Fino a poco tempo fa, gli offuscatori disponibili non esponevano l'estensione del file, quindi Crashlytics generava ogni problema con un'estensione del file .java per impostazione predefinita. Tuttavia, a partire da Android Gradle 4.2.0, R8 supporta le estensioni di file.
Con questo aggiornamento, Crashlytics ora può determinare se ogni classe utilizzata all'interno dell'app è scritta in Kotlin e includere il nome file corretto nella firma del problema. Gli arresti anomali ora vengono attribuiti correttamente ai file .kt (a seconda dei casi) se la tua app ha la seguente configurazione:
- La tua app utilizza Android Gradle 4.2.0 o versione successiva.
- La tua app utilizza R8 con l'offuscamento attivato.
Poiché i nuovi arresti anomali ora includono l'estensione file corretta nelle firme dei problemi, potresti vedere nuovi problemi .kt che in realtà sono solo duplicati di problemi esistenti con etichetta .java . Nella console Firebase, proviamo a identificare e comunicarti se un nuovo problema .kt è un possibile duplicato di un problema esistente con etichetta .java .
Le note consentono ai membri del progetto di commentare questioni specifiche con domande, aggiornamenti di stato, ecc.
Quando un membro del progetto pubblica una nota, questa viene etichettata con l'e-mail del suo account Google. Questo indirizzo email è visibile, insieme alla nota, a tutti i membri del progetto con accesso per visualizzare la nota.
Di seguito viene descritto l'accesso richiesto per visualizzare, scrivere ed eliminare le note:
I membri del progetto con uno qualsiasi dei seguenti ruoli possono visualizzare ed eliminare le note esistenti e scrivere nuove note su un problema.
I membri del progetto con uno qualsiasi dei seguenti ruoli possono visualizzare le note pubblicate su un problema, ma non possono eliminare o scrivere una nota.
Consulta Comprendere le metriche senza arresti anomali .
Le note consentono ai membri del progetto di commentare questioni specifiche con domande, aggiornamenti di stato, ecc.
Quando un membro del progetto pubblica una nota, questa viene etichettata con l'e-mail del suo account Google. Questo indirizzo email è visibile, insieme alla nota, a tutti i membri del progetto con accesso per visualizzare la nota.
Di seguito viene descritto l'accesso richiesto per visualizzare, scrivere ed eliminare le note:
I membri del progetto con uno qualsiasi dei seguenti ruoli possono visualizzare ed eliminare le note esistenti e scrivere nuove note su un problema.
I membri del progetto con uno qualsiasi dei seguenti ruoli possono visualizzare le note pubblicate su un problema, ma non possono eliminare o scrivere una nota.
Integrazioni
Se il tuo progetto utilizza Crashlytics insieme a Google Mobile Ads SDK, è probabile che i crash reporter interferiscano durante la registrazione dei gestori delle eccezioni. Per risolvere il problema, disattiva la segnalazione degli arresti anomali nell'SDK Mobile Ads chiamando disableSDKCrashReporting .
Dopo aver collegato Crashlytics a BigQuery, i nuovi set di dati creati vengono automaticamente posizionati negli Stati Uniti, indipendentemente dalla posizione del tuo progetto Firebase.
Supporto della piattaforma
Firebase Crashlytics NDK non supporta ARMv5 (armeabi). Il supporto per questo ABI è stato rimosso a partire da NDK r17.
Problemi regrediti
Si è verificata una regressione di un problema dopo averlo chiuso in precedenza, ma Crashlytics riceve un nuovo report indicante che il problema si è ripresentato. Crashlytics riapre automaticamente questi problemi regrediti in modo che tu possa risolverli in modo appropriato per la tua app.
Di seguito è riportato uno scenario di esempio che spiega in che modo Crashlytics classifica un problema come regressione:
- Per la prima volta in assoluto, Crashlytics riceve un rapporto sull'incidente relativo al Crash "A". Crashlytics apre un problema corrispondente per quell'arresto anomalo (problema "A").
- Correggi rapidamente questo bug, chiudi il problema "A" e quindi rilasci una nuova versione della tua app.
- Crashlytics riceve un altro rapporto sul problema "A" dopo che hai chiuso il problema.
- Se il report proviene da una versione dell'app di cui Crashlytics era a conoscenza quando hai chiuso il problema (il che significa che la versione aveva inviato un report di arresto anomalo per qualsiasi arresto anomalo), Crashlytics non considererà il problema regredito. La questione resterà chiusa.
- Se il rapporto proviene da una versione dell'app di cui Crashlytics non era a conoscenza quando hai chiuso il problema (il che significa che la versione non ha mai inviato alcun rapporto sugli arresti anomali per alcun arresto anomalo), Crashlytics considera il problema regredito e lo riaprirà .
Quando un problema regredisce, inviamo un avviso di rilevamento della regressione e aggiungiamo un segnale di regressione al problema per farti sapere che Crashlytics ha riaperto il problema. Se non desideri che un problema si riapra a causa del nostro algoritmo di regressione, "disattiva" il problema invece di chiuderlo.
Se un rapporto proviene da una versione precedente dell'app che non ha mai inviato alcun rapporto sugli arresti anomali quando hai chiuso il problema, Crashlytics considererà il problema regredito e lo riaprirà.
Questa situazione può verificarsi nella seguente situazione: hai corretto un bug e rilasciato una nuova versione della tua app, ma hai ancora utenti con versioni precedenti senza la correzione del bug. Se, per caso, una di quelle versioni precedenti non avesse mai inviato alcun rapporto sugli arresti anomali quando hai chiuso il problema e quegli utenti iniziassero a riscontrare il bug, quei rapporti sugli arresti anomali attiverebbero un problema regredito.
Se non desideri che un problema si riapra a causa del nostro algoritmo di regressione, "disattiva" il problema invece di chiuderlo.