Sen başlamadan önce
Henüz yapmadıysanız, Apple projenize Firebase'i ekleyin .
1. Adım : Uygulamanıza Performans İzleme ekleyin
Performans İzleme SDK'sını ekledikten sonra, Firebase otomatik olarak uygulamanızın ekran işlemesi için veri, uygulamanızın yaşam döngüsüyle ilgili veriler ( uygulama başlangıç zamanı gibi) ve HTTP/S ağ istekleri için veri toplamaya başlar.
Firebase bağımlılıklarını kurmak ve yönetmek için Swift Paket Yöneticisi'ni kullanın.
- Xcode'da, uygulama projeniz açıkken File > Add Packages seçeneğine gidin.
- İstendiğinde, Firebase Apple platformları SDK deposunu ekleyin:
- Performans İzleme kitaplığını seçin.
- Bittiğinde, Xcode otomatik olarak bağımlılıklarınızı arka planda çözmeye ve indirmeye başlayacaktır.
https://github.com/firebase/firebase-ios-sdk
Ardından, Firebase modülünü yapılandırın:
-
UIApplicationDelegate
FirebaseCore
modülünü ve uygulama temsilcinizin kullandığı diğer Firebase modüllerini içe aktarın. Örneğin, Cloud Firestore ve Kimlik Doğrulamayı kullanmak için:Süratli
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Amaç-C
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Genellikle
App
başlatıcısında veya uygulama temsilcisininapplication(_:didFinishLaunchingWithOptions:)
yönteminde birFirebaseApp
paylaşılan örneği yapılandırın:Süratli
// Use Firebase library to configure APIs FirebaseApp.configure()
Amaç-C
// Use Firebase library to configure APIs [FIRApp configure];
- Uygulamanızı yeniden derleyin.
Adım 2 : İlk veri gösterimi için performans olayları oluşturun
Firebase, SDK'yı uygulamanıza başarıyla eklediğinizde olayları işlemeye başlar. Hâlâ yerel olarak geliştiriyorsanız, ilk veri toplama ve işleme için olaylar oluşturmak üzere uygulamanızla etkileşim kurun.
Bir simülatör veya test cihazı kullanarak uygulamanızı geliştirmeye devam edin.
Uygulamanızı arka plan ve ön plan arasında birkaç kez değiştirerek, ekranlar arasında gezinerek uygulamanızla etkileşim kurarak ve/veya ağ isteklerini tetikleyerek olaylar oluşturun.
Firebase konsolunun Performans panosuna gidin. Birkaç dakika içinde ilk veri görüntünüzü görmelisiniz.
İlk verilerinizin bir görüntüsünü görmüyorsanız, sorun giderme ipuçlarını gözden geçirin.
3. Adım : (İsteğe bağlı) Performans olayları için günlük mesajlarını görüntüleyin
Hata ayıklama günlüğünü aşağıdaki gibi etkinleştirin:
- Xcode'da (minimum v13.3.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şlatmada Geçilen Bağımsız Değişkenler bölümünde,
-FIRDebugEnabled
ekleyin.
Herhangi bir hata mesajı için günlük mesajlarınızı kontrol edin.
Performans İzleme, günlük mesajlarınızı filtreleyebilmeniz için günlük mesajlarını
Firebase/Performance
ile etiketler.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
-
Firebase konsolunda verilerinizi 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 kaydedmiyorsa sorun giderme ipuçlarını gözden geçirin.
Adım 4 : (İsteğe bağlı) Belirli kod için özel izleme ekleyin
Uygulamanızdaki belirli kodla ilişkili performans verilerini izlemek için özel kod izlemelerini kullanabilirsiniz.
Özel kod izlemeyle, uygulamanızın belirli bir görevi veya bir dizi görüntüyü yükleme veya veritabanınızı sorgulama gibi görevleri tamamlamasının ne kadar sürdüğünü ölçebilirsiniz. Özel kod izlemesi için 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 kod izlemenin başlangıcını ve sonunu tanımlarsınız (ve istediğiniz özel metrikleri eklersiniz).
Bu özellikler ve bunları uygulamanıza nasıl ekleyeceğiniz hakkında daha fazla bilgi edinmek için belirli kod için İzleme ekle sayfasını ziyaret edin.
Adım 5 : Uygulamanızı dağıtın ve sonuçları inceleyin
Xcode simülatörü ve bir veya daha fazla test cihazı kullanarak Performans İzleme'yi doğruladıktan sonra, uygulamanızın güncellenmiş sürümünü kullanıcılarınıza dağıtabilirsiniz.
Firebase konsolunun Performans panosunda performans verilerini izleyebilirsiniz.
Bilinen Sorunlar
- Performans İzleme, GTMSQLite ile bilinen uyumluluk sorunlarına sahiptir. Performans İzleme'yi GTMSQLite kullanan uygulamalarla kullanmamanızı öneririz.
- FirebaseApp.configure
FirebaseApp.configure()
çağrıldıktan sonra yöntem kayması, Performans İzleme SDK'sını etkileyebilir. - iOS 8.0-8.2 Simülatörü ile ilgili bilinen sorunlar, Performans İzleme'nin performans olaylarını yakalamasını engeller. Bu sorunlar, iOS 8.3 Simülatörü ve sonraki sürümlerinde düzeltilmiştir.
- NSURLSession'ın
backgroundSessionConfiguration
kullanılarak kurulan bağlantılar, beklenenden daha uzun bağlantı süreleri sergileyecektir. Bu bağlantılar süreç dışı yürütülür ve zamanlamalar süreç içi geri arama olaylarını yansıtır.
Sonraki adımlar
GitHub'da Performans İzleme iOS kod örneğini 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 işleme için veriler
- Uygulamanız tarafından verilen HTTP/S ağ istekleri için veriler
Firebase konsolunda performans verilerinizi görüntüleyin, izleyin ve filtreleyin .
Özel kod izlemelerini kullanarak uygulamanıza belirli görevler veya iş akışları için izleme ekleyin.
Performans verilerini filtrelemek için öznitelikleri kullanın .