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 ekleyin

  1. Performans İzleme Flutter eklentisini yüklemek için Flutter projenizin kök dizininden 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 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. Performans İzleme'nin 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 kod için özel izleme ekleyin

Uygulamanızdaki belirli kodlarla 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 bunları uygulamanıza nasıl ekleyeceğiniz 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