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

Firebase Crashlytics ve Android Vitals'tan gelen uygulama kilitlenme verilerini doğrudan Android Studio'da görebilir ve bunlarla ilgili işlem yapabilirsiniz. Bu entegrasyon, Crashlytics ve Google Play'deki yığın izleme verilerini ve kilitlenme istatistiklerini Studio IDE'deki Uygulama Kalitesi Analizleri araç penceresine getirir. Böylece, tarayıcınız ile IDE arasında gidip gelmek zorunda kalmazsınız. Geliştirme ekipleri aşağıdakiler gibi temel özelliklerden yararlanabilir:

  • İlgili Crashlytics etkinlik verileri içeren kod satırlarının vurgulandığını görebilirsiniz.
  • En çok kilitlenmeyle ilgili yığın izlemeyi inceleyin ve kodunuzdaki ilgili satırlara atlamak için yığın izlemeyi tıklayın.
  • En fazla kilitlenme ve önemli olmayan etkinliklerle ilgili özet istatistikleri (ör. cihaz üreticisine ve Android sürümüne göre gruplandırılmış) görebilirsiniz.
  • Etkinlikleri önem derecesi, zaman ve uygulama sürümü gibi özelliklere göre filtreleyin.
  • Etkinlikle ilgili daha fazla ayrıntının yer aldığı 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 elde edin.

Android Vitals raporları, Google Play'de yayınlanan tüm uygulamalar tarafından kullanılabilir. Henüz Crashlytics kullanmıyorsanız ve sunduğu özellikler hakkında daha fazla bilgi edinmek istiyorsanız Firebase Crashlytics başlıklı makaleyi inceleyin.

Başlayın

Android Studio'da Crashlytics verilerini görmek için uygulama projenizde Firebase ve Crashlytics'i ayarlamanız gerekir. Bunu yapmak için Araçlar > Firebase'e giderek Android Studio'da Firebase Asistanı'nı açın, Crashlytics'i tıklayın ve ardından Firebase ile Crashlytics'i projenize eklemek için eğitimdeki talimatları uygulayın. Firebase'in Android için başlangıç kılavuzunda Firebase Asistanı iş akışı hakkında daha fazla bilgi edinebilirsiniz.

Firebase ve Crashlytics'i uygulamanıza zaten 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. Panellerin Crashlytics'ten alınan raporlarla doldurulduğunu görürsünüz.

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'deki uygulamanızın kalitesini iyileştirmek için uygulama kararlılığıyla ilgili sorunları gidermek üzere Android vitals'ı kullanın.

Android Studio'daki Android vitals verileri.

Android vitals sorunlarını görüntüleyebilir, filtreleyebilir ve yığın izlemeden koda atlayabilirsiniz. Tüm bunları Uygulama Kalitesi Analizleri araç penceresinden yapabilirsiniz. Başlamak için aşağıdaki 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 veya Görünüm > Araç Pencereleri > Uygulama Kalitesi Analizleri'ni tıklayarak Uygulama Kalitesi Analizleri'ni açın.
  3. Uygulama Kalitesi Analizleri'ndeki Android vitals sekmesini tıklayın.
  4. İsteğe bağlı: Hata ayıklama yapılabilir bir derleme için sürüm denetimi entegrasyonunu kullanmak üzere en son Firebase Crashlytics SDK'sını (veya Firebase Android Bileşen Listesi'ni) uygulamanıza ekleyin. Ardından, aşağıdaki kodu modül düzeyindeki build.gradle.kts veya build.gradle dosyasına ekleyin. Sürüm (hata ayıklama yapılamayan) derlemelerde bu işaret varsayılan olarak etkindir.

Kotlin

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

Groovy

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

