Firebase Crashlytics'i kullanmaya başlayın


Bu hızlı başlangıç kılavuzunda, Firebase Crashlytics ayarlarını uygulamanızda nasıl yapacağınız açıklanmaktadır. Kapsamlı kilitlenmeleri elde edebilmek için Firebase Crashlytics SDK'sı ile Firebase konsolunda bulabilirsiniz.

Crashlytics kurulumu için hem Firebase konsolunda hem de (ör. Firebase yapılandırma dosyası ve Crashlytics SDK) kaldırın. Kurulumu tamamlamak için bir test kilitlenmesini, ilk Firebase'e kilitlenme raporu gönderir.

Başlamadan önce

  1. Henüz yapmadıysanız Apple'ınıza Firebase'i ekleyin belirler. Apple uygulamanız yoksa bir örnek uygulama.

  2. Önerilen: Otomatik içerik haritası günlükleri Kilitlenme, önemli olmayan veya ANR etkinliğiyle sonuçlanan kullanıcı işlemlerini anlamak için Firebase projenizde Google Analytics modunu etkinleştirmeniz gerekir.

    • Mevcut Firebase projenizde Google Analytics yoksa Google Analytics öğesini şuradan etkinleştirebilirsiniz: hesabınızın Entegrasyonlar > Proje ayarları Firebase konsolunda kontrol edebilirsiniz.

    • Yeni bir Firebase projesi oluşturuyorsanız Google Analytics özelliğini etkinleştirin müzakere tekniği de eklediniz.

    . İçerik haritası günlüklerinin, WatchOS hariç Crashlytics.

1. Adım: Crashlytics SDK'sını uygulamanıza ekleyin

Firebase bağımlılıklarını yükleyip yönetmek için Swift Package Manager'ı kullanın.

  1. Xcode'da, uygulama projeniz açıkken Dosya > Paket Ekle'yi tıklayın.
  2. İstendiğinde Firebase Apple platformlar SDK deposunu ekleyin:
    3.   https://github.com/firebase/firebase-ios-sdk.git
    .
  3. Crashlytics kitaplığını seçin.
  4. , içerik haritası günlükleri Ayrıca uygulamanıza Google Analytics için Firebase SDK'sını da ekleyin. Şunlardan emin olun: Google Analytics etkin Firebase projenizde.
  5. -ObjC işaretini, hedefinizin derleme ayarlarındaki Diğer Bağlayıcı İşaretleri bölümüne ekleyin.
  6. (yalnızca macOS) Info.plist cihazınıza anahtarı ekleyin NSApplicationCrashOnExceptions ve şuna ayarla: YES.
  7. İşlemi tamamladığınızda, Xcode otomatik olarak arka planda tutmalarını sağlar.

Ardından Firebase modülünü yapılandırın:

  1. Firebase modülünü App yapınıza veya UIApplicationDelegate dosyanıza aktarın:

    Swift 

    import Firebase

    Objective-C 

    @import Firebase;

  2. FirebaseApp paylaşılan örneğini yapılandırın. Bu işlem genellikle uygulama temsilcinizin application(_:didFinishLaunchingWithOptions:) yöntemi:

    Swift 

    // Use the Firebase library to configure APIs.
FirebaseApp.configure()

    Objective-C 

    // Use the Firebase library to configure APIs.
[FIRApp configure];

2. Adım: Xcode'u dSYM dosyalarını otomatik olarak yükleyecek şekilde ayarlayın.

Crashlytics uygulamasının, okunabilir kilitlenme raporları oluşturabilmek için projenizin hata ayıklama sembolü (dSYM) dosyaları. Aşağıdaki adımlarda Xcode'un nasıl yapılandırılacağı açıklanmaktadır otomatik olarak üretmek, işlemek ve her defasında dosyaları yüklemek yardımcı olursunuz.

  1. Projenizin Xcode çalışma alanını açın, ardından sol gezinme paneli.

  2. HEDEFLER listesinden ana derleme hedefinizi seçin.

  3. Build Settings (Derleme Ayarları) sekmesini tıklayın, ardından aşağıdaki adımları uygulayarak Xcode, derlemeleriniz için dSYM'ler üretir.

    1. Tümü'nü tıklayın ve debug information format araması yapın.

    2. Tüm öğeleriniz için Hata Ayıklama Bilgi Biçimi'ni DWARF with dSYM File olarak ayarlayın derleme türleri.

  4. Derleme Aşamaları sekmesini tıklayın ve ardından aşağıdaki adımları uygulayarak Xcode, dSYM'lerinizi işleyip dosyaları yükleyebilir.

    1. > seçeneğini tıklayın. Yeni Komut Dosyası Çalıştırma Aşaması.

      Bu yeni Komut Dosyası Çalıştırma aşamasının, projenizin son derlemesi olduğundan emin olun. aşama; Aksi takdirde, Crashlytics dSYM'leri düzgün şekilde işleyemez.

    2. Yeni Run Komut Dosyasını Çalıştır bölümünü genişletin.

    3. Kabuk etiketinin altında bulunan komut dosyası alanına, komut dosyasını çalıştırın.

      Bu komut dosyası projenizin dSYM dosyalarını işler ve dosyaları Crashlytics

      "${BUILD_DIR%/Build/*}/SourcePackages/checkouts/firebase-ios-sdk/Crashlytics/run"

    4. Giriş Dosyaları bölümünde, şu dosyalarda kullanılabilir:

      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}
      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Resources/DWARF/${PRODUCT_NAME}
      ${DWARF_DSYM_FOLDER_PATH}/${DWARF_DSYM_FILE_NAME}/Contents/Info.plist
      $(TARGET_BUILD_DIR)/$(UNLOCALIZED_RESOURCES_FOLDER_PATH)/GoogleService-Info.plist
      $(TARGET_BUILD_DIR)/$(EXECUTABLE_PATH)

