Uygulama Kalitesi Analizleri ile Firebase Crashlytics ve Android Vitals'taki sorunları analiz edin

Firebase Crashlytics ve Android Vitals'daki uygulama kilitlenme verilerini doğrudan Android Studio'da görebilir ve bunlarla ilgili işlem yapabilirsiniz. Bu entegrasyon, yığın izleme verilerini ve kilitlenme istatistiklerini Crashlytics ve Google Play'den Studio IDE'deki Uygulama Kalitesi Analizleri aracı penceresine çeker. Böylece tarayıcımız ile IDE arasında geçiş yapmanız gerekmez. Geliştirme ekipleri, aşağıdakiler de dahil olmak üzere temel özelliklerden yararlanabilir:

  • Kodunuzda, alakalı Crashlytics etkinlik verileri bulunan satırların vurgulandığını görün.
  • En sık karşılaşılan kilitlenmelere ilişkin yığın izlemeye bakın ve kodunuzdaki ilgili satırlara atlamak için yığın izlemeyi tıklayın.
  • En sık karşılaşılan kilitlenme ve önemli olmayan etkinliklerle ilgili (ör. cihaz üreticisi ve Android sürümüne göre gruplanmış) ilgili özet istatistikleri görebilirsiniz.
  • Etkinlikleri önem düzeyi, zaman ve uygulama sürümü gibi özelliklere göre filtreleyin.
  • Etkinlikle ilgili daha fazla ayrıntı içeren Crashlytics kontrol paneli sayfasını açan bir tarayıcı bağlantısı alın.
  • Belirli sorunların temel nedenlerini daha kolay anlamanıza ve çözmenize yardımcı olacak analizler alın.

Android Vitals raporları, Google Play'de yayınlanan tüm uygulamalarda kullanılabilir. Henüz Crashlytics'i kullanmıyorsanız ve çözümleri hakkında daha fazla bilgi edinmek istiyorsanız Firebase Crashlytics'i inceleyin.

Başlayın

Android Studio'da Crashlytics verilerini görmek için uygulama projenizde Firebase ve Crashlytics'i kurmanız gerekir. Bunu şu şekilde yapabilirsiniz: Android Studio'da Araçlar > Firebase'e giderek Firebase Asistanı'nı açın, Crashlytics'i tıklayın ve Firebase ve Crashlytics'i projenize eklemek için eğiticideki adımları uygulayın. Firebase'in Android için başlangıç kılavuzundan Firebase Asistan iş akışı hakkında daha fazla bilgi edinebilirsiniz.

Firebase ve Crashlytics'i uygulamanıza daha önce eklediyseniz IDE'de avatar simgesini tıklayarak Geliştirici hesabınızda oturum açın. Oturum açtıktan sonra Uygulama Kalitesi Analizleri araç penceresini tıklayın. Sorunlar, Örnek Yığın İzleme ve Ayrıntılar panellerinin Crashlytics'ten gelen raporlarla doldurulduğunu göreceksiniz.

Android vitals'ı analiz etme

Uygulama Kalitesi Analizleri, Android vitals verilerini içerir. Bu sayede, Google Play tarafından toplanan temel metriklere daha kolay erişebilir ve kullanıcı deneyiminizi iyileştirebilirsiniz. Google Play'de uygulamanızın kalitesini iyileştirmeye yardımcı olmak için uygulama kararlılığıyla ilgili sorunları gidermek amacıyla Android vitals'ı kullanın.

Android Studio'da Android vitals verileri.