Uygulama Kalitesi Analizleri araç penceresinde, kullanıcılarınızın karşılaştığı etkinliklerle ilgili analizler sağlayan 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ünde çalışırken kullanıcılarınızın yüklediği uygulamanızın üretim sürümüne ait etkinlik verilerini görmek isteyebilirsiniz.
  2. Sorunlar panelinde, Crashlytics'in verileri olan en başarılı etkinlikler gösterilir 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, kilitlenmelerin temel nedenlerini belirlemenize yardımcı olur.
  4. Yığın izleme sekmesinde, Sorunlar panelinde tıkladığınız etkinliğin en son gerçekleşmesiyle ilgili ayrıntılar gösterilir. Etkinliğin yığın izlemesini görebilir ve kod tabanınızdaki ilgili satırlara atlamak için yığın izlemeyi tıklayabilirsiniz. Kilitlenme oluştuktan sonra kodunuz değiştiyse mevcut kodunuz ile kod tabanınızın kilitlenmeye neden olan sürümü arasındaki farkı görüntülemek için yığın izlemedeki hatanın yanındaki fark göster'i tıklayın.

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

    Etkilenen cihaz türü, Android sürümü ve etkinliğin gerçekleştiği zaman hakkında bilginin yanı sıra Firebase Crashlytics kontrol panelinde etkinliğin bağlantısı da yer alır. Bir gruptaki birden fazla etkinliğin bilgilerine göz atmak için sol ve sağ okları kullanın. Bir sorunu doğrudan panelden kapatmak için Sorunu kapat'ı tıklayın.

  5. Anahtarlar ve Günlükler sekmeleri, her bir Crashlytics raporu için özel anahtar/değer çiftlerini ve günlükleri gösterir.
  6. Ayrıntılar panelinde kilitlenme sayıları cihaz türüne ve Android sürümüne göre ayrılır. Böylece, en çok etkilenen kullanıcı gruplarını belirleyebilirsiniz. Ayrıca, kilitlenmenin hangi uygulama sürümlerinde yaşandığını ve etkilenen kullanıcıların sayısını da gösterir.
  7. Sorunları okuyup notları Firebase konsolunda ve takım arkadaşlarınıza görünür olacak şekilde ekleyin. Bir sorunla ilgili not yazmak için sorunu seçin ve Notlar panelini açın. Not yazmak için Crashlytics projesinde yazma iznine sahip olmanız gerekir. Notlarla ilgili sorunlar, Sorunlar panelinde "notlar" simgesiyle gösterilir.
    Uygulama Kalitesi Analizleri Notlar paneli.
  8. Belirli etkinlik alt kümelerine odaklanmak için çeşitli filtreleri kullanın. Kritik , Kritik Olmayan ve ANR'ler olan etkinlikleri seçebilir veya seçimini kaldırabilir, ayrıca zamana, uygulama sürümüne, Crashlytics sinyaline, cihaz markasına ve modeline ve Android platform sürümüne göre filtreleme yapabilirsiniz. Crashlytics sinyal durumlarında, geçmişte kapatılmış ve uygulamanın yeni bir sürümünde tekrar ortaya çıkmış bir sorunun gerilediği kabul edilir.

Yığın izlemeden koda gidebilir, koddan da yığın izlemeye atlayabilirsiniz: Android Studio artık kilitlenmelerle ilgili kod satırlarını kilitlenme kenar simgesiyle ekler. Böylece, kilitlenmeleri kolayca tespit edebilir ve hata ayıklayabilirsiniz.

Fareyle kilitlenme simgesinin üzerine geldiğinizde, bu kod satırını içeren kaç etkinliğin olduğunu ve etkinlik sıklıklarını gösteren bir pop-up gösterilir.

Fareyle kilitlenme simgesinin üzerine geldiğinizde gösterilen etkinlik özeti

Belirli bir etkinlikten etkilenen kullanıcıların sayısı ve etkinliğin sıklığı da dahil olmak üzere daha ayrıntılı bir etkinlik 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 ile Crashlytics arasındaki farklı sayılar

Android vitals ve Crashlytics'in, aynı kilitlenmeyle ilişkili kullanıcı ve etkinlik sayıları için farklı değerler bildirebileceğini unutmayın. Bu tutarsızlıklar, Play ve Crashlytics'in kilitlenmeleri farklı zamanlarda ve farklı kullanıcılar için yakalayabilmesinden kaynaklanır. Play ve Crashlytics sayılarının farklı olmasının birkaç nedeni aşağıda açıklanmıştır:

  • Play, kilitlenmeleri önyükleme zamanından itibaren yakalar. Crashlytics ise Crashlytics SDK'sı ilk kullanıma hazırlandıktan sonra gerçekleşen kilitlenmeleri yakalar.
  • Kullanıcı yeni bir telefon aldığında kilitlenme raporlamayı devre dışı bırakırsa bu kilitlenmeler Play'e bildirilmez. Ancak Crashlytics, kilitlenmeleri uygulamanın kendi gizlilik politikasına göre yakalar.

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

Örneğin, Yenile'yi tıklayarak yeni bir istek gönderirseniz 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ınmış verilerden sorunları ve en son etkinlikleri incelemeye devam edebilirsiniz. Bazı filtre seçeneklerini değiştirme veya sorunları kapatma gibi belirli işlevler kullanılamaz. Crashlytics'e bağlantınızı yeniden denemek ve çevrimiçi duruma dönmek için Yeniden bağlan tıklayın.