Crashlytics kontrol panelinde okunabilir kilitlenme raporları alma (Unity)

Platform seçin:

iOS+ Android Flutter Unity

iOS+ (Apple platformları)

Crashlytics Unity SDK 8.2.0 ve sonraki sürümlerini kullanan Apple platformu uygulamaları için Firebase Unity Editor eklentisi, Xcode projenizi sembolleri yükleyecek şekilde otomatik olarak yapılandırır. En yeni sürümü indirin.

Android

Android uygulamaları için Crashlytics Unity SDK 8.6.1 ve sonraki sürümler, NDK kilitlenme raporlamasını otomatik olarak içerir. Bu sayede Crashlytics, Android'deki Unity IL2CPP kilitlenmelerini otomatik olarak raporlayabilir. Ancak Crashlytics kontrol panelinde yerel kitaplık kilitlenmeleri için sembolize edilmiş yığın izlemeleri görmek istiyorsanız derleme sırasında Firebase CLI'yı kullanarak sembol bilgilerini yüklemeniz gerekir.

1. Crashlytics Unity SDK'sının 8.6.1 veya sonraki bir sürümünü kullandığınızdan emin olun. En yeni sürümü indirin.

2. Ortamınızı ve projenizi sembol yükleme için ayarlama:

   1. Firebase KSA'yı yükleme talimatlarını uygulayın.

      CLI'yı zaten yüklediyseniz en son sürümüne güncellediğinizden emin olun.

   2. (Yalnızca Android API düzeyi 30 ve sonraki sürümleri kullanan uygulamalar için) İşaretçi Etiketleme'yi devre dışı bırakmak için uygulamanızın AndroidManifest.xml şablonunu güncelleyin:

      1. Android Player Settings > Publishing Settings > Build > Custom Main Manifest (Android Oynatıcı Ayarları > Yayınlama Ayarları > Derleme > Özel Ana Manifest) kutusunu işaretleyin.

      2. Assets/Plugins/Android/AndroidManifest.xml adresindeki manifest şablonunu açın.

      3. (Yalnızca 8.8.0'dan önceki bir SDK sürümünü kullanan uygulamalar için) Uygulama etiketine aşağıdaki özelliği ekleyin: <application android:allowNativeHeapPointerTagging="false" ... />

3. Projenizi derleyin ve sembolleri yükleyin.

   Crashlytics kontrol panelinde sembolik yığın izlemelerini görmek istediğiniz her yayınlanan derleme veya herhangi bir derleme oluşturduğunuzda bu adımları tamamlayın.

   1. Build Settings (Derleme Ayarları) iletişim kutusunda aşağıdakilerden birini yapın:

      • Projenizi derlemek için bir Android Studio projesine aktarın veya

      • APK'nızı doğrudan Unity Editor'dan oluşturun.
        Derleme işleminden önce Derleme Ayarları iletişim kutusunda symbols.zip oluştur onay kutusunun işaretli olduğundan emin olun.

   2. Derlemeniz tamamlandıktan sonra Crashlytics ile uyumlu bir sembol dosyası oluşturun ve aşağıdaki Firebase CLI komutunu çalıştırarak dosyayı Firebase sunucularına yükleyin:

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

      • FIREBASE_APP_ID: Firebase Android uygulama kimliğiniz (paket adınız değil)
        Örnek Firebase Android uygulama kimliği: 1:567383003300:android:17104a2ced0c9b9b

        Firebase Uygulama Kimliğinizi bulmanız mı gerekiyor?

        Firebase Uygulama Kimliğinizi bulmanın iki yolu vardır:

        • google-services.json dosyanızda, uygulama kimliğiniz mobilesdk_app_id değeridir veya

        • Firebase konsolunda settings Ayarlar > Genel sayfasına gidin. Uygulamalarınız kartına gidin ve uygulama kimliğini bulmak için istediğiniz Firebase uygulamasını tıklayın.

      • PATH/TO/SYMBOLS: KSA tarafından oluşturulan sembol dosyasının yolu

        • Android Studio projesine aktarıldı: PATH/TO/SYMBOLS, uygulamayı Gradle veya Android Studio aracılığıyla derledikten sonra dışa aktarılan proje kökünde oluşturulan unityLibrary/symbols dizinidir.

        • APK'yı doğrudan Unity'den derlediyseniz: PATH/TO/SYMBOLS, derleme işleminiz tamamlandığında projenin kök dizininde oluşturulan sıkıştırılmış sembol dosyasının yoludur (örneğin: myproject/myapp-1.0-v100.symbols.zip).

      Sembol dosyası üretme ve yükleme için Firebase CLI komutunu kullanmayla ilgili gelişmiş seçenekleri görüntüleyin.

      İşaretle	Açıklama
      --generator=csym	Varsayılan Breakpad oluşturma aracı yerine eski cSYM sembol dosyası üretme aracını kullanır. Kullanılması önerilmez. Varsayılan Breakpad sembol dosyası oluşturucuyu kullanmanızı öneririz.
      --generator=breakpad	Breakpad sembol dosyası oluşturucuyu kullanır. Sembol dosyası üretme için varsayılan ayarın Breakpad olduğunu unutmayın. Bu işareti yalnızca derleme yapılandırmanıza symbolGenerator { csym() } eklediyseniz ve bunun yerine Breakpad'i kullanmak için geçersiz kılmak istiyorsanız kullanın.
      --dry-run	Sembol dosyalarını oluşturur ancak yüklemez. Gönderilen dosyaların içeriğini incelemek istiyorsanız bu işaret yararlı olur.
      --debug	Ek hata ayıklama bilgileri sağlar.