Uzyskiwanie czytelnych raportów o awariach w panelu Crashlytics (Unity)

Wybierz platformę:

iOS+ Android Flutter Unity

iOS+ (platformy Apple)

W przypadku aplikacji na platformy Apple korzystających z pakietu SDK Unity w wersji 8.2.0 lub nowszej wtyczka Firebase Unity Editor automatycznie konfiguruje projekt Xcode do przesyłania symboli.Crashlytics Pobierz najnowszą wersję.

Android

W przypadku aplikacji na Androida pakiet SDK Unity w wersji 8.6.1 lub nowszej automatycznie zawiera raportowanie awarii NDK, co umożliwia Crashlytics automatyczne raportowanie awarii Unity IL2CPP na Androidzie.Crashlytics Aby jednak wyświetlać w panelu Crashlytics ślady stosu z symbolami w przypadku awarii biblioteki natywnej , musisz przesłać informacje o symbolach podczas kompilacji za pomocą interfejsu wiersza poleceń Firebase.

1. Upewnij się, że używasz pakietu SDK Unity w wersji 8.6.1 lub nowszej.Crashlytics Pobierz najnowszą wersję.

2. Skonfiguruj środowisko i projekt do przesyłania symboli:

   1. Postępuj zgodnie z instrukcjami, aby zainstalować interfejs wiersza poleceń Firebase.

      Jeśli interfejs wiersza poleceń jest już zainstalowany, upewnij się, że zaktualizowałeś go do najnowszej wersji.

   2. (tylko w przypadku aplikacji korzystających z interfejsu API Androida na poziomie 30 lub wyższym) Zaktualizuj szablon AndroidManifest.xml aplikacji, aby wyłączyć oznaczanie wskaźników:

      1. Zaznacz pole Android Player Settings > Publishing Settings > Build > Custom Main Manifest (Ustawienia odtwarzacza Androida > Ustawienia publikowania > Kompilacja > Niestandardowy główny manifest).

      2. Otwórz szablon manifestu znajdujący się w Assets/Plugins/Android/AndroidManifest.xml.

      3. (tylko w przypadku aplikacji korzystających z pakietu SDK w wersji wcześniejszej niż 8.8.0) Dodaj do tagu aplikacji ten atrybut: <application android:allowNativeHeapPointerTagging="false" ... />

3. Skompiluj projekt i prześlij symbole.

   Wykonaj te czynności za każdym razem, gdy tworzysz kompilację do publikacji lub inną kompilację, w przypadku której chcesz wyświetlać w panelu Crashlytics zrzuty stosu z symbolami.

   1. W oknie Build Settings (Ustawienia kompilacji) wykonaj jedną z tych czynności:

      • wyeksportuj projekt do projektu Android Studio, aby go skompilować;

      • skompiluj plik APK bezpośrednio w edytorze Unity.
        Przed kompilacją upewnij się, że w oknie Build Settings (Ustawienia kompilacji) jest zaznaczone pole wyboru Create symbols.zip (Utwórz plik symbols.zip).

   2. Gdy kompilacja się zakończy, wygeneruj plik symboli zgodny z Crashlytics i prześlij go na serwery Firebase, uruchamiając to polecenie interfejsu wiersza poleceń Firebase:

      firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

      • FIREBASE_APP_ID: identyfikator aplikacji Firebase na Androida (nie nazwa pakietu)
        Przykładowy identyfikator aplikacji Firebase na Androida: 1:567383003300:android:17104a2ced0c9b9b

        Nie wiesz, gdzie znaleźć identyfikator aplikacji Firebase?

        Oto 2 sposoby na znalezienie identyfikatora aplikacji Firebase:

        • W pliku google-services.json identyfikator aplikacji to wartość mobilesdk_app_id.

        • W konsoli Firebase otwórz stronę ustawień settings Ustawienia > Ogólne page. Przewiń do karty Twoje aplikacje i kliknij odpowiednią aplikację Firebase, aby znaleźć jej identyfikator.

      • PATH/TO/SYMBOLS: ścieżka do pliku symboli wygenerowanego przez interfejs wiersza poleceń

        • Wyeksportowano do projektu Android Studio — PATH/TO/SYMBOLS to katalog unityLibrary/symbols, który jest tworzony w katalogu głównym wyeksportowanego projektu po skompilowaniu aplikacji za pomocą Gradle lub Android Studio.

        • Plik APK został skompilowany bezpośrednio w Unity – PATH/TO/SYMBOLS to ścieżka do spakowanego pliku symboli wygenerowanego w katalogu głównym projektu po zakończeniu kompilacji (np.: myproject/myapp-1.0-v100.symbols.zip).

      Wyświetl opcje zaawansowane używania Firebase polecenia interfejsu wiersza poleceń do generowania i przesyłania pliku symboli

      Flaga	Opis
      --generator=csym	Zamiast domyślnego generatora Breakpad używa starszego generatora pliku symboli cSYM. Nie zalecamy używania. Zalecamy używanie domyślnego Breakpad symbol file generator.
      --generator=breakpad	Używa generatora pliku symboli Breakpad. Pamiętaj, że domyślnym generatorem pliku symboli jest Breakpad. Używaj tej flagi tylko wtedy, gdy dodasz symbolGenerator { csym() } w konfiguracji kompilacji i chcesz ją zastąpić, aby używać Breakpad.
      --dry-run	Generuje pliki symboli, ale ich nie przesyła. Ta flaga jest przydatna, jeśli chcesz sprawdzić zawartość plików, które są wysyłane.
      --debug	Podaje dodatkowe informacje na potrzeby debugowania.