Zacznij korzystać z Firebase Crashlytics

Ten quickstart opisuje jak skonfigurować Firebase Crashlytics w swojej aplikacji z Firebase Crashlytics SDK, dzięki czemu można uzyskać kompleksowe raporty o awariach w konsoli Firebase .

Zanim zaczniesz

  1. Jeśli jeszcze nie masz, dodać Firebase do projektu iOS. Jeśli nie masz aplikację na iOS, można pobrać aplikację próbki .

  2. Zalecane: Aby uzyskać funkcje, takie jak wolne zderzeniowych użytkowników, dzienniki breadcrumb i alerty prędkości, musisz włączyć Google Analytics w projekcie Firebase.

    • Jeśli istniejący projekt Firebase nie ma włączonego Google Analytics, można włączyć Google Analytics z zakładki Integrations swoich > Ustawienia projektu w konsoli Firebase.

    • Jeśli tworzysz nowy projekt Firebase, włącz Google Analytics podczas procesu tworzenia projektu.

Krok 1: Włącz Crashlytics w konsoli Firebase

  1. Idź na desce rozdzielczej Crashlytics w konsoli Firebase.

  2. Upewnij się, że aplikacja została wybrana z listy rozwijanej obok Crashlytics na górze strony.

  3. Kliknij Włącz Crashlytics.

Krok 2: Dodaj Firebase Crashlytics SDK do aplikacji

  1. Otwórz utworzony dla danego projektu Firebase się podfile i dodać FirebaseCrashlytics kapsułę.

    Dla optymalnego doświadczenia z Crashlytics zalecamy umożliwiając Google Analytics w projekcie Firebase i dodanie kapsułę Firebase dla Google Analytics do swojej aplikacji.

    pod 'Firebase/Crashlytics'
    
    # Recommended: Add the Firebase pod for Google Analytics
    pod 'Firebase/Analytics'
    
  2. Zainstalować strąków, a następnie ponownie otwórz .xcworkspace plik, aby zobaczyć projekt w Xcode:

    pod install
    open your-project.xcworkspace
    
  3. Zaimportować moduł Firebase w UIApplicationDelegate :

    Szybki

    import Firebase

    Cel C

    @import Firebase;
  4. Skonfiguruj FirebaseApp wspólne wystąpienie, zazwyczaj w swojej aplikacji application:didFinishLaunchingWithOptions: metodę:

    Szybki

      // Use the Firebase library to configure APIs.
      FirebaseApp.configure()
      

    Cel C

      // Use the Firebase library to configure APIs.
      [FIRApp configure];
      

Krok 3: Skonfiguruj Xcode automatycznie przesyłać pliki dSYM

Aby wygenerować czytelne dla człowieka raporty o awariach, Crashlytics potrzebuje plików symboli debugowania (dSYM) projektu. Poniższe kroki opisują, jak skonfigurować Xcode, aby automatycznie generował pliki dSYM, przetwarzał je i przesyłał pliki za każdym razem, gdy tworzysz aplikację.

  1. Otwórz obszar roboczy Xcode projektu, a następnie wybierz jego plik projektu w lewym nawigatorze.

  2. Z listy celów, wybierz swój główny cel kompilacji.

  3. Kliknij kartę Ustawienia budować, a następnie wykonaj następujące kroki, aby Xcode produkuje dSYMs dla Twojego buduje.

    1. Kliknij wszystko, a następnie szukać debug information format .

    2. Format zestaw Debug Informacje Krasnal z pliku dSYM dla wszystkich typów kompilacji.

  4. Kliknij kartę Fazy budowy, a następnie wykonaj następujące kroki, aby Xcode można przetwarzać dSYMs i przesyłać pliki.

    1. Kliknij > New Run Script fazę.

      Upewnij się, że ta nowa faza Run Script jest ostatnia faza budować swój projektu; w przeciwnym razie Crashlytics nie może poprawnie przetworzyć plików dSYM.

    2. Rozwinąć nową sekcję Run Script.

    3. W polu skryptu (znajduje się pod marką Shell), dodaj następujący skrypt run.

      Ten skrypt przetwarza pliki dSYM Twojego projektu i przesyła je do Crashlytics.

      "${PODS_ROOT}/FirebaseCrashlytics/run"
    4. W sekcji pliki wejściowe, należy dodać ścieżkę do następujących plików.

      • Dodaj ścieżkę do plików dSYM swojego projektu

        Dzięki temu Crashlytics może szybciej przetwarzać pliki dSYM dla dużych aplikacji.

        ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${TARGET_NAME}
      • Dodaj ścieżkę do budowy Twojego projektu Info.plist pliku

        Dzięki temu Crashlytics może powiązać wersję aplikacji z plikami dSYM.

        $(SRCROOT)/$(BUILT_PRODUCTS_DIR)/$(INFOPLIST_PATH)

Aby uzyskać więcej szczegółowych informacji na temat plików dSYM i Crashlytics (w tym, jak ręcznie przesyłać pliki dSYM), wizyta Get deobfuscated raporty o awariach .

Krok 4: Uruchom projekt

Uruchom swoją aplikację. Dzienniki urządzenia powinny zawierać potwierdzenie Firebase, że inicjowanie zostało zakończone.

Krok 5: Siła crash testy, aby zakończyć konfigurację

Aby zakończyć konfigurowanie Crashlytics i wyświetlić początkowe dane w panelu Crashlytics konsoli Firebase, musisz wymusić awarię testową.

Aby uzyskać szczegółowe informacje na ten temat można znaleźć na stronie przetestować swoją implementację .

Następne kroki