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ı eklendikten sonra Firebase, otomatik olarak veri toplamaya başlar Uygulamanızın ekran oluşturmaya ilişkin verileri, yaşam döngüsüyle (ör. uygulama başlangıç zamanı) ve HTTP/S ağ istekleri ile ilgili veriler.

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

  1. Xcode'da, uygulama projeniz açıkken Dosya > Paket Ekle'yi tıklayın.
  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. İşlemi tamamladığınızda, Xcode otomatik olarak arka planda tutmalarını sağlar.

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

  1. FirebaseCore modülünü UIApplicationDelegate ve diğer Yetki verdiğiniz uygulamanın kullandığı Firebase modülleri. Ö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. Şunu yapılandır: FirebaseApp paylaşılan örneğinizin application(_:didFinishLaunchingWithOptions:) yöntemi:

    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şturup bunu eklemeniz gerekir UIApplicationDelegateAdaptor veyaApp NSApplicationDelegateAdaptor. Uygulama yetkilendirmesi kaydırmayı da devre dışı bırakmanız gerekir. Örneğin, 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.

ziyaret edin.

2. Adım: Verilerin ilk gösterilmesi için performans etkinlikleri oluşturun

Firebase, SDK'yı uygulamanıza başarılı bir şekilde eklediğinizde etkinlikleri işlemeye başlar: uygulamasını indirin. Hâlâ yerel olarak geliştirme yapıyorsanız etkinlikleri gözden geçirin.

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

  2. Uygulamanızı arka plan ve ön plan arasında değiştirerek etkinlik oluşturun veya ekranlar arasında gezinerek uygulamanızla etkileşime girin ya da ve/veya ağ isteklerini tetikler.

  3. Performans kontrol paneline gidin bölümüne gidin. İlk verilerinizin birkaç dakika.

    İlk verileriniz gösterilmiyorsa sorun giderme ipuçları.

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üzenleyin.
    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ı Firebase/Performance ile etiketler. Böylece şunları yapabilirsiniz: günlük mesajlarınızı filtreleyebilirsiniz.

  4. Performance Monitoring'in şu özelliklere sahip olduğunu gösteren aşağıdaki günlük türlerini kontrol edin: performans etkinliklerini günlüğe kaydetme:

    • 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. Birkaç dakika anlarda etkinleştirmeniz gerekir.

Uygulamanız performans etkinliklerini günlüğe kaydetmiyorsa sorun giderme ipuçları.

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 araç özel kod izleri.

Özel kod izleme ile uygulamanızın ne kadar sürede tamamlandığını ölçebilirsiniz. belirli bir görev veya görev kümesi (örneğin, bir dizi resim yüklemek veya yardımcı olur. Özel kod izleme için varsayılan metrik süresidir ancak önbellek isabetleri ve bellek uyarıları gibi özel metrikler de ekleyebilirsiniz.

Kodunuzda, özel bir kod izlemenin başlangıcını ve sonunu tanımlarsınız istediğiniz özel metrikleri ekleyebilirsiniz).

Belirli bir kod için izleme ekleme sayfasını ziyaret edin. göz atın.

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

Xcode simülatörü ve bir veya daha fazla aracı kullanarak Performance Monitoring'i doğruladıktan sonra test cihazlarında uygulamanızın güncellenmiş sürümünü kullanıcılarınıza dağıtabilirsiniz.

Performans verilerini Google Ads Performans kontrol paneli bölümüne gidin.

Bilinen sorunlar

  • Performance Monitoring'in GTMSQLite ile ilgili bilinen uyumluluk sorunları vardır. Önerilerimiz GTMSQLite kullanan uygulamalarla birlikte Performance Monitoring'in kullanılmasıdır.
  • FirebaseApp.configure() çağrıldıktan sonra yöntemin hızlıca kaydırılması çakışmaya neden olabilir Performance Monitoring SDK'sı.
  • iOS 8.0-8.2 Simülatörü ile ilgili bilinen sorunlar, Performans İzleme'nin performans etkinliklerini yakalayabilirsiniz. iOS 8.3 Simülatörü'nde bu sorunlar düzeltilmiştir ve sonraki sürümler.
  • NSURLSession'ın backgroundSessionConfiguration öğesi kullanılarak kurulan bağlantılar bağlantı sürelerinden uzun olacaktır. Bu bağlantılar devam eder ve zamanlamalar işlem içi geri çağırma etkinliklerini yansıtır.

Sonraki adımlar