Sen başlamadan önce
Henüz yapmadıysanız Firebase'i Apple projenize ekleyin .
1. Adım : Uygulamanıza Performans İzlemeyi ekleyin
Performans İzleme SDK'sını ekledikten sonra Firebase, uygulamanızın ekran oluşturma işlemine ilişkin verileri, uygulamanızın yaşam döngüsüyle ilgili verileri ( uygulama başlangıç zamanı gibi) ve HTTP/S ağ isteklerine ilişkin verileri otomatik olarak toplamaya başlar.
Firebase bağımlılıklarını yüklemek ve yönetmek için Swift Paket Yöneticisini kullanın.
- Xcode'da uygulama projeniz açıkken Dosya > Paket Ekle'ye gidin.
- İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:
- Performans İzleme kitaplığını seçin.
-
-ObjC
bayrağını hedefinizin derleme ayarlarının Diğer Bağlayıcı Bayrakları bölümüne ekleyin. - Bitirdiğinizde Xcode, bağımlılıklarınızı arka planda otomatik olarak çözmeye ve indirmeye başlayacaktır.
https://github.com/firebase/firebase-ios-sdk.git
Ardından Firebase modülünü yapılandırın:
-
FirebaseCore
modülünüUIApplicationDelegate
ve uygulama temsilcinizin kullandığı diğer Firebase modüllerine aktarın. Örneğin, Cloud Firestore ve Authentication'ı kullanmak için:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Süratli
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Amaç-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Uygulama temsilcinizin
application(_:didFinishLaunchingWithOptions:)
yöntemindeFirebaseApp
paylaşılan örneğini yapılandırın:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Süratli
// Use Firebase library to configure APIs FirebaseApp.configure()
Amaç-C
// Use Firebase library to configure APIs [FIRApp configure];
- SwiftUI kullanıyorsanız, bir uygulama temsilcisi oluşturmalı ve bunu
UIApplicationDelegateAdaptor
veyaNSApplicationDelegateAdaptor
aracılığıylaApp
yapınıza eklemelisiniz. Ayrıca uygulama temsilcisinin swizzling özelliğini de devre dışı bırakmalısınız. Daha fazla bilgi için SwiftUI talimatlarına bakın.SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
Uygulamanızı yeniden derleyin.
Adım 2 : İlk veri görüntüleme için performans olaylarını oluşturun
Firebase, SDK'yı uygulamanıza başarıyla eklediğinizde etkinlikleri işlemeye başlar. Hala yerel olarak geliştirme yapıyorsanız, ilk veri toplama ve işlemeye yönelik etkinlikler oluşturmak için uygulamanızla etkileşim kurun.
Bir simülatör veya test cihazı kullanarak uygulamanızı geliştirmeye devam edin.
Uygulamanızı birkaç kez arka plan ve ön plan arasında değiştirerek, ekranlar arasında gezinerek uygulamanızla etkileşim kurarak ve/veya ağ isteklerini tetikleyerek etkinlikler oluşturun.
Firebase konsolunun Performans kontrol paneline gidin. Birkaç dakika içinde ilk verilerinizin görüntülendiğini görmelisiniz.
Başlangıç verilerinizin görüntüsünü görmüyorsanız sorun giderme ipuçlarını inceleyin.
3. Adım : (İsteğe bağlı) Performans etkinliklerine ilişkin günlük mesajlarını görüntüleyin
Hata ayıklama günlüğünü aşağıdaki şekilde etkinleştirin:
- Xcode'da (minimum v14.1), Ürün > Şema > Şemayı düzenle öğesini seçin.
- Soldaki menüden Çalıştır'ı seçin, ardından Bağımsız Değişkenler sekmesini seçin.
- Başlatma Sırasında Aktarılan Bağımsız Değişkenler bölümüne
-FIRDebugEnabled
ekleyin.
Herhangi bir hata mesajı için günlük mesajlarınızı kontrol edin.
Performans İzleme, günlük mesajlarını
Firebase/Performance
ile etiketler, böylece günlük mesajlarınızı filtreleyebilirsiniz.Performans İzleme'nin performans olaylarını günlüğe kaydettiğini gösteren aşağıdaki günlük türlerini kontrol edin:
-
Logging trace metric: TRACE_NAME , FIREBASE_PERFORMANCE_CONSOLE_URL
-
Logging network request trace: URL
-
Verilerinizi Firebase konsolunda görüntülemek için URL'yi tıklayın. Verilerin kontrol panelinde güncellenmesi birkaç dakika sürebilir.
Uygulamanız performans olaylarını günlüğe kaydetmiyorsa sorun giderme ipuçlarını inceleyin.
4. Adım : (İsteğe bağlı) Belirli kod için özel izleme ekleyin
Uygulamanızdaki belirli kodlarla ilişkili performans verilerini izlemek için özel kod izlemelerini kullanabilirsiniz.
Özel bir kod izlemeyle, uygulamanızın belirli bir görevi veya bir dizi görseli yükleme veya veritabanınızı sorgulama gibi görevleri tamamlamasının ne kadar sürdüğünü ölçebilirsiniz. Özel bir kod izlemenin varsayılan ölçümü süresidir ancak önbellek isabetleri ve bellek uyarıları gibi özel ölçümler de ekleyebilirsiniz.
Kodunuzda, Performance Monitoring SDK tarafından sağlanan API'yi kullanarak özel bir kod izlemenin başlangıcını ve sonunu tanımlarsınız (ve istediğiniz özel ölçümleri eklersiniz).
Bu özellikler ve bunları uygulamanıza nasıl ekleyeceğiniz hakkında daha fazla bilgi edinmek için Belirli bir kod için izleme ekleme sayfasını ziyaret edin.
5. Adım : Uygulamanızı dağıtın ve ardından sonuçları inceleyin
Xcode simülatörünü ve bir veya daha fazla test cihazını kullanarak Performans İzlemeyi doğruladıktan sonra uygulamanızın güncellenmiş sürümünü kullanıcılarınıza dağıtabilirsiniz.
Performans verilerini Firebase konsolunun Performans kontrol panelinden izleyebilirsiniz.
Bilinen Sorunlar
- Performans İzleme'nin GTMSSQLite ile bilinen uyumluluk sorunları vardır. Performans İzleme'yi GTMSSQLite kullanan uygulamalarla kullanmamanızı öneririz.
-
FirebaseApp.configure()
çağrıldıktan sonra yapılan swizzling yöntemi, Performans İzleme SDK'sını etkileyebilir. - iOS 8.0-8.2 Simülatörüyle ilgili bilinen sorunlar, Performans İzleme'nin performans olaylarını yakalamasını engeller. Bu sorunlar iOS 8.3 Simulator ve sonraki sürümlerde düzeltilmiştir.
- NSURLSession'ın
backgroundSessionConfiguration
kullanılarak kurulan bağlantılar, beklenenden daha uzun bağlantı süreleri sergileyecektir. Bu bağlantılar işlem dışında yürütülür ve zamanlamalar işlem içi geri arama olaylarını yansıtır.
Sonraki adımlar
Performans İzleme iOS kod örneğini GitHub'da inceleyin ve çalıştırın.
Performans İzleme tarafından otomatik olarak toplanan veriler hakkında daha fazla bilgi edinin:
- Uygulama başlangıç zamanı gibi uygulamanızın yaşam döngüsüyle ilgili veriler
- Uygulamanızda ekran oluşturmaya ilişkin veriler
- Uygulamanız tarafından yayınlanan HTTP/S ağ isteklerine ilişkin veriler
Performans verilerinizi Firebase konsolunda görüntüleyin, izleyin ve filtreleyin .
Özel kod izlerini kullanarak uygulamanıza belirli görevler veya iş akışları için izleme ekleyin.
Performans verilerini filtrelemek için nitelikleri kullanın .