Inizia con Firebase Crashlytics

Questa guida di avvio rapido descrive come configurare Firebase Crashlytics nella tua app con l'SDK Firebase Crashlytics in modo da poter ottenere report completi sugli arresti anomali nella console Firebase.

La configurazione di Crashlytics richiede attività sia nella console Firebase che nel tuo IDE (come l'aggiunta di un file di configurazione Firebase e dell'SDK di Crashlytics). Per completare la configurazione, dovrai forzare un arresto anomalo di prova per inviare il primo rapporto sull'arresto anomalo a Firebase.

Prima di iniziare

Se non l'hai già fatto, aggiungi Firebase al tuo progetto Apple. Se non disponi di un'app Apple, puoi scaricare un'app di esempio .
Consigliato : per ottenere funzionalità come utenti senza arresti anomali, registri breadcrumb e avvisi di velocità, devi abilitare Google Analytics nel tuo progetto Firebase.
Tutte le piattaforme Apple supportate da Crashlytics (eccetto watchOS) possono sfruttare queste funzionalità di Google Analytics. Tieni presente che è necessario l'SDK v8.9.0+ per le app macOS e tvOS.
- Se il tuo progetto Firebase esistente non ha Google Analytics abilitato, puoi abilitare Google Analytics dalla scheda Integrazioni del tuo > Impostazioni progetto nella console Firebase.
- Se stai creando un nuovo progetto Firebase, abilita Google Analytics durante il flusso di lavoro di creazione del progetto.

Passaggio 1 : aggiungi l'SDK Crashlytics alla tua app

Utilizza Swift Package Manager per installare e gestire le dipendenze di Firebase.

In Xcode, con il progetto dell'app aperto, vai a File > Add Packages .
Quando richiesto, aggiungi il repository SDK delle piattaforme Apple Firebase:

  https://github.com/firebase/firebase-ios-sdk.git

Scegli la libreria Crashlytics.

Aggiungi il flag -ObjC alla sezione Altri flag del linker delle impostazioni di build del tuo target.

Per un'esperienza ottimale con Crashlytics, ti consigliamo di abilitare Google Analytics nel tuo progetto Firebase e di aggiungere l'SDK Firebase per Google Analytics alla tua app. È possibile selezionare la libreria senza raccolta IDFA o con raccolta IDFA.

Al termine, Xcode inizierà automaticamente a risolvere e scaricare le tue dipendenze in background.

Successivamente, configura il modulo Firebase:

Importa il modulo Firebase nella struttura App o UIApplicationDelegate :
Veloce
```
import Firebase
```
Obiettivo-C
```
@import Firebase;
```
Configura un'istanza condivisa FirebaseApp , in genere nel metodo application(_:didFinishLaunchingWithOptions:) del delegato dell'app:
Veloce
```
// Use the Firebase library to configure APIs.
FirebaseApp.configure()
```
Obiettivo-C
```
// Use the Firebase library to configure APIs.
[FIRApp configure];
```

Passaggio 2 : configura Xcode per caricare automaticamente i file dSYM

Per generare report sugli arresti anomali leggibili, Crashlytics necessita dei file dei simboli di debug (dSYM) del tuo progetto. I passaggi seguenti descrivono come configurare Xcode per produrre automaticamente i tuoi dSYM, elaborarli e caricare i file ogni volta che crei la tua app.

Apri l'area di lavoro Xcode del tuo progetto, quindi seleziona il file di progetto nel navigatore di sinistra.
Dall'elenco TARGETS , seleziona il target di build principale.
Fai clic sulla scheda Impostazioni build , quindi completa i passaggi seguenti in modo che Xcode produca dSYM per le tue build.
1. Fare clic su Tutto , quindi cercare debug information format .
2. Imposta il formato delle informazioni di debug su DWARF with dSYM File per tutti i tipi di build.
Fai clic sulla scheda Fasi di creazione , quindi completa i passaggi seguenti in modo che Xcode possa elaborare i tuoi dSYM e caricare i file.
1. Fare clic su > Nuova fase Esegui script .
  Assicurati che questa nuova fase Esegui script sia l'ultima fase di compilazione del tuo progetto; in caso contrario, Crashlytics non sarà in grado di elaborare correttamente i dSYM.
2. Espandi la nuova sezione Esegui script .
  Nota: per i restanti passaggi secondari, copia e incolla i percorsi esattamente come specificato e Xcode li risolverà. Tuttavia, se riscontri problemi con Xcode nella risoluzione di questi percorsi o con una struttura di progetto univoca, puoi invece specificare manualmente i percorsi.