dSYM dosyaları ve Crashlytics ( dSYM dosyalarının manuel olarak nasıl yükleneceğini ziyaret edin. Reklamı gösterilen kilitlenme raporları alma

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

Crashlytics kurulumunu tamamlamak ve ilk verileri Firebase konsolunun Crashlytics kontrol paneli, testi zorunlu kılmanız gerekiyor olabilir.

  1. Uygulamanıza, test kilitlenmesini zorlamak için kullanabileceğiniz bir kod ekleyin.

    Uygulamanıza basıldığında kilitlenmeye neden olur. Düğme, "Kilitlenmeyi Test Et" etiketini taşır.

    SwiftUI 

    Button("Crash") {
  fatalError("Crash was triggered")
}

    kullanıcı arayüzüKit

    Swift 

    import UIKit

class ViewController: UIViewController {
  override func viewDidLoad() {
      super.viewDidLoad()

      // Do any additional setup after loading the view, typically from a nib.

      let button = UIButton(type: .roundedRect)
      button.frame = CGRect(x: 20, y: 50, width: 100, height: 30)
      button.setTitle("Test Crash", for: [])
      button.addTarget(self, action: #selector(self.crashButtonTapped(_:)), for: .touchUpInside)
      view.addSubview(button)
  }

  @IBAction func crashButtonTapped(_ sender: AnyObject) {
      let numbers = [0]
      let _ = numbers[1]
  }
}

    Objective-C 

    #import "ViewController.h"

@implementation ViewController
‐ (void)viewDidLoad {
    [super viewDidLoad];

    // Do any additional setup after loading the view, typically from a nib.

    UIButton* button = [UIButton buttonWithType:UIButtonTypeRoundedRect];
    button.frame = CGRectMake(20, 50, 100, 30);
    [button setTitle:@"Test Crash" forState:UIControlStateNormal];
    [button addTarget:self action:@selector(crashButtonTapped:)
        forControlEvents:UIControlEventTouchUpInside];
    [self.view addSubview:button];
}

‐ (IBAction)crashButtonTapped:(id)sender {
    @[][1];
}

@end

  2. Uygulamanızı Xcode hata ayıklayıcı bağlantısı olmadan Xcode'da derleyip çalıştırın.

    1. Derle'yi tıklayın ve ardından Uygulamanızı bir test cihazında derlemek için mevcut şemayı çalıştırın veya simülatörüdür.

    2. Uygulamanız çalışana kadar bekleyin, ardından Şemayı çalıştırmayı durdurun veya işlemini kullanarak uygulamanızın ilk örneğini kapatın. Bu baş harf örneği, Crashlytics ile etkileşime giren hata ayıklayıcıyı içeriyordu.

  3. Uygulamanızın ilk kilitlenme raporunu göndermek için test kilitlenmesini zorunlu kılın:

    1. Uygulamanızı test cihazınızın veya simülatörünüzün ana ekranından açın.

    2. Uygulamanızda "Kilitlenmeyi Test Et"e basın kodu kullanarak eklediğiniz düğme bölümünü ziyaret edin.

    3. Kilitlendikten sonra, uygulamanızın kilitlenmesini sağlamak için Xcode'dan tekrar çalıştırın kilitlenme raporunu Firebase'e gönderir.

  4. Şu sayfanın Crashlytics kontrol paneline gidin: Firebase konsolunda test kilitlenmenizi görebilirsiniz.

    Konsolu yenilediyseniz ve test kilitlenmesini hâlâ görmüyorsanız beş dakika sonra hata ayıklama günlük kaydını etkinleştirme uygulamanızın kilitlenme raporu gönderip göndermediğini kontrol edin.


Hepsi bu kadar! Crashlytics artık uygulamanızı kilitlenmelere karşı izliyor. Görüntülemek ve incelemek için Crashlytics kontrol panelini ziyaret edin tüm raporlarınızdan ve istatistiklerinizden yararlanır.

Sonraki adımlar