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

Bu hızlı başlangıç kılavuzunda, Flutter uygulamalarınızın performans özellikleriyle ilgili bilgi edinmenize yardımcı olması için Firebase Performance Monitoring'i nasıl ayarlayacağınız 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 performans izleme özelliğini ekleyin

  1. Flutter projenizin kök dizininden aşağıdaki komutu çalıştırarak Performance Monitoring Flutter eklentisini yükleyin:

    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 gerekli Performance Monitoring Gradle eklentisini uygulamanıza 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üyle (ör. uygulama başlatma süresi) ve HTTP/S ağ istekleriyle ilgili verileri otomatik olarak toplamaya başlar.

Flutter'da, tek tek Flutter ekranları için otomatik ekran oluşturma performansı izleme mümkün değildir. Tek bir görünüm denetleyicisi, Flutter uygulamanızın tamamını yerel olarak kapsar. Bu nedenle, temel alınan yerel Firebase SDK, ekran geçişlerinin farkında değildir.

Remote Config dokümanlarını inceleyin.

2. adım: İlk veri gösterimi için performans etkinlikleri oluşturun

SDK'yı uygulamanıza başarıyla 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 etkinlik oluşturmak üzere uygulamanızla etkileşimde bulunun.

  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 gösterge tablosuna gidin. İlk verilerinizin birkaç dakika içinde gösterilmesi gerekir.

    İlk verilerinizin gösterildiğini görmüyorsanız sorun giderme ipuçlarını inceleyin.

3. adım: (İsteğe bağlı) Performans etkinlikleriyle ilgili 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ı aşağıdaki etiketlerle etiketler. Böylece günlük mesajlarınızı filtreleyebilirsiniz:

    • iOS+: Firebase/Performance
    • Android: FirebasePerformance

  2. Aşağıdaki günlük türlerini kontrol ederek Performance Monitoring'in performans etkinliklerini günlüğe kaydettiğini doğrulayın:

    • 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 kod için özel izleme ekleyin

Uygulamanızdaki belirli bir kodla ilişkili performans verilerini izlemek için özel kod izleri oluşturabilirsiniz.

Özel kod izleme ile uygulamanızın belirli bir görevi veya görev grubunu (ör. bir grup resmi yükleme ya da veritabanınıza sorgu gönderme) tamamlamasının ne kadar sürdüğünü ölçebilirsiniz. Özel kod izlemenin varsayılan metriği süresidir ancak önbellek isabetleri ve bellek uyarıları gibi özel metrikler de ekleyebilirsiniz.

Kodunuzda, Performance Monitoring SDK'sının sağladığı API'yi kullanarak özel bir kod izinin başlangıcını ve bitişini tanımlarsınız (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ın ve 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