Check out what’s new from Firebase at Google I/O 2022. Learn more

Apple platformları için Performans İzlemeyi kullanmaya başlayın

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.

  1. Xcode'da, uygulama projeniz açıkken File > Add Packages seçeneğine gidin.
  2. İstendiğinde, Firebase Apple platformları SDK deposunu ekleyin:
  3.   https://github.com/firebase/firebase-ios-sdk
      
  4. Performans İzleme kitaplığını seçin.
  5. Bittiğinde, Xcode otomatik olarak bağımlılıklarınızı arka planda çözmeye ve indirmeye başlayacaktır.

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

  1. 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ğrulama'yı kullanmak için:

    Süratli

    import FirebaseCore
    import FirebaseFirestore
    import FirebaseAuth
    // ...
          

    Amaç-C

    @import FirebaseCore;
    @import FirebaseFirestore;
    @import FirebaseAuth;
    // ...
          
  2. Genellikle uygulamanızın application:didFinishLaunchingWithOptions: yönteminde bir FirebaseApp 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];
  1. 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.

  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 birkaç kez değiştirerek, ekranlar arasında gezinerek uygulamanızla etkileşim kurarak ve/veya ağ isteklerini tetikleyerek olaylar oluşturun.

  3. 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

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

    1. Xcode'da (minimum v13.3.1), Ürün > Şema > Şemayı düzenle öğesini seçin.
    2. Soldaki menüden Çalıştır'ı seçin, ardından Bağımsız Değişkenler sekmesini seçin.
    3. Başlatmada Geçilen Bağımsız Değişkenler bölümünde, -FIRDebugEnabled ekleyin.
  2. Herhangi bir hata mesajı için günlük mesajlarınızı kontrol edin.

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

  4. 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
  5. 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