Firebase Crashlytics'i kullanmaya başlayın

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

Crashlytics'in kurulumu hem komut satırı aracının hem de IDE'nizin kullanılmasını içerir. Kurulumu tamamlamak için, ilk kilitlenme raporunuzu Firebase'e göndermek amacıyla bir test istisnasının atılmasını zorlamanız gerekir.

Sen başlamadan önce

  1. Henüz yapmadıysanız Flutter projenizde Firebase'i yapılandırın ve başlatın .

  2. Önerilen : Kilitlenme, ölümcül olmayan veya ANR olayına yol açan kullanıcı işlemlerini anlamak amacıyla içerik haritası günlüklerini otomatik olarak almak için Firebase projenizde Google Analytics'i etkinleştirmeniz gerekir.

    • Mevcut Firebase projenizde Google Analytics etkin değilse Google Analytics'i projenizin Entegrasyonlar sekmesinden etkinleştirebilirsiniz. Firebase konsolunda > Proje ayarları .

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

    İçerik haritası günlüklerinin Crashlytics tarafından desteklenen tüm Android ve Apple platformlarında (watchOS hariç) mevcut olduğunu unutmayın.

Adım 1 : Flutter projenize Crashlytics'i ekleyin

  1. Crashlytics için Flutter eklentisini yüklemek üzere Flutter projenizin kökünden aşağıdaki komutu çalıştırın.

    Breadcrumb günlüklerinden yararlanmak için Google Analytics için Flutter eklentisini de uygulamanıza ekleyin. Firebase projenizde Google Analytics'in etkinleştirildiğinden emin olun.

    flutter pub add firebase_crashlytics && flutter pub add firebase_analytics
    
  2. Flutter projenizin kök dizininden aşağıdaki komutu çalıştırın:

    flutterfire configure
    

    Bu komutu çalıştırmak, Flutter uygulamanızın Firebase yapılandırmasının güncel olmasını sağlar ve Android için gerekli Crashlytics Gradle eklentisini uygulamanıza ekler.

  3. Tamamlandığında Flutter projenizi yeniden oluşturun:

    flutter run
    
  4. (İsteğe bağlı) Flutter projeniz --split-debug-info bayrağını (ve isteğe bağlı olarak --obfuscate bayrağını) kullanıyorsa, uygulamalarınız için okunabilir yığın izlerini göstermek için ek adımlar gerekir.

    • Apple platformları: Projenizin otomatik olarak Flutter sembolleri (dSYM dosyaları) oluşturup Crashlytics'e yükleyebilmesi için projenizin önerilen sürüm yapılandırmasını (Flutter 3.12.0+ ve Crashlytics Flutter eklentisi 3.3.4+) kullandığından emin olun.

    • Android: Flutter hata ayıklama sembollerini yüklemek için Firebase CLI'yi (v.11.9.0+) kullanın. Gizlenmiş bir kod yapısından kaynaklanan bir kilitlenmeyi bildirmeden önce hata ayıklama simgelerini yüklemeniz gerekir.

      Flutter projenizin kök dizininden aşağıdaki komutu çalıştırın:

      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

      • PATH/TO /symbols : Uygulamayı oluştururken --split-debug-info bayrağına ilettiğiniz dizinle aynı

2. Adım : Kilitlenme işleyicilerini yapılandırın

FlutterError.onError dosyasını FirebaseCrashlytics.instance.recordFlutterFatalError ile geçersiz kılarak Flutter çerçevesinde oluşturulan tüm hataları otomatik olarak yakalayabilirsiniz:

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await Firebase.initializeApp();

  // Pass all uncaught "fatal" errors from the framework to Crashlytics
  FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterFatalError;

  runApp(MyApp());
}

Flutter çerçevesi tarafından işlenmeyen eşzamansız hataları yakalamak için PlatformDispatcher.instance.onError kullanın:

Future<void> main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp();
    FlutterError.onError = (errorDetails) {
      FirebaseCrashlytics.instance.recordFlutterFatalError(errorDetails);
    };
    // Pass all uncaught asynchronous errors that aren't handled by the Flutter framework to Crashlytics
    PlatformDispatcher.instance.onError = (error, stack) {
      FirebaseCrashlytics.instance.recordError(error, stack, fatal: true);
      return true;
    };
    runApp(MyApp());

}

