Firebase Crashlytics'i kullanmaya başlayın

Bu hızlı başlangıç, Firebase konsolunda kapsamlı kilitlenme raporları alabilmeniz için Firebase Crashlytics SDK ile uygulamanızda Firebase Crashlytics'i nasıl kuracağınızı açıklar.

Crashlytics'i kurmak, hem Firebase konsolunda hem de IDE'nizde görevler gerektirir (bir Firebase yapılandırma dosyası ve Crashlytics SDK eklemek gibi). Kurulumu tamamlamak için, ilk kilitlenme raporunuzu Firebase'e göndermek üzere bir test kilitlenmesini zorlamanız gerekir.

Sen başlamadan önce

  1. Eğer henüz yapmadıysanız, Firebase eklemek için Birlik projesi. Eğer bir Birlik projesini yoksa, bir indirebilirsiniz örnek uygulamasını .

  2. Önerilen: çarpışma ücretsiz kullanıcılar, sayfa işareti günlükleri ve hız uyarıları gibi özellikleri almak için, Firebase projesi Google Analytics etkinleştirmeniz gerekiyor.

    • Mevcut Firebase projesi, Google Analytics'in etkin yoksa, sen Google Analytics'in etkinleştirebilirsiniz Entegrasyonları sekmesinin çıkartmalarınızın Firebase konsolunda> Proje ayarlarında.

    • Yeni bir Firebase projesi oluşturuyorsanız proje oluşturma iş akışı sırasında Google Analytics'i etkinleştirin.

1. Adım: Firebase konsolunda Crashlytics etkinleştirme

  1. Git Crashlytics pano Firebase konsolunda.

  2. Emin olun Uygulama sayfasının üst kısmında Crashlytics yanındaki açılır menüden seçilir.

  3. Tıklayın Crashlytics etkinleştirin.

2. Adım: uygulamanıza Firebase Crashlytics SDK'yı ekle

  1. İndir Firebase Birlik SDK , ardından SDK yere uygun halletmek.

    Firebase Unity SDK, platforma özel değildir.

  2. Aktif gezinme açık Birlik projesi,> İçe Paketi> Özel Paket içinde.

  3. Fermuarını açıp SDK itibaren Crashlytics SDK'yı (ithal etmek seçmek FirebaseCrashlytics.unitypackage ).

    Başka alabilirsiniz desteklenen Firebase ürünü , hem de.

  4. İthalat Birlik Paketi penceresinde, Al'ı tıklatın.

Aşama 3: başlatma Crashlytics

  1. Yeni bir C # komut dosyası oluşturun, sonra da eklemek GameObject sahnede.

    1. İlk sahne açın, ardından boş oluşturmak GameObject adında CrashlyticsInitializer .

    2. Yeni nesne için Inspector'da Bileşen Ekle tıklayın.

    3. Senin seçin CrashlyticsInit eklemek için komut CrashlyticsInitializer nesne.

  2. Komut dosyasının içinde başlatma Crashlytics Start yöntemiyle:

    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()
        // ...
    }

4. Adım: Run proje

  1. Projenizi iOS veya Android'e aktarın.

  2. Dışa aktarma tamamlandıktan sonra, dışa aktarılan projenizi aşağıdaki örnek dışa aktarma yapılandırmalarıyla karşılaştırarak projenin doğru şekilde dışa aktarıldığını doğrulayın.

    Projenizi karşılaştırdıktan sonra dosyalar eksik gibi görünüyorsa, Unity Düzenleyicinizi açın, ardından Google Play Services Çözümleyiciyi çalıştırın (aşağıdaki talimatları bulun).

    iOS

    Android

Dosyalar ihracat sonra eksikse çözümleyicinizi Run (gerektiğinde)

Google Play Hizmetleri Çözümleyicileri, Unity projenizin uygulamanızı iOS veya Android'e aktarmak için uygun bağımlılıklara sahip olduğundan emin olur. Resolverli hakkında daha fazla bilgi için için README ziyaret Birlik Kavanoz Reselver .

Adım 5: Kuvvet kurulumunu tamamlamak için bir test kazasında

Crashlytics kurulumunu tamamlamak ve Firebase konsolunun Crashlytics panosunda ilk verileri görmek için bir test çökmesini zorlamanız gerekir.

  1. Hiyerarşi penceresinden, yeni bir nesne oluşturun:

    1. Sağ tıklayıp yeni boş eklemek için boş oluştur seçeneğini GameObject oyununuzda bir sahneye.

    2. Yeni nesne Ad CrashlyticsTester .

    3. Emin olun CrashlyticsTester nesne devam etmeden önce seçilir.

  2. Müfettiş sekmesinde, uygulamanızı çalıştırmak sonra bir test birkaç saniye çökmesine neden yeni komut dosyasını ekleyin:

    1. Tıklayın Bileşen ekleyin.

    2. Bileşenler listesinin alt kısmındaki Yeni Denetimi seçin.

    3. Yeni komut dosyası ad CrashlyticsTester iyi, o komut dosyasına aşağıdaki içerik eklemek gibidir:

      using System;
      using UnityEngine;
      
      public class CrashlyticsTester : MonoBehaviour {
      
          int updatesBeforeException;
      
          // Use this for initialization
          void Start () {
            updatesBeforeException = 0;
          }
      
          // Update is called once per frame
          void Update()
          {
              // Call the exception-throwing method here so that it's run
              // every frame update
              throwExceptionEvery60Updates();
          }
      
          // A method that tests your Crashlytics implementation by throwing an
          // exception every 60 frame updates. You should see non-fatal errors in the
          // Firebase console a few minutes after running your app with this method.
          void throwExceptionEvery60Updates()
          {
              if (updatesBeforeException > 0)
              {
                  updatesBeforeException--;
              }
              else
              {
                  // Set the counter to 60 updates
                  updatesBeforeException = 60;
      
                  // Throw an exception to test your Crashlytics implementation
                  throw new System.Exception("test exception please ignore");
              }
          }
      }
      
  3. Uygulamanızı oluşturun ve çalıştırın:

    1. Dosya> Yapı Ayarı gidin, sonra platformlarının listeden Android ya da iOS birisini seçerler.

    2. Oluştur tıklayın ve iOS veya Android için uygulamanızı çalıştırın.

  4. Uygulamanızın çalışmaya başladıktan sonra, cihaz günlüğünü izlemek ve gelen tetiğe istisna için bekleyin CrashlyticsTester .

    • iOS: Görünüm Xcode alt bölmesinde kaydeder.

    • Android: Görünüm terminali aşağıdaki komutu çalıştırarak kaydeder adb logcat .

  5. Cihaz günlüğünüzde istisnayı gördüğünüzde, kilitlenme raporunu Firebase'e gönderebilmesi için uygulamanızı yeniden başlatın.

  6. Git Crashlytics pano test kilitlenmeyi görmek için Firebase konsolunun.

    Eğer konsol yenilenir ettik ve hala beş dakika sonra deney kazasında görmüyorsanız, hata ayıklama günlüğünü etkinleştirme uygulama kilitlenme raporları göndererek olup olmadığını görmek için.


Ve bu kadar! Crashlytics artık uygulamanızı çökmelere karşı izliyor ve Crashlytics panosunda kilitlenme raporlarını ve istatistikleri görüntüleyebilir ve inceleyebilirsiniz.

Sonraki adımlar