Apple platformları için Performance Monitoring'i kullanmaya başlayın

Başlamadan önce

Henüz yapmadıysanız Firebase'i Apple projenize ekleyin.

1. Adım: Uygulamanıza Performance Monitoring'i ekleyin

Performance Monitoring SDK'sını eklemenizin ardından Firebase, uygulamanızın ekran oluşturma süreciyle ilgili verileri, uygulamanızın yaşam döngüsüyle ilgili verileri (ör. uygulama başlangıç zamanı) ve HTTP/S ağ istekleri ile ilgili verileri otomatik olarak toplamaya başlar.

Firebase bağımlılıklarını yükleyip yönetmek için Swift Package Manager'ı kullanın.

  1. Xcode'da, uygulamanız açıkken File > Add Packages'a (Dosya > Paket Ekle) gidin.
  2. İstendiğinde Firebase Apple platformlar SDK deposunu ekleyin:
    3.   https://github.com/firebase/firebase-ios-sdk.git
  3. Performance Monitoring kitaplığını seçin.
  4. -ObjC işaretini, hedefinizin derleme ayarlarındaki Diğer Bağlayıcı İşaretleri bölümüne ekleyin.
  5. İşlem tamamlandığında Xcode, arka planda bağımlılıklarınızı otomatik olarak çözümlemeye ve indirmeye başlar.

Ardından Firebase modülünü yapılandırın:

  1. FirebaseCore modülünü UIApplicationDelegate uygulamanıza ve yetki verdiğiniz kullanıcının kullandığı diğer tüm Firebase modüllerini içe aktarın. Örneğin, Cloud Firestore ve Authentication'ı kullanmak için:

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

    import SwiftUI
import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Swift

    import FirebaseCore
import FirebaseFirestore
import FirebaseAuth
// ...

    Objective-C

    @import FirebaseCore;
@import FirebaseFirestore;
@import FirebaseAuth;
// ...
  2. Uygulama yetkilinizin application(_:didFinishLaunchingWithOptions:) yönteminde FirebaseApp paylaşılan bir örnek yapılandırın:

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

    // 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];
  3. SwiftUI kullanıyorsanız bir uygulama temsilcisi oluşturmanız ve UIApplicationDelegateAdaptor veya NSApplicationDelegateAdaptor aracılığıyla App yapınıza eklemeniz gerekir. Uygulama yetkilendirmesi kaydırmayı da devre dışı bırakmanız gerekir. Daha fazla bilgi için SwiftUI talimatlarına bakın.

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

    @main
struct YourApp: App {
  // register app delegate for Firebase setup
  @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

  4. Uygulamanızı yeniden derleyin.

2. Adım: Verilerin ilk gösterilmesi 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.

  1. Bir simülatör veya test cihazı kullanarak uygulamanızı geliştirmeye devam edin.

  2. Uygulamanızı birkaç kez arka plan ve ön plan arasında değiştirerek, ekranlar arasında gezinerek uygulamanızla etkileşimde bulunarak ve/veya ağ isteklerini tetikleyerek etkinlik oluşturun.

  3. Firebase konsolunun Performans kontrol paneline gidin. İlk verilerinizin birkaç dakika içinde görünmesi gerekir.

    İlk verileriniz gösteriliyorsa sorun giderme ipuçlarını inceleyin.

3. Adım: (İsteğe bağlı) Performans etkinliklerine ait günlük mesajlarını görüntüleyin

  1. Hata ayıklama günlük kaydını aşağıdaki gibi etkinleştirin:

    1. Xcode'da (minimum v14.1) Ürün > Şema > Şemayı düzenle'yi seçin.
    2. Soldaki menüden Çalıştır'ı, ardından Bağımsız değişkenler sekmesini seçin.
    3. Lansmanda İletilen Bağımsız Değişkenler bölümüne -FIRDebugEnabled ekleyin.

  2. Hata mesajı olup olmadığını görmek için günlük mesajlarınızı kontrol edin.

  3. Performance Monitoring, günlük mesajlarınızı filtreleyebilmeniz için günlük mesajlarını Firebase/Performance ile etiketler.

  4. Performance Monitoring'in performans etkinliklerini 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

  5. 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 bir kodla ilişkilendirilmiş performans verilerini izlemek için özel kod izlerini kullanabilirsiniz.

Özel kod izlemeyle, uygulamanızın belirli bir görevi veya görev kümesini (ör. bir dizi resim yüklemek ya da veritabanınızı sorgulamak) 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 bir kod izlemenin başlangıcını ve sonunu tanımlar (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 bir kod için izleme ekleme bölümünü ziyaret edin.

5. Adım: Uygulamanızı dağıtıp sonuçları inceleyin

Xcode simülatörü ve bir veya daha fazla test cihazını kullanarak Performance Monitoring'i 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'in GTMSQLite ile ilgili bilinen uyumluluk sorunları vardır. Performance Monitoring'i GTMSQLite kullanan uygulamalarla birlikte kullanmamanızı öneririz.
  • FirebaseApp.configure() çağrısından sonra yöntem kaydırma işlemi, Performance Monitoring SDK'sının çalışmasını etkileyebilir.
  • iOS 8.0-8.2 Simülatörü ile ilgili bilinen sorunlar, Performance Monitoring'in performans etkinliklerini yakalamasını engeller. Bu sorunlar, iOS 8.3 Simülatörü ve sonraki sürümlerde düzeltilmiştir.
  • NSURLSession'ın backgroundSessionConfiguration öğesi kullanılarak oluşturulan bağlantılar, beklenenden uzun süre bekler. Bu bağlantılar işlem dışı olarak yürütülür ve zamanlamalar işlem içi geri çağırma etkinliklerini yansıtır.

Sonraki adımlar