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
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
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.
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.
Bir simülatör veya test cihazı kullanarak uygulamanızı geliştirmeye devam edin.
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.
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
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
- iOS+:
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
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
Performans İzleme tarafından otomatik olarak toplanan veriler hakkında daha fazla bilgi edinin:
- Uygulama başlangıç zamanı gibi uygulamanızın yaşam döngüsü ile ilgili veriler
- Uygulamanız tarafından yayınlanan HTTP/S ağ istekleri için veriler
Firebase konsolunda performans verilerinizi görüntüleyebilir, izleyebilir ve filtreleyebilirsiniz.
Özel kod izlerini entegre ederek uygulamanızdaki belirli görevler veya iş akışları için izleme ekleyin.
Performans verilerini filtrelemek için özellikleri kullanın.