Diğer hata türlerinin nasıl ele alınacağına ilişkin örnekler için bkz. Kilitlenme raporlarını özelleştirme .

3. Adım : Kurulumu tamamlamak için test kilitlenmesini zorunlu kılın

Crashlytics kurulumunu tamamlamak ve Firebase konsolunun Crashlytics kontrol panelinde ilk verileri görmek için bir test istisnasının atılmasını zorlamanız gerekir.

  1. Uygulamanıza, bir test istisnasının atılmasını zorlamak için kullanabileceğiniz kodu ekleyin.

    FirebaseCrashlytics.instance.recordError(error, stack, fatal: true) üst düzey Zone çağıran bir hata işleyicisi eklediyseniz, uygulamanıza basıldığında bir düğme eklemek için aşağıdaki kodu kullanabilirsiniz: bir test istisnası:

    TextButton(
        onPressed: () => throw Exception(),
        child: const Text("Throw Test Exception"),
    ),
    
  2. Uygulamanızı oluşturun ve çalıştırın.

  3. Uygulamanızın ilk raporunu göndermek için test istisnasının atılmasını sağlayın:

    1. Uygulamanızı test cihazınızdan veya emülatörünüzden açın.

    2. Uygulamanızda yukarıdaki kodu kullanarak eklediğiniz test istisnası düğmesine basın.

  4. Test kilitlenmenizi görmek için Firebase konsolunun Crashlytics kontrol paneline gidin.

    Konsolu yenilediyseniz ve beş dakika sonra hâlâ test kilitlenmesini göremiyorsanız uygulamanızın kilitlenme raporları gönderip göndermediğini görmek için hata ayıklama günlüğünü etkinleştirin .


Ve bu kadar! Crashlytics artık uygulamanızı çökmelere ve Android'de önemli olmayan hatalara ve ANR'lere karşı izliyor. Tüm raporlarınızı ve istatistiklerinizi görüntülemek ve araştırmak için Crashlytics kontrol panelini ziyaret edin.

Sonraki adımlar

,

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

Crashlytics'in kurulumu hem komut satırı aracının hem de IDE'nizin kullanılmasını içerir. Kurulumu tamamlamak için, ilk kilitlenme raporunuzu Firebase'e göndermek amacıyla bir test istisnasının atılmasını zorlamanız gerekir.

Sen başlamadan önce

  1. Henüz yapmadıysanız Flutter projenizde Firebase'i yapılandırın ve başlatın .

  2. Önerilen : Kilitlenme, ölümcül olmayan veya ANR olayına yol açan kullanıcı işlemlerini anlamak amacıyla içerik haritası günlüklerini otomatik olarak almak için Firebase projenizde Google Analytics'i etkinleştirmeniz gerekir.

    • Mevcut Firebase projenizde Google Analytics etkin değilse Google Analytics'i projenizin Entegrasyonlar sekmesinden etkinleştirebilirsiniz. Firebase konsolunda > Proje ayarları .

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

    İçerik haritası günlüklerinin Crashlytics tarafından desteklenen tüm Android ve Apple platformlarında (watchOS hariç) mevcut olduğunu unutmayın.

