Bu sayfa, Cloud Translation API ile çevrilmiştir.

Android için Performans İzlemeyi kullanmaya başlayın

Sen başlamadan önce

Eğer henüz yapmadıysanız, Android projeye Firebase ekleyin .

1. Adım: uygulamanıza SDK'yı İzleme Performans ekle

Performans İzleme SDK ekledikten sonra, Firebase otomatik uygulamanızın için veri toplamaya başlar ekran render (gibi uygulamanızın ömrü ile ilgili ve veri uygulama başlangıç zamanı ). Ağ isteklerini izlemek için Firebase etkinleştirmek için, ayrıca Gradle eklentisi (sonraki adım) İzleme Performans eklemelisiniz.

Kullanılması Firebase Android Bom , senin modülü (uygulama düzeyinde) Gradle dosyası (genellikle Android kütüphane İzleme Performans bağımlılığı beyan app/build.gradle ).
Java
```
dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:28.4.2')

    // Declare 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'
}
```
Kullanarak Firebase Android Bom , uygulamanızın her zaman Firebase Android kütüphanelerin uyumlu versiyonlarını kullanacak.
(Alternatif) Bom kullanmadan Firebase kütüphane bağımlılıklarını beyan
Firebase Malzeme Listesini kullanmamayı seçerseniz, her bir Firebase kitaplık sürümünü bağımlılık satırında belirtmeniz gerekir.
Eğer uygulamanızda birden Firebase kitaplıkları kullanırsanız, biz çok tüm versiyonlar uyumlu olmasını sağlar kütüphane sürümlerini yönetmek için Bom kullanmanızı öneririz olduğunu unutmayın.
```
dependencies {
    // Declare 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.0.3'
}
```
Kotlin+KTX
```
dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:28.4.2')

    // Declare 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-ktx'
}
```
Kullanarak Firebase Android Bom , uygulamanızın her zaman Firebase Android kütüphanelerin uyumlu versiyonlarını kullanacak.
(Alternatif) Bom kullanmadan Firebase kütüphane bağımlılıklarını beyan
Firebase Malzeme Listesini kullanmamayı seçerseniz, her bir Firebase kitaplık sürümünü bağımlılık satırında belirtmeniz gerekir.
Eğer uygulamanızda birden Firebase kitaplıkları kullanırsanız, biz çok tüm versiyonlar uyumlu olmasını sağlar kütüphane sürümlerini yönetmek için Bom kullanmanızı öneririz olduğunu unutmayın.
```
dependencies {
    // Declare 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-ktx:20.0.3'
}
```
Uygulamanızı yeniden derleyin.

2. Adım: uygulamanıza Performans İzleme eklenti ekle

Eğer Gradle eklenti İzleme Performans ekledikten sonra, Firebase otomatik için veri toplamaya başlar HTTP / S ağ istekleri . Eklenti kullanarak enstrüman özel kod izleri sağlar @AddTrace ek açıklama .

Performans İzleme eklentisi nasıl çalışır?

Kodunuzu DEX dosyaları dönüştürülür önce, Performans İzleme eklenti kullanır Transform API ve ASM bytecode enstrümantasyon çerçeve uygulamanızın derlenmiş sınıf dosyaları ve araca (ölçü performansına) kodu ziyarete. Kodunuzu kullanmak için geçen süre, büyük ölçüde sınıflarınızın sayısına ve boyutuna bağlıdır.

Uygulamanızın derlenmesi istediğinizden daha uzun sürüyorsa aşağıdaki seçenekleri göz önünde bulundurun:

Devre Dışı eklentisi Performans İzleme sizin ayıklama için derleme zamanında inşa
Kodunuzu modülarize da kurulu hızını optimize etmek

Senin modülü (uygulama düzeyinde) Gradle dosyası (genellikle de app/build.gradle ), Performans İzleme eklentisi uygulanır:

apply plugin: 'com.android.application'
apply plugin: 'com.google.gms.google-services'
// Apply the Performance Monitoring plugin
apply plugin: 'com.google.firebase.firebase-perf'

android {
  // ...
}

Kök düzeyinde (proje düzeyi) Gradle dosyası (In build.gradle ), Performans İzleme eklentisi içerecek şekilde kurallar ekleyin.

buildscript {

    repositories {
      // Check that you have the following line (if not, add it):
      google()  // Google's Maven repository
      // Add the Bintray repository
      jcenter()
    }

    dependencies {
      // ...

      // To benefit from the latest Performance Monitoring plugin features,
      // update your Android Gradle Plugin dependency to at least v3.4.0
      classpath 'com.android.tools.build:gradle:3.4.0'

      classpath 'com.google.gms:google-services:4.3.10'  // Google Services plugin

      // Add the dependency for the Performance Monitoring plugin
      classpath 'com.google.firebase:perf-plugin:1.4.0'  // Performance Monitoring plugin
    }
}

