Check out what’s new from Firebase@ Google I/O 2021, and join our alpha program for early access to the new Remote Config personalization feature. Learn more

Zacznij korzystać z Firebase Crashlytics

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

Zanim zaczniesz

  1. Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu Unity. Jeśli nie masz projektu Unity, możesz pobrać przykładową aplikację .

    Pamiętaj, że dodanie Firebase do projektu Unity obejmuje zadania zarówno w konsoli Firebase, jak i w otwartym projekcie Unity (na przykład pobierasz pliki konfiguracyjne Firebase z konsoli, a następnie przenosisz je do swojego projektu Unity).

  2. Zalecane : aby korzystać z funkcji, takich jak użytkownicy bez awarii, dzienniki nawigacyjne i alerty dotyczące szybkości, musisz włączyć Google Analytics w swoim projekcie Firebase.

    • Jeśli w istniejącym projekcie Firebase nie włączono Google Analytics, możesz włączyć Google Analytics na karcie Integracje w > Ustawienia projektu w konsoli Firebase.

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

Krok 1 : skonfiguruj Crashlytics w konsoli Firebase

  1. Kliknij Crashlytics w lewym panelu nawigacyjnym konsoli Firebase .

  2. Jeśli w Twoim projekcie Firebase zarejestrowanych jest wiele aplikacji, wybierz właśnie dodaną aplikację z listy rozwijanej obok Crashlytics na górnym pasku konsoli.

  3. Kliknij Włącz Crashlytics .

Krok 2. Dodaj pakiet SDK Firebase Crashlytics do swojej aplikacji

  1. Pobierz pakiet Firebase Unity SDK , a następnie rozpakuj go w dogodnym miejscu.

    Pakiet Firebase Unity SDK nie jest specyficzny dla platformy.

  2. W otwartym projekcie Unity przejdź do Zasoby > Importuj pakiet > Pakiet niestandardowy .

  3. Z rozpakowanym SDK wybierz importować Crashlytics SDK ( FirebaseCrashlytics.unitypackage ).

    Możesz też zaimportować dowolny inny obsługiwany produkt Firebase .

  4. W oknie Importuj pakiet Unity kliknij opcję Importuj .

Krok 3 : Zainicjuj Crashlytics

  1. Utwórz nowy skrypt C#, a następnie dodaj go do GameObject w scenie.

    1. Otwórz swoją pierwszą scenę, a następnie utwórz pusty obiekt GameObject nazwie CrashlyticsInitializer .

    2. Kliknij Dodaj składnik w Inspektorze dla nowego obiektu.

    3. Wybierz skrypt CrashlyticsInit aby dodać go do obiektu CrashlyticsInitializer .

  2. Zainicjuj Crashlytics w metodzie Start skryptu:

    using System.Collections;
    using System.Collections.Generic;
    using UnityEngine;
    
    // Import Firebase
    using Firebase;
    
    public class CrashlyticsInit : MonoBehaviour {
        // Use this for initialization
        void Start () {
            // Initialize Firebase
            Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
                var dependencyStatus = task.Result;
                if (dependencyStatus == Firebase.DependencyStatus.Available)
                {
                    // Create and hold a reference to your FirebaseApp,
                    // where app is a Firebase.FirebaseApp property of your application class.
                    // Crashlytics will use the DefaultInstance, as well;
                    // this ensures that Crashlytics is initialized.
                    Firebase.FirebaseApp app = Firebase.FirebaseApp.DefaultInstance;
    
                    // Set a flag here for indicating that your project is ready to use Firebase.
                }
                else
                {
                    UnityEngine.Debug.LogError(System.String.Format(
                      "Could not resolve all Firebase dependencies: {0}",dependencyStatus));
                    // Firebase Unity SDK is not safe to use here.
                }
            });
        }
    
      // Update is called once per frame
      void Update()
        // ...
    }

Po dodaniu i zainicjowaniu pakietu SDK Crashlytics automatycznie rozpoczyna pracę, nasłuchując i zbierając raporty o awariach.

Krok 4 : Uruchom swój projekt

Po wyeksportowaniu projektu do systemu iOS lub Android , sprawdź, czy projekt został wyeksportowany poprawnie.

Jeśli wygląda na to, że brakuje plików po porównaniu Twojego projektu z przykładowymi konfiguracjami eksportu poniżej, otwórz edytor Unity, a następnie uruchom narzędzie do rozpoznawania usług Google Play .

iOS

Android

Uruchom przelicznik (opcjonalnie)

Programy rozpoznawania usług Google Play upewniają się, że projekt Unity ma odpowiednie zależności do eksportowania aplikacji na iOS lub Androida .

Aby uzyskać więcej informacji na temat przelicznika, odwiedź README dla Unity Jar Resolver .

iOS

iOS Resolver uruchamia się automatycznie i wykorzystuje Cocoapods do umieszczania zależności iOS w wyeksportowanym katalogu Pods .

  • Aby pobrać Cocoapods na swoją maszynę:

    • Przejdź do Zasoby > Rozwiąż Usługi Play > Rozwiąż iOS > Zainstaluj Cocoapods
  • Aby włączyć lub wyłączyć generowanie podfile (opcjonalnie) :

    • Przejdź do Zasoby > Rozdzielcz usług Play > Rozdzielczość iOS > Ustawienia

Android

Android Resolver uruchamia się automatycznie i wykorzystuje gradle aby umieścić zależności Androida w Assets/Plugins/Android .

  • Aby ręcznie uruchomić przelicznik:

    • Przejdź do Zasoby > Rozwiąż usługi Play > Rozwiąż Androida > Rozwiąż
  • Aby włączyć lub wyłączyć automatyczną rozdzielczość (domyślnie włączone):

    • Przejdź do Zasoby > Rozpoznawanie usług Play > Rozpoznawanie Androida > Ustawienia

Krok 5 : Wymuś awarię testową, aby zakończyć konfigurację

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

Szczegółowe informacje o tym, jak to zrobić, znajdziesz w artykule Testowanie implementacji .

Następne kroki