Başlamadan önce
Henüz yapmadıysanız Firebase'i Android projenize ekleyin.
1. Adım: Performance Monitoring SDK'sını uygulamanıza ekleyin
Performance Monitoring SDK'sı eklendikten sonra Firebase, otomatik olarak veri toplamaya başlar Uygulamanızın ekran oluşturma ve verilerine ilişkin veriler yaşam döngüsüyle (ör. uygulama başlangıç zamanı) girin. Alıcı: Firebase'in ağ isteklerini izlemesini sağlamak için Performans İzleme'yi de eklemeniz gerekir Gradle eklentisi (sonraki adım).
Modül (uygulama düzeyinde) Gradle dosyanızda (genellikle
<project>/<app-module>/build.gradle.kts
veya<project>/<app-module>/build.gradle
), Android için Performance Monitoring kitaplığına bağımlılığı ekleyin. Şunu kullanmanızı öneririz: Firebase Android BoM Kitaplık'ta sürüm oluşturmayı kontrol etmek içindependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.1.2")) // 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'u kullanarak, Uygulamanız her zaman Firebase Android kitaplıklarının uyumlu sürümlerini kullanacaktır.
(Alternatif) BoM'u kullanmadan Firebase kitaplığı bağımlılıklarını ekleyin
Firebase BoM'yi kullanmamayı tercih ederseniz her Firebase kitaplığı sürümünü belirtmeniz gerekir değerini alır.
Uygulamanızda birden çok Firebase kitaplığı kullanıyorsanız, kitaplık sürümlerini yönetmek için BoM kullanmanızı öneririz. Böylece, uyumlu olur.
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:21.0.1") }
.Uygulamanızı yeniden derleyin.
2. Adım: Performance Monitoring Gradle eklentisini uygulamanıza ekleyin
Performance Monitoring Gradle eklentisi eklendikten sonra Firebase, otomatik olarak müşteri için veri toplama HTTP/S ağ istekleri. İlgili içeriği oluşturmak için kullanılan eklentisi sayesinde özel kod izlemelerini kullanarak @AddTrace ek açıklaması.
Kök düzeyindeki (proje düzeyinde) Gradle dosyanızda (
<project>/build.gradle.kts
veya<project>/build.gradle
), Performance Monitoring Gradle eklentisi: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.2" 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.2' 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 (uygulama düzeyinde) Gradle dosyanızda (genellikle
<project>/<app-module>/build.gradle.kts
veya<project>/<app-module>/build.gradle
), Performans İzleme'yi ekleyin Gradle eklentisi: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: Verilerin ilk gösterilmesi için performans etkinlikleri oluşturun
Firebase, SDK'yı uygulamanıza başarılı bir şekilde eklediğinizde etkinlikleri işlemeye başlar: uygulamasını indirin. Hâlâ yerel olarak geliştirme yapıyorsanız etkinlikleri gözden geçirin.
Uygulamanızı arka plan ve ön plan arasında değiştirerek etkinlik oluşturun veya ekranlar arasında gezinerek uygulamanızla etkileşime girin ya da ve/veya ağ isteklerini tetikler.
Performans kontrol paneline gidin bölümüne gidin. İlk verilerinizin birkaç dakika.
İlk verileriniz gösterilmiyorsa sorun giderme ipuçları.
4. Adım: (İsteğe bağlı) Performans etkinliklerine ait günlük mesajlarını görüntüleyin
Derleme sırasında
<meta-data>
ekleyerek Performance Monitoring için hata ayıklama günlüğünü etkinleştirin öğesini uygulamanızınAndroidManifest.xml
dosyasına ekleyin. Örneğin:<application> <meta-data android:name="firebase_performance_logcat_enabled" android:value="true" /> </application>
Hata mesajı olup olmadığını görmek için günlük mesajlarınızı kontrol edin.
Performance Monitoring, günlük mesajlarını
FirebasePerformance
ile etiketler. Logcat'i kullanma özel olarak süre izlemeyi ve HTTP/S ağını görüntüleyebilirsiniz. aşağıdaki komutu çalıştırarak günlük kaydı isteyebilirsiniz:adb logcat -s FirebasePerformance
Performance Monitoring'in şu özelliklere sahip olduğunu gösteren aşağıdaki günlük türlerini kontrol edin: performans etkinliklerini günlüğe kaydetme:
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. Birkaç dakika anlarda etkinleştirmeniz gerekir.
Uygulamanız performans etkinliklerini günlüğe kaydetmiyorsa sorun giderme ipuçları.
5. 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 araç özel kod izleri.
Özel kod izleme ile uygulamanızın ne kadar sürede tamamlandığını ölçebilirsiniz. belirli bir görev veya görev kümesi (örneğin, bir dizi resim yüklemek veya yardımcı olur. Özel kod izleme için varsayılan metrik süresidir ancak önbellek isabetleri ve bellek uyarıları gibi özel metrikler de ekleyebilirsiniz.
Kodunuzda, özel bir kod izlemenin başlangıcını ve sonunu tanımlarsınız istediğiniz özel metrikleri ekleyebilirsiniz). Android uygulamalarında, belirli yöntemleri kullanarak @AddTrace ek açıklaması.
Belirli bir kod için izleme ekleme sayfasını ziyaret edin. göz atın.
6. Adım: Uygulamanızı dağıtıp sonuçları inceleyin
Bir veya daha fazla test cihazı kullanarak Performance Monitoring'i doğruladıktan sonra şunları yapabilirsiniz: Uygulamanızın güncellenmiş sürümünü kullanıcılarınıza dağıtın.
Performans verilerini Google Ads Performans kontrol paneli bölümüne gidin.
Bilinen sorunlar
Performance Monitoring Gradle eklentisi 1.1.0 sürümü Guava'da uyuşmazlığa neden olabilir bağımlılığıyla ilgili sorun ortaya çıktığında aşağıdaki hata ortaya çıkar:
Error:Execution failed for task ':app:packageInstantRunResourcesDebug'. > com.google.common.util.concurrent.MoreExecutors.directExecutor()Ljava/util/concurrent/Executor;
Bu hatayı görüyorsanız şunlardan birini yapabilirsiniz:
Performance Monitoring eklentisini v1.1.1 veya sonraki bir sürüme yükseltin (en son Sürüm 1.4.2) için geçerli olacaktır.
kök düzeyinde (proje düzeyinde) Gradle dosyası (
<project>/build.gradle.kts
veya<project>/build.gradle
) kaldırın: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' } } }
Performance Monitoring, temel alınan HTTP ağ istekleri için toplam yük boyutunu değerini girin. Bu değerde her zaman doğru olmasını sağlayın.
Performance Monitoring yalnızca çok işlemli Android uygulamalarında ana işlemi destekler.
Sonraki adımlar
Performance Monitoring tarafından otomatik olarak toplanan veriler hakkında daha fazla bilgi edinin:
- Uygulamanızın yaşam döngüsüyle ilgili veriler. Örneğin: uygulama başlangıç zamanı
- Uygulamanızdaki ekran oluşturma verileri
- Yayınlanan HTTP/S ağ isteklerine ait veriler uygulamanız tarafından
Görüntüleme, izleme ve filtreleme performans verilerini kontrol edin.
Uygulamanıza belirli görevler veya iş akışları için izleme eklemek için özel kod izleme araçlarının kullanılması.
Performans verilerini filtrelemek için özellikleri kullanın.