Uygulamanızı yeniden derleyin.

Aşama 3: ilk veri görüntü için oluşturmak performans etkinlikleri

Firebase, SDK'yı uygulamanıza başarıyla eklediğinizde olayları işlemeye başlar. Hâlâ yerel olarak geliştiriyorsanız, ilk veri toplama ve işleme için olaylar oluşturmak üzere uygulamanızla etkileşim kurun.

Uygulamanızı arka plan ve ön plan arasında birkaç kez değiştirerek, ekranlar arasında gezinerek uygulamanızla etkileşimde bulunarak ve/veya ağ isteklerini tetikleyerek olaylar oluşturun.
Git Performans pano Firebase konsolunun. Birkaç dakika içinde ilk veri görüntünüzü görmelisiniz.
Eğer ilk verilerin bir ekran görmüyorsanız, gözden giderme ipuçları .

Adım 4: Performans olaylar için (İsteğe bağlı) Günlüğü görüntüle mesajları

Performans bir ekleyerek yapı anda İzleme için hata ayıklama günlüğünü etkinleştirin <meta-data> uygulamanızın için eleman AndroidManifest.xml şöyle dosyanın:
```
<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.
Performans İzleme ile günlük iletilerini etiketleri FirebasePerformance . 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
Firebase konsolunda verilerinizi görüntülemek için URL'yi tıklayın. Verilerin kontrol panelinde güncellenmesi birkaç dakika sürebilir.

Uygulama performansı olaylarını günlüğe değilse, gözden giderme ipuçları .

Adım 5: (İsteğe bağlı) özel spesifik kod için izleme ekle

Şunları yapabilirsiniz enstrüman uygulamanızda belirli koduyla ilişkili performans verilerini izlemek için özel kod izleri .

Özel bir kod izlemeyle, uygulamanızın belirli bir görevi veya bir dizi görüntüyü yükleme veya veritabanınızı sorgulama gibi görevleri tamamlamasının ne kadar sürdüğünü ölçebilirsiniz. Özel kod izlemesi için 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 kod izlemenin başlangıcını ve sonunu tanımlarsınız (ve istediğiniz özel metrikleri eklersiniz). Android uygulamaları için, ayrıca kullanarak belirli yöntemlerin süresini izleyebilirsiniz @AddTrace ek açıklama .

Ziyaret özel kod için izleme ekleme daha bu özellikler ve nasıl uygulamanıza eklemek için hakkında bilgi edinmek için.

Adım 6: İnceleme sonuçları daha sonra dağıtma uygulama

Bir veya daha fazla test cihazı kullanarak Performans İzleme'yi doğruladıktan sonra, uygulamanızın güncellenmiş sürümünü kullanıcılarınıza dağıtabilirsiniz.

Sen performans verilerini izleyebilir Performans pano Firebase konsolunun.

Bilinen Sorunlar

Performance Monitoring Gradle eklentisi v1.1.0, Guava bağımlılıklarında uyumsuzluğa neden olarak 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, şunları yapabilirsiniz:

Performans İzleme eklentisini v1.1.1 veya sonraki bir sürümüne yükseltin (en son sürüm v1.4.0).

Kök düzeyinde (proje düzeyi) Gradle dosyası (içinde bağımlılık hattını eklentisi İzleme Performans değiştirin build.gradle aşağıdaki gibi):

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 başlığında ayarlanan değere dayalı olarak HTTP ağ istekleri için toplam yük boyutunu raporlar. Bu değer her zaman doğru olmayabilir.
Performans İzleme, yalnızca çok işlemli Android uygulamalarında ana işlemi destekler.

Sonraki adımlar

İnceleme çalıştırın ve GitHub üzerinde Android kod örneğini İzleme Performansı .
Performans İzleme tarafından otomatik olarak toplanan veriler hakkında daha fazla bilgi edinin:
- Veri gibi, uygulamanızın yaşam döngüsü ile ilgili uygulama başlangıç zamanı
- Veri ekranı render uygulamanızda
- Veri HTTP / ağ isteklerini S uygulamanıza tarafından verilen
Görünüm, parça ve filtre Firebase konsolunda performans verilerini.
Uygulamanıza olan belirli görevler veya iş akışları için izlenmesi ekle özel kod izlerini instrumenting .
Kullanım filtre performans verilerine bağlıyor .