Adım 1 : Flutter projenize Crashlytics'i ekleyin

  1. Crashlytics için Flutter eklentisini yüklemek üzere Flutter projenizin kökünden aşağıdaki komutu çalıştırın.

    Breadcrumb günlüklerinden yararlanmak için Google Analytics için Flutter eklentisini de uygulamanıza ekleyin. Firebase projenizde Google Analytics'in etkinleştirildiğinden emin olun.

    flutter pub add firebase_crashlytics && flutter pub add firebase_analytics
    
  2. Flutter projenizin kök dizininden aşağıdaki komutu çalıştırın:

    flutterfire configure
    

    Bu komutu çalıştırmak, Flutter uygulamanızın Firebase yapılandırmasının güncel olmasını sağlar ve Android için gerekli Crashlytics Gradle eklentisini uygulamanıza ekler.

  3. Tamamlandığında Flutter projenizi yeniden oluşturun:

    flutter run
    
  4. (İsteğe bağlı) Flutter projeniz --split-debug-info bayrağını (ve isteğe bağlı olarak --obfuscate bayrağını) kullanıyorsa, uygulamalarınız için okunabilir yığın izlerini göstermek için ek adımlar gerekir.

    • Apple platformları: Projenizin otomatik olarak Flutter sembolleri (dSYM dosyaları) oluşturup Crashlytics'e yükleyebilmesi için projenizin önerilen sürüm yapılandırmasını (Flutter 3.12.0+ ve Crashlytics Flutter eklentisi 3.3.4+) kullandığından emin olun.

    • Android: Flutter hata ayıklama sembollerini yüklemek için Firebase CLI'yi (v.11.9.0+) kullanın. Gizlenmiş bir kod yapısından kaynaklanan bir kilitlenmeyi bildirmeden önce hata ayıklama simgelerini yüklemeniz gerekir.

      Flutter projenizin kök dizininden aşağıdaki komutu çalıştırın:

      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

      • PATH/TO /symbols : Uygulamayı oluştururken --split-debug-info bayrağına ilettiğiniz dizinle aynı

2. Adım : Kilitlenme işleyicilerini yapılandırın

FlutterError.onError dosyasını FirebaseCrashlytics.instance.recordFlutterFatalError ile geçersiz kılarak Flutter çerçevesinde oluşturulan tüm hataları otomatik olarak yakalayabilirsiniz:

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await Firebase.initializeApp();

  // Pass all uncaught "fatal" errors from the framework to Crashlytics
  FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterFatalError;

  runApp(MyApp());
}

Flutter çerçevesi tarafından işlenmeyen eşzamansız hataları yakalamak için PlatformDispatcher.instance.onError kullanın:

Future<void> main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp();
    FlutterError.onError = (errorDetails) {
      FirebaseCrashlytics.instance.recordFlutterFatalError(errorDetails);
    };
    // Pass all uncaught asynchronous errors that aren't handled by the Flutter framework to Crashlytics
    PlatformDispatcher.instance.onError = (error, stack) {
      FirebaseCrashlytics.instance.recordError(error, stack, fatal: true);
      return true;
    };
    runApp(MyApp());

}

Diğer hata türlerinin nasıl ele alınacağına ilişkin örnekler için bkz. Kilitlenme raporlarını özelleştirme .

3. Adım : Kurulumu tamamlamak için test kilitlenmesini zorunlu kılın

Crashlytics kurulumunu tamamlamak ve Firebase konsolunun Crashlytics kontrol panelinde ilk verileri görmek için bir test istisnasının atılmasını zorlamanız gerekir.

  1. Uygulamanıza, bir test istisnasının atılmasını zorlamak için kullanabileceğiniz kodu ekleyin.

    FirebaseCrashlytics.instance.recordError(error, stack, fatal: true) üst düzey Zone çağıran bir hata işleyicisi eklediyseniz, uygulamanıza basıldığında bir düğme eklemek için aşağıdaki kodu kullanabilirsiniz: bir test istisnası:

    TextButton(
        onPressed: () => throw Exception(),
        child: const Text("Throw Test Exception"),
    ),
    
  2. Uygulamanızı oluşturun ve çalıştırın.

  3. Uygulamanızın ilk raporunu göndermek için test istisnasının atılmasını sağlayın:

    1. Uygulamanızı test cihazınızdan veya emülatörünüzden açın.

    2. Uygulamanızda yukarıdaki kodu kullanarak eklediğiniz test istisnası düğmesine basın.

  4. Test kilitlenmenizi görmek için Firebase konsolunun Crashlytics kontrol paneline gidin.

    Konsolu yenilediyseniz ve beş dakika sonra hâlâ test kilitlenmesini göremiyorsanız uygulamanızın kilitlenme raporları gönderip göndermediğini görmek için hata ayıklama günlüğünü etkinleştirin .


Ve bu kadar! Crashlytics artık uygulamanızı çökmelere ve Android'de önemli olmayan hatalara ve ANR'lere karşı izliyor. Tüm raporlarınızı ve istatistiklerinizi görüntülemek ve araştırmak için Crashlytics kontrol panelini ziyaret edin.

Sonraki adımlar