Başlamadan önce
Henüz yapmadıysanız Firebase'i Apple projenize ekleyin.
1. Adım: Uygulamanıza Performance Monitoring ekleyin
Performance Monitoring SDK'sını ekledikten sonra Firebase, uygulamanızın ekran oluşturma, uygulamanızın yaşam döngüsü (ör. uygulama başlangıç zamanı) ve HTTP/S ağ istekleri ile ilgili verileri otomatik olarak toplamaya başlar.
Firebase bağımlılarını yüklemek ve yönetmek için Swift Package Manager'ı kullanın.
Firebase SDK'larını Apple projenize eklemenin farklı yolları (ör. doğrudan çerçeveleri içe aktarma ve CocoaPods kullanma) hakkında bilgi edinmek için- Xcode'da, uygulamanız açıkken Dosya > Paket Ekle'ye gidin.
- İstendiğinde Firebase Apple platformları SDK deposunu ekleyin:
- Performance Monitoring kitaplığını seçin.
-ObjC
işaretini, hedefinizin derleme ayarlarındaki Diğer Bağlayıcı İşaretleri bölümüne ekleyin.- İşlem tamamlandığında Xcode, arka planda bağımlılıklarınızı otomatik olarak çözümlemeye ve indirmeye başlar.
https://github.com/firebase/firebase-ios-sdk.git
Ardından Firebase modülünü yapılandırın:
FirebaseCore
modülünü ve uygulama temsilcinizin kullandığı diğer tüm Firebase modülleriniUIApplicationDelegate
dosyanıza aktarın. Örneğin, Cloud Firestore ve Authentication kullanmak için:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Swift
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Objective-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Uygulama temsilcinizin
application(_:didFinishLaunchingWithOptions:)
yönteminde birFirebaseApp
shared instance yapılandırın:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Swift
// Use Firebase library to configure APIs FirebaseApp.configure()
Objective-C
// Use Firebase library to configure APIs [FIRApp configure];
- SwiftUI kullanıyorsanız bir uygulama temsilcisi oluşturmanız ve
UIApplicationDelegateAdaptor
veyaNSApplicationDelegateAdaptor
aracılığıylaApp
yapınıza eklemeniz gerekir. Ayrıca uygulama temsilcisi değiştirme işlemini de devre dışı bırakmanız gerekir. 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.
2. Adım: İlk veri görüntüleme işlemi için performans etkinlikleri oluşturun
SDK'yı uygulamanıza başarılı bir şekilde eklediğinizde Firebase, etkinlikleri işlemeye başlar. Hâlâ yerel olarak geliştirme yapıyorsanız ilk veri toplama ve işleme için etkinlikler oluşturmak üzere uygulamanızla etkileşime geçin.
Bir simülatör veya test cihazı kullanarak uygulamanızı geliştirmeye devam edin.
Uygulamanızı arka plan ile ön plan arasında birkaç kez değiştirerek, ekranlar arasında gezinerek uygulamanızla etkileşime geçerek ve/veya ağ isteklerini tetikleyerek etkinlikler oluşturun.
Firebase konsolunun Performans gösterge tablosuna gidin. İlk verileriniz birkaç dakika içinde gösterilir.
İlk verilerinizin gösterilmediğini görürseniz sorun giderme ipuçlarını inceleyin.
3. Adım: (İsteğe bağlı) Performans etkinlikleriyle ilgili günlük mesajlarını görüntüleme
Hata ayıklama günlük kaydını aşağıdaki gibi etkinleştirin:
- Xcode'da (minimum v15.2) Ürün > Şema > Şemayı düzenle'yi seçin.
- Sol menüden Çalıştır'ı, ardından Parametreler sekmesini seçin.
- Başlatma sırasında iletilen bağımsız değişkenler bölümüne
-FIRDebugEnabled
ekleyin.
Hata mesajı olup olmadığını görmek için günlük mesajlarınızı kontrol edin.
Performance Monitoring, günlük mesajlarınızı filtreleyebilmeniz için günlük mesajlarını
Firebase/Performance
ile etiketler.Performance Monitoring'ün performans etkinliklerini kaydettiğini belirten 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 etkinliklerini günlüğe kaydetmiyorsa sorun giderme ipuçlarını inceleyin.
4. Adım: (İsteğe bağlı) Belirli bir kod için özel izleme ekleyin
Uygulamanızdaki belirli kodla ilişkili performans verilerini izlemek için özel kod izlerini kullanabilirsiniz.
Özel kod izleme özelliğiyle, uygulamanızın belirli bir görevi veya görev grubunu (ör. bir resim grubunu yükleme ya da veritabanınızı sorgulama) tamamlamasının ne kadar sürdüğünü ölçebilirsiniz. Özel kod izleme için varsayılan metrik süresidir ancak önbellek isabetleri ve bellek uyarıları gibi özel metrikler de ekleyebilirsiniz.
Kodunuzda, Performance Monitoring SDK'sı tarafından sağlanan API'yi kullanarak özel kod izinin başlangıç ve bitişini tanımlar (ve istediğiniz özel metrikleri eklersiniz).
Bu özellikler ve uygulamanıza nasıl eklenecekleri hakkında daha fazla bilgi edinmek için Belirli kod için izleme ekleme başlıklı makaleyi inceleyin.
5. Adım: Uygulamanızı dağıtıp sonuçları inceleyin
Xcode simülasyon aracını ve bir veya daha fazla test cihazını kullanarak Performance Monitoring'ü 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
- Performance Monitoring, GTMSQLite ile bilinen uyumluluk sorunları yaşar. GTMSQLite kullanan uygulamalarda Performance Monitoring kullanmamanızı öneririz.
FirebaseApp.configure()
çağrıldıktan sonra yöntem karıştırma işlemi, Performance Monitoring SDK'sını etkileyebilir.- iOS 8.0-8.2 Simülatörü ile ilgili bilinen sorunlar, Performance Monitoring hizmetinin performans etkinliklerini yakalamasını engeller. Bu sorunlar iOS 8.3 Simülasyon Aracı ve sonraki sürümlerde düzeltilmiştir.
- NSURLSession'in
backgroundSessionConfiguration
kullanılarak kurulan bağlantılar, beklenenden daha uzun bağlantı süreleri gösterir. Bu bağlantılar işlem dışında yürütülür ve zamanlamalar, işlem içi geri çağırma etkinliklerini yansıtır.
Sonraki adımlar
Performance Monitoring GitHub'daki iOS kod örneğini inceleyip çalıştırın.
Performance Monitoring 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ü ile ilgili veriler
- Uygulamanızdaki ekran oluşturma verileri
- Uygulamanız tarafından gönderilen HTTP/S ağ isteklerine ilişkin veriler
Firebase konsolunda performans verilerinizi görüntüleyin, izleyin ve filtreleyin.
Özel kod izlerini entegre ederek uygulamanızdaki belirli görevler veya iş akışları için izleme ekleyin.
Performans verilerini filtrelemek için özellikleri kullanın.