Ricevi report leggibili sugli arresti anomali nella dashboard di Crashlytics


Per impostazione predefinita, Firebase Crashlytics elabora automaticamente i file di simboli di debug (dSYM) per fornirti report sugli arresti anomali deoffuscati e leggibili. Generalmente, questo comportamento viene configurato durante la configurazione iniziale di Crashlytics nella tua app, in particolare aggiungendo uno script di esecuzione che carica automaticamente i file dSYM durante la fase di compilazione dell'app.

Purtroppo, in alcuni casi il caricamento automatico dei file dSYM potrebbe non riuscire. Questa guida fornisce alcuni modi per risolvere i problemi quando Crashlytics non riesce a individuare i file dSYM della tua app.

Assicurati che Xcode possa elaborare automaticamente i file dSYM e caricarli

Quando hai configurato Crashlytics nella tua app, hai configurato uno script di esecuzione per elaborare automaticamente i file dSYM e caricarli.

Assicurati che la configurazione dello script di esecuzione Crashlytics sia aggiornata in base ai nuovi requisiti introdotti con Xcode 15. Se la configurazione non è aggiornata, potresti visualizzare il seguente errore:
error: Info.plist Error Unable to process Info.plist at path ....

Nello specifico, Xcode 15 e versioni successive richiedono di fornire un insieme più completo di percorsi dei file. Per lo script di esecuzione Crashlytics (firebase-ios-sdk/Crashlytics/run), assicurati di avere la seguente configurazione:

  1. Fai clic sulla scheda Fasi di compilazione ed espandi la sezione Esegui script.

  2. Nella sezione File di input, assicurati di avere i percorsi per le posizioni degli seguenti file:

    ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}
    ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}
    ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Info.plist
    $(TARGET_BUILD_DIR)/$(UNLOCALIZED_RESOURCES_FOLDER_PATH)/GoogleService-Info.plist
    $(TARGET_BUILD_DIR)/$(EXECUTABLE_PATH)

Controlla se Xcode genera file dSYM

Il più delle volte, i file dSYM mancano perché Xcode semplicemente non li genera. Quando un caricamento non va a buon fine, Crashlytics mostra un avviso "File dSYM mancante" nella console Firebase. Se ricevi questo avviso, verifica innanzitutto che Xcode produca il file dSYM corretto per ogni build:

  1. Apri il progetto in Xcode, quindi seleziona il file del progetto nel Navigatore di Xcode.

  2. Seleziona il target di compilazione principale.

  3. Apri la scheda Impostazioni di compilazione del target e fai clic su Tutte.

  4. Cerca debug information format.

  5. Imposta Formato informazioni di debug su DWARF con file dSYM per tutti i tipi di build.

  6. Ricostruisci l'app.

I report sugli arresti anomali dovrebbero ora essere visualizzati nella dashboard di Crashlytics. Se il problema persiste o se riscontri altri errori, prova a individuare i file dSYM e a caricarli manualmente su Crashlytics.

Individuare i file dSYM su una macchina locale

Esegui il seguente comando per visualizzare tutti gli UUID dei file dSYM sulla tua macchina e cercare il file dSYM mancante:

mdfind -name .dSYM | while read -r line; do dwarfdump -u "$line"; done

Una volta trovato il file dSYM, caricalo manualmente su Crashlytics. Se il comando mdfind non restituisce risultati, puoi cercare nella directory Products in cui si trova .app (per impostazione predefinita, la directory Products si trova in Derived Data). Se la tua app è stata rilasciata in produzione, puoi anche cercare il relativo file dSYM nella directory .xcarchive sul disco:

  1. In Xcode, apri la finestra Organizer (Organizza) e seleziona la tua app dall'elenco. Xcode mostra un elenco di archivi per il progetto.

  2. Fai clic con Control su un archivio per visualizzarlo in Finder. Fai di nuovo clic con il tasto Ctrl e poi su Mostra contenuto pacchetto.

  3. All'interno di .xcarchive è presente una directory dSYM che contiene i file dSYM generati nell'ambito del processo di archiviazione di Xcode.

Carica i file dSYM

Crashlytics supporta più modi per caricare i file dSYM, automaticamente o manualmente.

(Consigliato) Elabora automaticamente i file dSYM e caricali

Quando hai configurato inizialmente Crashlytics, molto probabilmente hai configurato questo comportamento di caricamento automatico per la tua app. Tuttavia, se i caricamenti automatici non vanno a buon fine, verifica che la configurazione sia corretta.

Carica manualmente i file dSYM

Se i caricamenti automatici non vanno a buon fine, puoi caricare manualmente i file dSYM utilizzando una delle seguenti opzioni.

  • Opzione 1: utilizza l'opzione "Trascina e rilascia" basata sulla console per caricare un file ZIP contenente i file dSYM (vai alla console Firebase > Crashlytics > scheda dSYM).

  • Opzione 2: utilizza lo script upload-symbols che puoi chiamare da qualsiasi punto del processo di compilazione per caricare manualmente i file dSYM. Per eseguire lo scriptupload-symbols, utilizza una delle seguenti opzioni:

    • Opzione A: includi la seguente riga nel processo di compilazione:

      find dSYM_DIRECTORY -name "*.dSYM" | xargs -I \{\} $PODS_ROOT/FirebaseCrashlytics/upload-symbols -gsp /PATH/TO/GoogleService-Info.plist -p PLATFORM \{\}
    • Opzione B: esegui lo script direttamente dal terminale:

      /PATH/TO/PODS/DIRECTORY/FirebaseCrashlytics/upload-symbols -gsp /PATH/TO/GoogleService-Info.plist -p ios /PATH/TO/dSYMs

    Per note sull'utilizzo e istruzioni aggiuntive su questo script, esegui upload-symbols con il parametro --help.