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: Performans İzleme'yi uygulamanıza 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'de gerekli Performance Monitoring Gradle eklentisini uygulamanıza ekler.

  3. Ardından Flutter projenizi yeniden derleyin:

    flutter run
    

Performance Monitoring SDK'sı eklendikten sonra Firebase, uygulamanızın yaşam döngüsüyle ilgili verileri (uygulama başlangıç zamanı gibi) ve HTTP/S ağ istekleri ile ilgili 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

Firebase, SDK'yı uygulamanıza başarıyla eklediğinizde 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şim kurun.

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

  2. Uygulamanızı arka plan ile ön plan arasında birkaç kez değiştirerek, ekranlar arasında gezinerek uygulamanızla etkileşime geçerek ve/veya ağ isteklerini tetikleyerek etkinlikler 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 etkinlikleriyle ilgili günlük mesajlarını görüntüleme

  1. Hata mesajı olup olmadığını görmek 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ı aşağıdaki etiketlerle etiketler:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance
  2. Performans İzleme'nin performans etkinliklerini 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 bir kodla ilişkilendirilmiş performans verilerini izlemek için özel kod izlerini kullanabilirsiniz.

Özel kod izleme ile 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, 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 uygulamanıza nasıl eklenecekleri hakkında daha fazla bilgi edinmek için Belirli kod için izleme ekleme başlıklı makaleyi inceleyin.

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 kontrol panelinde izleyebilirsiniz.

Sonraki adımlar