Flutter için Performans İzleme'yi kullanmaya başlama

Bu hızlı başlangıç kılavuzunda, Flutter uygulamalarınızın performans özellikleri hakkında bilgi edinmenize yardımcı olmak için Firebase Performance Monitoring'in nasıl ayarlanacağı açıklanmaktadır.

Başlamadan önce

Henüz yapmadıysanız Flutter projenizde Firebase'i yapılandırın ve başlatın.

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

  1. Performance Monitoring Flutter eklentisini yüklemek için Flutter projenizin kök dizininde aşağıdaki komutu çalıştırın:

    flutter pub add firebase_performance

  2. Flutter projenizin kök dizininden aşağıdaki komutu çalıştırın:

    flutterfire configure

    Bu komutu çalıştırmak, Flutter uygulamanızın Firebase yapılandırmasının güncel olmasını sağlar ve Android için uygulamanıza gerekli Performance Monitoring Gradle eklentisini ekler.

  3. İşlem tamamlandığında Flutter projenizi yeniden oluşturun:

    flutter run

Performance Monitoring SDK'sını ekledikten sonra Firebase, uygulamanızın yaşam döngüsü ile ilgili verileri (ör. uygulama başlatma süresi) ve HTTP/S ağ isteklerine ilişkin verileri otomatik olarak toplamaya başlar.

Flutter'da, otomatik ekran oluşturma performansını izleme tek Flutter ekranlarında mümkün değildir. Tek bir görünüm denetleyici, Flutter uygulamanızın tamamını yerel olarak kapsar. Böylece, temel yerel Firebase SDK'sı ekran geçişlerinden haberdar olmaz.

2. Adım: İlk veri görüntüleme 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. 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 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 etkinliklerine ait günlük mesajlarını görüntüleyin

  1. Günlük mesajlarınızda hata mesajı olup olmadığını kontrol edin.

    Performans İzleme, günlük mesajlarınızı filtreleyebilmeniz için günlük mesajlarını aşağıdaki etiketlerle etiketler:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

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

  3. Verilerinizi Firebase konsolunda görüntülemek için URL'yi tıklayın. Verilerin kontrol panelinde güncellenmesi birkaç dakika sürebilir.

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, izlemenin 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 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

Performans İzleme'yi bir emülatör ve bir veya daha fazla test cihazı kullanarak 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 gösterge tablosunda izleyebilirsiniz.

Sonraki adımlar