Uygulama Kalitesi Analizleri araç penceresinden Android vitals sorunlarını görüntüleyebilir, filtreleyebilir ve yığın izlemeden kodlamaya geçebilirsiniz. Başlamak için şu adımları uygulayın:

  1. Araç çubuğunun sonundaki profil simgesini kullanarak Android Studio'da geliştirici hesabınızda oturum açın.
  2. Android Studio'daki araç penceresini tıklayarak veya Görünüm > Araç Pencereleri > Uygulama Kalitesi Analizleri'ni tıklayarak Uygulama Kalitesi Analizleri'ni açın.
  3. Uygulama Kalitesi Analizleri'nde Android vitals sekmesini tıklayın.
  4. İsteğe bağlı: Hata ayıklaması yapılabilir bir derlemede sürüm kontrolü entegrasyonunu kullanmak için Firebase Crashlytics SDK'nın en son sürümünü (veya Firebase Android Malzeme Listesi) uygulamanıza ekleyin. Ardından aşağıdaki kodu modül düzeyindeki build.gradle.kts ya da build.gradle dosyasına ekleyin. Yayın (hata ayıklaması mümkün olmayan) derlemelerde bayrak varsayılan olarak etkindir.

Kotlin

android {
  buildTypes {
    getByName("debug") {
      vcsInfo {
        include = true
      }
    }
  }
}

Modern

android {
  buildTypes {
    debug {
      vcsInfo {
        include true
      }
    }
  }
}

Uygulama Kalitesi Analizleri araç penceresinde, kullanıcılarınızın karşılaştığı etkinlikler hakkında bilgi veren zengin veriler ve bu etkinliklerin kaynaklarına hızlıca gitmenize yardımcı olacak bağlantılar bulunur.

Uygulama Kalitesi Analizleri araç penceresi

  1. Analiz etmek istediğiniz uygulama kimliğini seçmek için uygulama kimliği açılır menüsünü kullanın. Örneğin, IDE'de uygulamanızın hata ayıklama sürümü üzerinde çalışırken, uygulamanızın kullanıcılarınızın yüklediği üretim sürümüne ait etkinlik verilerini görmek isteyebilirsiniz.
  2. Sorunlar paneli, Crashlytics'in veri sahibi olduğu en sık gerçekleşen etkinlikleri gösterir ve en çok etki eden kilitlenmelerinize göre sıralanır.
  3. Etkinlikleri, varyantlara veya benzer yığın izlemelere sahip etkinlik gruplarına göre görüntüleyin. Etkinlikleri varyanta göre analiz etmek, kilitlenmenin temel nedenlerini belirlemenize yardımcı olur.
  4. Yığın izleme (stack trace) içeren panelde, Sorunlar panelini tıkladığınız etkinliğin en son gerçekleştiği yer hakkında ayrıntılar gösterilir. Etkinliğin yığın izlemeyi (stack trace) görebilir ve yığın izlemeyi tıklayarak kod tabanınızdaki ilgili satırlara atlayabilirsiniz. Kodunuz, kilitlenmenin meydana gelmesinden bu yana değiştiyse geçerli kodunuz ile kilitlenmeyi oluşturan kod tabanınızın sürümü arasındaki farkı görmek için yığın izlemedeki hatanın yanında bulunan farkı göster'i tıklayın.

    HKİ yığın izlemede farkı gösterme seçeneği.

    Ayrıca, etkilenen cihaz türü, cihazın Android sürümü ve etkinliğin gerçekleştiği saat ile ilgili bilgilerin yanı sıra Firebase Crashlytics kontrol panelindeki etkinliğin bağlantısı da bulunur. Bir sorunu doğrudan panelden kapatmak için Kapat düğmesini tıklayın.

  5. Ayrıntılar paneli, kilitlenme sayılarını cihaz türüne ve Android sürümüne göre ayırır. Böylece en çok hangi kullanıcı gruplarının etkilendiğini belirleyebilirsiniz. Raporda, kilitlenmeyle karşılaşan uygulama sürümleri ve etkilenen kullanıcı sayısı da gösterilir.
  6. Sorunların Firebase konsolunda ve ekip arkadaşlarınızda görünür olması için sorunları okuyun ve bunlara not ekleyin. Bir sorunla ilgili not yazmak için sorunu seçin ve Notlar panelini açın. Not yazabilmek için Crashlytics projesine yazma izninizin olması gerekir. Notlarla ilgili sorunlar, Sorunlar panelinde "notlar" simgesiyle görünür.
    Uygulama Kalitesi Analizleri Notları panelini açın.
  7. Belirli etkinlik alt kümelerine odaklanmak için çeşitli filtrelerden yararlanın. Önemli veya Önemli Olmayan etkinlikleri seçebilir ya da seçimlerini kaldırabilir, zamana, uygulama sürümüne, Crashlytics Sinyali'ne, cihaz markası ve modeline ve Android platform sürümüne göre filtreleme yapabilirsiniz. Crashlytics Sinyalsi durumları söz konusu olduğunda, geçmişte kapatılan ve uygulamanın yeni bir sürümünde yeniden ortaya çıkan sorunlar geri çekilmiş olarak kabul edilir.

