Se la tua app per Android contiene librerie native: puoi abilitare analisi complete dello stack e report dettagliati sugli arresti anomali per il codice nativo da Firebase Crashlytics con alcuni piccoli aggiornamenti alla build della tua app configurazione.
Questa guida descrive come configurare i report sugli arresti anomali con SDK Firebase Crashlytics per NDK.
Se stai cercando come iniziare a utilizzare Crashlytics nel tuo account Unity per i tuoi progetti, consulta Guida introduttiva di Unity.
Prima di iniziare
Se non l'hai già fatto, aggiungi Firebase al tuo account Android. progetto. Se non hai un'app Android, puoi scaricare Un'app di esempio.
Consigliato: per visualizzare automaticamente log breadcrumb per comprendere le azioni degli utenti che hanno portato a un evento di arresto anomalo, non irreversibile o ANR. devi abilitare Google Analytics nel tuo progetto Firebase.
Se nel tuo progetto Firebase esistente Google Analytics non è attivato, puoi attivarlo dalla scheda Integrazioni del tuo
nella console > Impostazioni progettoFirebase. Se stai creando un nuovo progetto Firebase, abilita Google Analytics durante il flusso di lavoro di creazione del progetto.
Assicurati che la tua app abbia le seguenti versioni minime richieste:
- Gradle 8.0
- Plug-in Android per Gradle 8.1.0
- Plug-in Gradle dei servizi Google 4.4.1
Passaggio 1: aggiungi l'SDK Crashlytics per NDK alla tua app
Nel file Gradle del modulo (a livello di app) (di solito<project>/<app-module>/build.gradle.kts
o
<project>/<app-module>/build.gradle
),
aggiungi la dipendenza per la libreria NDK Crashlytics per Android. Ti consigliamo di utilizzare
Firebase Android BoM
per controllare il controllo
delle versioni delle librerie.
Per un'esperienza ottimale con Crashlytics, ti consigliamo attivazione di Google Analytics nel tuo progetto Firebase e l'aggiunta dell'SDK Firebase per Google Analytics alla tua app.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.2.0")) // Add the dependencies for the Crashlytics NDK and Analytics libraries // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-crashlytics-ndk") implementation("com.google.firebase:firebase-analytics") }
Se utilizzi Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Firebase Android.
(alternativa) Aggiungi dipendenze della libreria Firebase senza utilizzare il BoM
Se scegli di non utilizzare Firebase BoM, devi specificare ogni versione della libreria Firebase nella sua linea di dipendenza.
Tieni presente che se utilizzi più librerie Firebase nella tua app, ti consigliamo consiglia di utilizzare BoM per gestire le versioni della libreria, in modo da garantire che tutte le versioni siano compatibili.
dependencies { // Add the dependencies for the Crashlytics NDK and Analytics libraries // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-crashlytics-ndk:19.0.3") implementation("com.google.firebase:firebase-analytics:22.1.0") }
Passaggio 2: aggiungi il plug-in Crashlytics Gradle alla tua app
Nel file Gradle a livello principale (a livello di progetto) (
<project>/build.gradle.kts
o<project>/build.gradle
), aggiungi il Plug-in Crashlytics Gradle per il bloccoplugins
:Kotlin
plugins { // Make sure that you have the AGP plugin 8.1+ dependency id("com.android.application") version "8.1.4" apply false // ... // Make sure that you have the Google services Gradle plugin 4.4.1+ dependency id("com.google.gms.google-services") version "4.4.2" apply false // Add the dependency for the Crashlytics Gradle plugin id("com.google.firebase.crashlytics") version "3.0.2" apply false }
Groovy
plugins { // Make sure that you have the AGP plugin 8.1+ dependency id 'com.android.application' version '8.1.4' apply false // ... // Make sure that you have the Google services Gradle plugin 4.4.1+ dependency id 'com.google.gms.google-services' version '4.4.2' apply false // Add the dependency for the Crashlytics Gradle plugin id 'com.google.firebase.crashlytics' version '3.0.2' apply false }
Nel file Gradle del modulo (a livello di app) (di solito
<project>/<app-module>/build.gradle.kts
o<project>/<app-module>/build.gradle
), aggiungi il plug-in Gradle Crashlytics:Kotlin
plugins { id("com.android.application") // ... // Make sure that you have the Google services Gradle plugin id("com.google.gms.google-services") // Add the Crashlytics Gradle plugin id("com.google.firebase.crashlytics") }
Groovy
plugins { id 'com.android.application' // ... // Make sure that you have the Google services Gradle plugin id 'com.google.gms.google-services' // Add the Crashlytics Gradle plugin id 'com.google.firebase.crashlytics' }
Passaggio 3: aggiungi l'estensione Crashlytics alla tua build
Nel file Gradle del modulo (a livello di app)
(di solito <project>/<app-module>/build.gradle.kts
o
<project>/<app-module>/build.gradle
), configura l'estensione Crashlytics.
Kotlin
import com.google.firebase.crashlytics.buildtools.gradle.CrashlyticsExtension // ... android { // ... buildTypes { getByName("release") { // Add this extension configure<CrashlyticsExtension> { // Enable processing and uploading of native symbols to Firebase servers. // By default, this is disabled to improve build speeds. // This flag must be enabled to see properly-symbolicated native // stack traces in the Crashlytics dashboard. nativeSymbolUploadEnabled = true } } } }
Groovy
// ... android { // ... buildTypes { release { // Add this extension firebaseCrashlytics { // Enable processing and uploading of native symbols to Firebase servers. // By default, this is disabled to improve build speeds. // This flag must be enabled to see properly-symbolicated native // stack traces in the Crashlytics dashboard. nativeSymbolUploadEnabled true } } } }
Passaggio 4: configura il caricamento automatico dei simboli nativi
Per generare analisi dello stack leggibili dagli arresti anomali NDK, Crashlytics deve conoscere
sui simboli nei tuoi file binari nativi. Plug-in per Gradle Crashlytics
include i uploadCrashlyticsSymbolFileBUILD_VARIANT
per automatizzare questo processo.
Per poter accedere all'attività per il caricamento automatico dei simboli, assicurati che
nativeSymbolUploadEnabled
sia impostato sutrue
nel tuo modulo (a livello di app) file Gradle.Affinché i nomi dei metodi vengano visualizzati nelle tracce dello stack, devi invocare esplicitamente il compito
uploadCrashlyticsSymbolFileBUILD_VARIANT
dopo ogni compilazione della libreria NDK. Ad esempio:>./gradlew app:assembleBUILD_VARIANT\ app:uploadCrashlyticsSymbolFileBUILD_VARIANT
Sia l'SDK Crashlytics per NDK sia il plug-in Gradle Crashlytics dipendono dalla presenza dell'ID build GNU all'interno degli oggetti nativi condivisi.
Puoi verificare la presenza di questo ID eseguendo
su ogni programma binario. Se l'ID build è assente, aggiungireadelf -n
ai flag del sistema di compilazione per risolvere il problema.-Wl,--build-id
Passaggio 5: forza un arresto anomalo di test per completare la configurazione
Per completare la configurazione di Crashlytics e visualizzare i dati iniziali nel Dashboard Crashlytics della console Firebase, devi forzare un test in modo anomalo.
Aggiungi alla tua app codice da utilizzare per forzare un arresto anomalo di test.
Puoi usare il seguente codice in
MainActivity
della tua app per aggiungere un pulsante all'app che, se premuto, provoca un arresto anomalo. Il pulsante è etichettato come "Test di arresto anomalo".Kotlin+KTX
val crashButton = Button(this) crashButton.text = "Test Crash" crashButton.setOnClickListener { throw RuntimeException("Test Crash") // Force a crash } addContentView(crashButton, ViewGroup.LayoutParams( ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT))
Java
Button crashButton = new Button(this); crashButton.setText("Test Crash"); crashButton.setOnClickListener(new View.OnClickListener() { public void onClick(View view) { throw new RuntimeException("Test Crash"); // Force a crash } }); addContentView(crashButton, new ViewGroup.LayoutParams( ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT));
Crea ed esegui la tua app.
Forza l'arresto anomalo del test per inviare il primo report sugli arresti anomali della tua app:
Apri l'app dal dispositivo di test o dall'emulatore.
Nell'app, premi il pulsante "Test arresto anomalo" che hai aggiunto utilizzando il codice in alto.
Dopo l'arresto anomalo dell'app, riavviala in modo che possa inviare l'arresto anomalo a Firebase.
Vai alla dashboard di Crashlytics del Console Firebase per vedere l'arresto anomalo del test.
Se hai aggiornato la console e ancora non vedi l'arresto anomalo del test dopo cinque minuti, attivare il logging di debug per controllare se la tua app invia report sugli arresti anomali.
E questo è tutto. Crashlytics ora monitora la tua app per rilevare gli arresti anomali e puoi visualizzare e analizzare i report e le statistiche sugli arresti anomali nella dashboard di Crashlytics.
Passaggi successivi
(Consigliato) Assistenza per il debug degli arresti anomali causati da errori di memoria nativi di raccolta Report GWP-ASan. Questi errori relativi alla memoria possono essere associati a un danneggiamento della memoria all'interno della tua app, che è la causa principale delle vulnerabilità di sicurezza delle app. Per sfruttare questa funzione di debug, assicurati che la tua app abbia GWP-ASan esplicitamente abilitato e utilizza l'SDK Crashlytics più recente per NDK (v18.3.6+ o Firebase BoM versione 31.3.0 e successive).
Personalizza configurazione dei report sugli arresti anomali aggiungendo report di attivazione, log, chiavi il monitoraggio di errori non irreversibili.
Esegui l'integrazione con Google Play in modo da poter filtrare i report sugli arresti anomali della tua app per Android in base al canale Google Play direttamente nella dashboard di Crashlytics. In questo modo puoi concentrare meglio la tua dashboard su build specifiche.
Risoluzione dei problemi
Se visualizzi analisi dello stack diverse nella console Firebase e del logcat, consulta la Guida alla risoluzione dei problemi.
Opzioni alternative per il caricamento di simboli
Il flusso di lavoro principale in questa pagina qui sopra è applicabile alle build Gradle standard. Tuttavia, alcune app utilizzano una configurazione o strumenti diversi (ad esempio diverso da Gradle). In questi casi, è possibile che le seguenti opzioni siano utile per caricare correttamente i simboli.
Opzione: carica i simboli per i moduli della raccolta e le dipendenze esterne
Questa opzione può essere utile nelle seguenti situazioni:
- Se utilizzi un processo di compilazione NDK personalizzato all'interno di Gradle
- Se le tue librerie native sono create in un modulo libreria/funzionalità o fornite da una terza parte
- Se l'attività di caricamento automatico del simbolo non funziona o nella dashboard vengono visualizzati arresti anomali non simbolizzati
Opzione: carica simboli per build non di Gradle o librerie native inaccessibili senza striping
Questa opzione può essere utile nelle seguenti situazioni:
Se utilizzi un processo di compilazione diverso da Gradle
Se ti vengono fornite librerie native senza debug, non sono accessibili durante le build di Gradle