Zacznij korzystać z Firebase Crashlytics

W tym krótkim wprowadzeniu opisano, jak skonfigurować Firebase Crashlytics w swojej aplikacji za pomocą pakietu Firebase Crashlytics SDK, aby uzyskać szczegółowe raporty o awariach w konsoli Firebase.

Konfiguracja Crashlytics wymaga wykonania zadań zarówno w konsoli Firebase, jak i IDE (takich jak dodanie pliku konfiguracyjnego Firebase i pakietu Crashlytics SDK). Aby zakończyć konfigurację, musisz wymusić awarię testową, aby wysłać pierwszy raport o awarii do 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: 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ą.


I to wszystko! Crashlytics monitoruje teraz Twoją aplikację pod kątem awarii. Możesz przeglądać i analizować raporty o awariach oraz statystyki na pulpicie nawigacyjnym Crashlytics.

Następne kroki