Yığın izlemeden koda gitmenin yanı sıra, koddan yığın izlemeye de atlayabilirsiniz. Android Studio, artık kilitlenmelerle ilgili kod satırlarına bir kilitlenme oluğu simgesi eklenerek bunları kolayca tespit edip hata ayıklamanızı sağlar.

Fareyle kilitlenme simgesinin üzerine geldiğinizde, bu kod satırını içeren etkinlik sayısını ve etkinlik sıklıklarını gösteren bir pop-up açılır.

Fareyle kilitlenme simgesinin üzerine geldiğinizde etkinlik özeti

Belirli bir etkinlikten etkilenen kullanıcıların sıklığı ve sayısı da dahil olmak üzere etkinliklerin daha ayrıntılı bir listesi için kilitlenme simgesini tıklayın. Uygulama Kalitesi Analizleri araç penceresindeki etkinlik ayrıntılarına gitmek için belirli bir etkinliği tıklayın.

Kilitlenme simgesini tıkladığınızda etkinlik listesi

Android vitals ve Crashlytics arasındaki farklı sayılar

Android vitals ve Crashlytics'in, aynı kilitlenmeyle ilişkilendirilen kullanıcı ve etkinlik sayısı için farklı değerler rapor edebileceğini unutmayın. Bu tutarsızlıklar, Play ve Crashlytics'in farklı zamanlarda ve farklı kullanıcılar için kilitlenmeleri yakalayabilmesinden kaynaklanır. Play ve Crashlytics sayılarının farklı olmasına yol açabilecek birkaç nedeni aşağıda bulabilirsiniz:

  • Play, kilitlenmeleri başlatma zamanından itibaren yakalarken Crashlytics, Crashlytics SDK başlatıldıktan sonra meydana gelen kilitlenmeleri yakalar.
  • Bir kullanıcı yeni telefon aldığında kilitlenme raporu özelliğini devre dışı bırakırsa bu kilitlenmeler Play'e bildirilmez. Ancak Crashlytics, kilitlenmeleri bir uygulamanın kendi gizlilik politikasına göre yakalar.

Çevrimdışıyken sınırlı işlevlerle inceleme yapın

Örneğin Yenile'yi tıklayarak yeni bir istekte bulunursanız ve Android Studio Crashlytics ile iletişim kuramazsa Uygulama Kalitesi Analizleri penceresi Çevrimdışı Mod'a girmenize olanak tanır.

Uygulama Kalitesi Analizleri, çevrimdışı mod sunar.

Bu moddayken, önbelleğe alınan verilerdeki sorunları ve en son etkinlikleri araştırmaya devam edebilirsiniz. Bazı filtre seçeneklerini değiştirme veya kapatma sorunları gibi belirli işlevler kullanılamaz. Crashlytics'e bağlanmayı tekrar denemek ve online duruma dönmek için Yeniden bağlan'ı tıklayın.

Çevrimdışı modda Uygulama Kalitesi Analizleri yeniden bağlanma seçeneği.