Android için Performance Monitoring'i kullanmaya başlayın

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).

  1. 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çin 

    dependencies {
    // 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")
}
    .     'nı inceleyin. Kotlin'e özel bir kitaplık modülü mü arıyorsunuz? Başlamak için kalan süre: Ekim 2023 (Firebase BoM 32.5.0), hem Kotlin hem de Java geliştiricileri (ayrıntılar için bkz. bu girişimle ilgili SSS).

  2. Uygulamanızı yeniden derleyin.

ziyaret edin.

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ı.

  1. 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
}

  2. 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'
    ...
}

  3. 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.

  1. 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.

  2. 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

  1. Derleme sırasında <meta-data> ekleyerek Performance Monitoring için hata ayıklama günlüğünü etkinleştirin öğesini uygulamanızın AndroidManifest.xml dosyasına ekleyin. Örneğin:

    <application>
    <meta-data
      android:name="firebase_performance_logcat_enabled"
      android:value="true" />
</application>

  2. Hata mesajı olup olmadığını görmek için günlük mesajlarınızı kontrol edin.

  3. 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

  4. 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

  5. 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