Firebase Crashlytics'i kullanmaya başlayın

Bu hızlı başlangıç kılavuzunda, Firebase Crashlytics'i nasıl kuracağınız açıklanmaktadır. Firebase Crashlytics SDK ile birlikte çalışarak kapsamlı kilitlenmeler Firebase konsolunda yer alır.

Crashlytics'i kurmak 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'i etkinleştirmeniz gerekir.

    • Mevcut Firebase projenizde Google Analytics yoksa Google Analytics'i şuradan etkinleştirebilirsiniz: Entegrasyonlar sekmesini > Proje ayarları Firebase konsolunda yer alır.

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

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

1. Adım: Crashlytics SDK'yı 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 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, okunabilir kilitlenme raporları oluşturmak 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 hakkında daha ayrıntılı bilgi için dSYM dosyalarının manuel olarak nasıl yükleneceğini ziyaret edin. Gizlenmiş kilitlenme raporları alma

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

Crashlytics'in kurulumunu tamamlamak ve ilk verileri şurada görmek için: 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.

    Hızlı Kullanıcı Arayüzü 

    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 Crashlytics'i engelleyen hata ayıklayıcı da dahil edildi.

  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. n Crashlytics kontrol paneline Firebase konsolunu kullanarak 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 şu anda uygulamanızda kilitlenme olup olmadığını izliyor. Durumu incelemek ve incelemek için Crashlytics kontrol panelini ziyaret edin tüm raporlarınızdan ve istatistiklerinizden yararlanır.

Sonraki adımlar