Sen başlamadan önce
Henüz yapmadıysanız Android projenize Firebase'i ekleyin .
1. Adım : Performans İzleme SDK'sını uygulamanıza ekleyin
Performans İzleme SDK'sını ekledikten sonra Firebase, uygulamanızın ekran oluşturma işlemine ilişkin verileri ve uygulamanızın yaşam döngüsüyle ilgili verileri ( uygulama başlangıç zamanı gibi) otomatik olarak toplamaya başlar. Firebase'in ağ isteklerini izlemesini sağlamak için Performance Monitoring Gradle eklentisini de eklemelisiniz (sonraki adım).
Modülünüzde (uygulama düzeyinde) Gradle dosyanızda (genellikle
<project>/<app-module>/build.gradle.kts
veya<project>/<app-module>/build.gradle
), Performans İzleme bağımlılığını ekleyin Android için kütüphane. Kitaplık sürümlerini kontrol etmek için Firebase Android BoM'yi kullanmanızı öneririz.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:32.7.0")) // Add the dependency for the Performance Monitoring library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-perf") }
Firebase Android BoM'yi kullandığınızda uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanır.
Kotlin'e özgü bir kütüphane modülü mü arıyorsunuz? Ekim 2023'ten itibaren (Firebase BoM 32.5.0) hem Kotlin hem de Java geliştiricileri ana kütüphane modülüne güvenebilecekler (ayrıntılar için bu girişimle ilgili SSS'ye bakın).(Alternatif) BoM'yi kullanmadan Firebase kitaplığı bağımlılıklarını ekleyin
Firebase BoM'yi kullanmamayı tercih ederseniz her Firebase kitaplığı sürümünü bağımlılık satırında belirtmeniz gerekir.
Uygulamanızda birden fazla Firebase kitaplığı kullanıyorsanız kitaplık sürümlerini yönetmek için tüm sürümlerin uyumlu olmasını sağlayan BoM'yi kullanmanızı önemle tavsiye ettiğimizi unutmayın.
dependencies { // Add the dependency for the Performance Monitoring library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-perf:20.5.1") }
Uygulamanızı yeniden derleyin.
Adım 2 : Performans İzleme Gradle eklentisini uygulamanıza ekleyin
Performance Monitoring Gradle eklentisini ekledikten sonra Firebase, HTTP/S ağ istekleri için otomatik olarak veri toplamaya başlar. Eklenti ayrıca @AddTrace ek açıklamasını kullanarak özel kod izlerini izlemenize de olanak tanır.
Kök düzeyindeki (proje düzeyi) Gradle dosyanıza (
<project>/build.gradle.kts
veya<project>/build.gradle
), Performance Monitoring Gradle eklentisini ekleyin:Kotlin
plugins { // To benefit from the latest Performance Monitoring plugin features, // update your Android Gradle plugin dependency to at least v3.4.0 id("com.android.application") version "7.3.0" apply false // Make sure that you have the Google services Gradle plugin dependency id("com.google.gms.google-services") version "4.4.0" apply false // Add the dependency for the Performance Monitoring Gradle plugin id("com.google.firebase.firebase-perf") version "1.4.2" apply false }
Groovy
plugins { // To benefit from the latest Performance Monitoring plugin features, // update your Android Gradle plugin dependency to at least v3.4.0 id 'com.android.application' version '7.3.0' apply false // Make sure that you have the Google services Gradle plugin dependency id 'com.google.gms.google-services' version '4.4.0' apply false // Add the dependency for the Performance Monitoring Gradle plugin id 'com.google.firebase.firebase-perf' version '1.4.2' apply false }
Modülünüzün (uygulama düzeyi) Gradle dosyasına (genellikle
<project>/<app-module>/build.gradle.kts
veya<project>/<app-module>/build.gradle
), Performance Monitoring Gradle eklentisini ekleyin:Kotlin
plugins { id("com.android.application") // Make sure that you have the Google services Gradle plugin id("com.google.gms.google-services") // Add the Performance Monitoring Gradle plugin id("com.google.firebase.firebase-perf") ... }
Groovy
plugins { id 'com.android.application' // Make sure that you have the Google services Gradle plugin id 'com.google.gms.google-services' // Add the Performance Monitoring Gradle plugin id 'com.google.firebase.firebase-perf' ... }
Uygulamanızı yeniden derleyin.
3. Adım : İlk veri görüntüleme için performans olaylarını oluşturun
Firebase, SDK'yı uygulamanıza başarıyla eklediğinizde etkinlikleri işlemeye başlar. Hala yerel olarak geliştirme yapıyorsanız, ilk veri toplama ve işlemeye yönelik etkinlikler oluşturmak için uygulamanızla etkileşim kurun.
Uygulamanızı birkaç kez arka plan ve ön plan arasında değiştirerek, ekranlar arasında gezinerek uygulamanızla etkileşim kurarak ve/veya ağ isteklerini tetikleyerek etkinlikler oluşturun.
Firebase konsolunun Performans kontrol paneline gidin. Birkaç dakika içinde ilk verilerinizin görüntülendiğini görmelisiniz.
Başlangıç verilerinizin görüntüsünü görmüyorsanız sorun giderme ipuçlarını inceleyin.
4. Adım : (İsteğe bağlı) Performans etkinliklerine ilişkin günlük mesajlarını görüntüleyin
Uygulamanızın
AndroidManifest.xml
dosyasına aşağıdaki gibi bir<meta-data>
öğesi ekleyerek Performans İzleme için hata ayıklama günlüğünü etkinleştirin:<application> <meta-data android:name="firebase_performance_logcat_enabled" android:value="true" /> </application>
Herhangi bir hata mesajı için günlük mesajlarınızı kontrol edin.
Performance Monitoring, günlük mesajlarını
FirebasePerformance
ile etiketler. Logcat filtrelemeyi kullanarak, aşağıdaki komutu çalıştırarak özellikle süre izlemeyi ve HTTP/S ağ isteği günlüğünü görüntüleyebilirsiniz:adb logcat -s FirebasePerformance
Performans İzleme'nin performans olaylarını 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
-
Verilerinizi Firebase konsolunda görüntülemek için URL'yi tıklayın. Verilerin kontrol panelinde güncellenmesi birkaç dakika sürebilir.
Uygulamanız performans olaylarını günlüğe kaydetmiyorsa sorun giderme ipuçlarını inceleyin.
Adım 5 : (İsteğe bağlı) Belirli kod için özel izleme ekleyin
Uygulamanızdaki belirli kodlarla ilişkili performans verilerini izlemek için özel kod izlemelerini kullanabilirsiniz.
Özel bir kod izlemeyle, uygulamanızın belirli bir görevi veya bir dizi görseli yükleme veya veritabanınızı sorgulama gibi görevleri tamamlamasının ne kadar sürdüğünü ölçebilirsiniz. Özel bir kod izlemenin varsayılan ölçümü süresidir ancak önbellek isabetleri ve bellek uyarıları gibi özel ölçümler de ekleyebilirsiniz.
Kodunuzda, Performance Monitoring SDK tarafından sağlanan API'yi kullanarak özel bir kod izlemenin başlangıcını ve sonunu tanımlarsınız (ve istediğiniz özel ölçümleri eklersiniz). Android uygulamaları için, @AddTrace ek açıklamasını kullanarak belirli yöntemlerin süresini de izleyebilirsiniz.
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 sayfasını ziyaret edin.
6. Adım : Uygulamanızı dağıtın ve ardından sonuçları inceleyin
Performans İzlemeyi 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 panelinden izleyebilirsiniz.
Bilinen Sorunlar
Performance Monitoring Gradle eklentisi v1.1.0, Guava bağımlılıklarında bir uyumsuzluğa neden olabilir ve bu da aşağıdaki hataya neden olabilir:
Error:Execution failed for task ':app:packageInstantRunResourcesDebug'. > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;
Bu hatayı görürseniz aşağıdakilerden birini yapabilirsiniz:
Performans İzleme eklentisini v1.1.1 veya sonraki bir sürüme yükseltin (en yenisi v1.4.2'dir).
Kök düzeyindeki (proje düzeyi) Gradle dosyanızdaki (
<project>/build.gradle.kts
veya<project>/build.gradle
) Performans İzleme eklentisi bağımlılık satırını aşağıdaki gibi değiştirin:Kotlin
buildscript { // ... dependencies { // ... // Replace the standard Performance Monitoring plugin dependency line, as follows: classpath("com.google.firebase:perf-plugin:1.1.0") { exclude(group = "com.google.guava", module = "guava-jdk5") } } }
Groovy
buildscript { // ... dependencies { // ... // Replace the standard Performance Monitoring plugin dependency line, as follows: classpath('com.google.firebase:perf-plugin:1.1.0') { exclude group: 'com.google.guava', module: 'guava-jdk5' } } }
Performans İzleme, HTTP içerik uzunluğu üstbilgisinde ayarlanan değere dayalı olarak HTTP ağ istekleri için toplam yük boyutunu bildirir. Bu değer her zaman doğru olmayabilir.
Performans İzleme, çok işlemli Android uygulamalarında yalnızca ana işlemi destekler.
Sonraki adımlar
GitHub'da Performance Monitoring Android kod örneğini inceleyin ve çalıştırın.
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üyle ilgili veriler
- Uygulamanızda ekran oluşturmaya ilişkin veriler
- Uygulamanız tarafından yayınlanan HTTP/S ağ isteklerine ilişkin veriler
Performans verilerinizi Firebase konsolunda görüntüleyin, izleyin ve filtreleyin .
Özel kod izlerini kullanarak uygulamanıza belirli görevler veya iş akışları için izleme ekleyin.
Performans verilerini filtrelemek için nitelikleri kullanın .