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
Henüz yapmadıysanız Apple'ınıza Firebase'i ekleyin belirler. Apple uygulamanız yoksa bir örnek uygulama.
Ö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
Firebase konsolunda yer alır. > Proje ayarları 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.
- Xcode'da, uygulama projeniz açıkken Dosya > Paket Ekle'yi tıklayın.
- İstendiğinde Firebase Apple platformlar SDK deposunu ekleyin:
- Crashlytics kitaplığını seçin.
- , 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.
-ObjC
işaretini, hedefinizin derleme ayarlarındaki Diğer Bağlayıcı İşaretleri bölümüne ekleyin.- (yalnızca macOS)
Info.plist
cihazınıza anahtarı ekleyinNSApplicationCrashOnExceptions
ve şuna ayarla:YES
. - İşlemi tamamladığınızda, Xcode otomatik olarak arka planda tutmalarını sağlar.
https://github.com/firebase/firebase-ios-sdk.git.
Ardından Firebase modülünü yapılandırın:
Firebase modülünü
App
yapınıza veyaUIApplicationDelegate
dosyanıza aktarın:Swift
import Firebase
Objective-C
@import Firebase;
FirebaseApp
paylaşılan örneğini yapılandırın. Bu işlem genellikle uygulama temsilcinizinapplication(_: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.
Projenizin Xcode çalışma alanını açın, ardından sol gezinme paneli.
HEDEFLER listesinden ana derleme hedefinizi seçin.
Build Settings (Derleme Ayarları) sekmesini tıklayın, ardından aşağıdaki adımları uygulayarak Xcode, derlemeleriniz için dSYM'ler üretir.
Tümü'nü tıklayın ve
debug information format
araması yapın.Tüm öğeleriniz için Hata Ayıklama Bilgi Biçimi'ni
DWARF with dSYM File
olarak ayarlayın derleme türleri.
Derleme Aşamaları sekmesini tıklayın ve ardından aşağıdaki adımları uygulayarak Xcode, dSYM'lerinizi işleyip dosyaları yükleyebilir.
> 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.
Yeni Run Komut Dosyasını Çalıştır bölümünü genişletin.
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"
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.
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
Uygulamanızı Xcode hata ayıklayıcı bağlantısı olmadan Xcode'da derleyip çalıştırın.
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.
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.
Uygulamanızın ilk kilitlenme raporunu göndermek için test kilitlenmesini zorunlu kılın:
Uygulamanızı test cihazınızın veya simülatörünüzün ana ekranından açın.
Uygulamanızda "Kilitlenmeyi Test Et"e basın kodu kullanarak eklediğiniz düğme bölümünü ziyaret edin.
Kilitlendikten sonra, uygulamanızın kilitlenmesini sağlamak için Xcode'dan tekrar çalıştırın kilitlenme raporunu Firebase'e gönderir.
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
- Kilitlenme raporu ayarlarınızı özelleştirme katılımlı raporlar, günlükler, anahtarlar ve önemli olmayan hataların izlenmesini ekleyerek.