3. Nel campo script (situato sotto l'etichetta Shell ), aggiungi il seguente script di esecuzione.
  Questo script elabora i file dSYM del tuo progetto e carica i file su Crashlytics.
```
"${BUILD_DIR%/Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run"
```
4. Nella sezione File di input , aggiungi i percorsi per le posizioni dei 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)
```
  Comprendi perché sono necessarie le posizioni di questi file
  Xcode cerca questi file di input nelle posizioni specificate per garantire che i file di build siano disponibili per lo script di esecuzione. Inoltre, se il sandboxing degli script utente è abilitato, Xcode consente solo allo script di esecuzione di accedere ai file specificati in Input Files .
  - Fornire la posizione dei file dSYM del tuo progetto consente a Crashlytics di elaborare i dSYM.
  - Fornire la posizione del file GoogleService-Info.plist creato dalla tua app consente a Crashlytics di associare i dSYM alla tua app Firebase.
  - Fornire la posizione dell'eseguibile dell'app consente allo script di esecuzione di impedire caricamenti duplicati dello stesso dSYM. Tieni presente che i file binari dell'app non vengono caricati .

Per informazioni più dettagliate sui file dSYM e Crashlytics (incluso come caricare manualmente i file dSYM), visita Ottieni rapporti sugli arresti anomali deoffuscati .

Passaggio 3 : forza un arresto anomalo del test per completare la configurazione

Per completare la configurazione di Crashlytics e visualizzare i dati iniziali nella dashboard di Crashlytics della console Firebase, devi forzare un arresto anomalo del test.

Aggiungi codice alla tua app che puoi utilizzare per forzare un arresto anomalo del test.

Puoi utilizzare il codice seguente per aggiungere un pulsante alla tua app che, se premuto, provoca un arresto anomalo. Il pulsante è etichettato "Test Crash".

SwiftUI

Button("Crash") {
  fatalError("Crash was triggered")
}

UIKit

Veloce

import UIKit

class ViewController: UIViewController {
  override func viewDidLoad() {
      super.viewDidLoad()

      // Do any additional setup after loading the view, typically from a nib.

      let button = UIButton(type: .roundedRect)
      button.frame = CGRect(x: 20, y: 50, width: 100, height: 30)
      button.setTitle("Test Crash", for: [])
      button.addTarget(self, action: #selector(self.crashButtonTapped(_:)), for: .touchUpInside)
      view.addSubview(button)
  }

  @IBAction func crashButtonTapped(_ sender: AnyObject) {
      let numbers = [0]
      let _ = numbers[1]
  }
}

Obiettivo-C

#import "ViewController.h"

@implementation ViewController
‐ (void)viewDidLoad {
    [super viewDidLoad];

    // Do any additional setup after loading the view, typically from a nib.

    UIButton* button = [UIButton buttonWithType:UIButtonTypeRoundedRect];
    button.frame = CGRectMake(20, 50, 100, 30);
    [button setTitle:@"Test Crash" forState:UIControlStateNormal];
    [button addTarget:self action:@selector(crashButtonTapped:)
        forControlEvents:UIControlEventTouchUpInside];
    [self.view addSubview:button];
}

‐ (IBAction)crashButtonTapped:(id)sender {
    @[][1];
}

@end

Crea ed esegui la tua app in Xcode con il debugger Xcode disconnesso.
Il debugger Xcode impedisce l'invio di report sugli arresti anomali a Crashlytics. Completa i passaggi seguenti per disconnettere il dispositivo di test o il simulatore dal debugger Xcode prima di forzare un arresto anomalo.
1. Fai clic su Crea, quindi esegui lo schema corrente per creare la tua app su un dispositivo di test o un simulatore.
2. Attendi finché l'app non è in esecuzione, quindi fai clic su Interrompi l'esecuzione dello schema o dell'azione per chiudere l'istanza iniziale della tua app. Questa istanza iniziale includeva il debugger che interferisce con Crashlytics.
Forza l'arresto anomalo del test per inviare il primo rapporto sull'arresto anomalo della tua app:
1. Apri la tua app dalla schermata principale del tuo dispositivo di test o simulatore.
2. Nella tua app, premi il pulsante "Test Crash" che hai aggiunto utilizzando il codice sopra.
3. Dopo che l'app si è arrestata in modo anomalo, eseguila di nuovo da Xcode in modo che la tua app possa inviare il rapporto sull'arresto anomalo a Firebase.
Vai alla dashboard Crashlytics della console Firebase per vedere l'arresto anomalo del test.
Se hai aggiornato la console e non vedi ancora l'arresto anomalo del test dopo cinque minuti, abilita la registrazione del debug per vedere se la tua app sta inviando rapporti sugli arresti anomali.

E questo è tutto! Crashlytics ora monitora gli arresti anomali della tua app. Visita la dashboard di Crashlytics per visualizzare ed esaminare tutti i report e le statistiche.

Prossimi passi

Personalizza la configurazione del rapporto sugli arresti anomali aggiungendo rapporti, registri, chiavi e monitoraggio degli errori non fatali.