Otrzymuj czytelne raporty o awariach w panelu Crashlytics


iOS+ (platformy Apple)

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

Android

W przypadku aplikacji na Androida pakiet Crashlytics Unity SDK w wersji 8.6.1 lub nowszej automatycznie zawiera Raportowanie awarii NDK umożliwiające usłudze Crashlytics automatyczne zgłaszanie Unity IL2CPP, na urządzeniach z Androidem. Aby jednak wyświetlić symbolizowane zrzuty stosu biblioteki natywnej w panelu Crashlytics, informacje o symbolach musisz przesłać na adres podczas kompilacji za pomocą interfejsu wiersza poleceń Firebase.

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

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

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

      Jeśli wiersz poleceń jest już zainstalowany, zaktualizuj go do najnowszej wersji.

    2. (tylko w przypadku aplikacji korzystających z interfejsu Android API na poziomie 30 lub wyższym) Zaktualizuj aplikację Szablon AndroidManifest.xml do wyłączenia tagowania wskaźnika:

      1. Zaznacz pole Ustawienia odtwarzacza Androida > Ustawienia publikacji > Kompilacja > Niestandardowy główny plik manifestu.

      2. Otwórz szablon pliku manifestu, który znajduje się w folderze Assets/Plugins/Android/AndroidManifest.xml.

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

  3. Utwórz projekt i prześlij symbole.

    Wykonuj te czynności za każdym razem, gdy tworzysz wersję wydania lub inną wersję, w przypadku której chcesz zobaczyć symboliczne ścieżki stosu w konsoli Firebase.

    1. W oknie Ustawienia kompilacji wykonaj jedną z tych czynności:

      • wyeksportować go do projektu w Android Studio, aby skompilować projekt; lub

      • Utwórz pakiet APK bezpośrednio w edytorze Unity.
        Przed rozpoczęciem budowania upewnij się, że pole wyboru Utwórz symbole.zip jest zaznaczone zaznaczono w oknie Ustawienia kompilacji.

    2. Po zakończeniu kompilacji wygeneruj plik symboli zgodny z Crashlytics i prześlij go na serwery Firebase, wykonując to polecenie 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

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

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

        • Plik APK został utworzony bezpośrednio w Unity – PATH/TO/SYMBOLS to ścieżka skompresowanego pliku symboli wygenerowane w katalogu głównym projektu po zakończeniu kompilacji (na przykład: myproject/myapp-1.0-v100.symbols.zip).

      Wyświetl zaawansowane opcje korzystania z Polecenie interfejsu wiersza poleceń Firebase do generowania i przesyłania pliku symboli

      Zgłoś Opis
      --generator=csym

      Używa starszego generatora plików symboli cSYM zamiast domyślny generator Breakpada

      Niezalecane. Zalecamy użycie domyślnego generatora plików symboli Breakpad.

      --generator=breakpad

      Korzysta z generatora plików symboli Breakpad.

      Pamiętaj, że domyślnym ustawieniem do generowania pliku symboli jest Breakpad. Używaj tej flagi tylko wtedy, gdy do konfiguracji kompilacji dodano flagę symbolGenerator { csym() } i chcesz ją zastąpić, aby zamiast niej używać Breakpada.

      --dry-run

      generuje pliki symboli, ale ich nie przesyła;

      Ten znacznik jest przydatny, jeśli chcesz sprawdzić zawartość wysyłanych plików.

      --debug Zawiera dodatkowe informacje na potrzeby debugowania