Kilitlenmeyle sonuçlanan yığın izlemelerin kodunu gösterme veya simgeselleştirme

Java yığın izlemelerin (stack trace) kodunu göstermek için önce bir ProGuard eşleme dosyası oluşturmanız gerekir. Bunu nasıl yapacağınızı öğrenmek için Google Developers sitesine gidin.

Android Gradle eklentisi 4.1 ve sonraki sürümleri

Projeniz Android App Bundle derliyorsa hata ayıklama simgeleri dosyasını otomatik olarak buna ekleyebilirsiniz. Bu dosyayı dahil etmek için uygulamanızın build.gradle dosyasına şunu ekleyin:

• android.defaultConfig.ndk.debugSymbolLevel = 'FULL'

Not: Hata simgeselleştirme dosyasının boyutu en fazla 800 MB olabilir. Hata ayıklama simgeleri dosyasının boyutu çok büyükse küçültmek için FULL yerine SYMBOL_TABLE işlevini kullanın.

Projeniz APK derliyorsa hata ayıklama simgeleri dosyasını ayrı olarak oluşturmak için yukarıdaki build.gradle derleme ayarını kullanın. Hata ayıklama simgeleri dosyasını Google Play Console'a aşağıdaki 2. Adım: Kod gösterme veya simgeselleştirme dosyası yükleme bölümünde açıklandığı şekilde manuel olarak yükleyin. Android Gradle eklentisi, derleme işleminin bir parçası olarak bu dosyayı aşağıdaki proje konumuna çıkarır:

• app/build/outputs/native-debug-symbols/variant-name/native-debug-symbols.zip

Android Gradle eklentisi 4.0 ve önceki sürümler (ayrıca diğer derleme sistemleri)

Android Gradle eklentisi bir uygulama paketi veya APK için derleme işlemi kapsamında, sadeleştirilmemiş kitaplıkların kopyasını proje dizininde saklar. Bu dizin şuna benzer bir yapıya sahiptir:

app/build/intermediates/cmake/universal/release/obj

├── armeabi-v7a/

│   ├── libgamenegine.so

│   ├── libothercode.so

│   └── libvideocodec.so

├── arm64-v8a/

│   ├── libgamenegine.so

│   ├── libothercode.so

│   └── libvideocodec.so

├── x86/

│   ├── libgamenegine.so

│   ├── libothercode.so

│   └── libvideocodec.so

└── x86_64/

    ├── libgameengine.so

    ├── libothercode.so

    └── libvideocodec.so

Not: Farklı bir derleme sistemi kullanıyorsanız dizinin yapısını, sadeleştirilmemiş kitaplıkları yukarıdaki gerekli yapıya sahip bir dizinde depolayacak şekilde değiştirebilirsiniz.

1. Bu dizinin içeriğini zip dosyası olarak kaydedin:
   • $ cd app/build/intermediates/cmake/universal/release/obj
   • $ zip -r symbols.zip .
2. Symbols.zip dosyasını Google Play Console'a aşağıdaki 2. adım: Kod gösterme veya simgeselleştirme dosyası yükleme bölümünde açıklandığı şekilde manuel olarak yükleyin.

Hata simgeselleştirme dosyasının boyutu en fazla 800 MB olabilir. Dosyanız çok büyükse bunun nedeni büyük olasılıkla .so dosyalarınızın hem simge tablosu (işlev adları) hem de DWARF hata ayıklama bilgilerini (dosya adları ve kod satırları) içermesidir. Bunlar, kodunuzu simgeselleştirmek için gerekli değildir ve şu komut çalıştırılarak kaldırılabilir:

• $OBJCOPY --strip-debug lib.so lib.so.sym

Not: $OBJCOPY, sadeleştirdiğiniz ABI için belirli bir sürümü işaret eder. Örneğin: ndk-bundle/toolchains/aarch64-linux-android-4.9/prebuilt/linux-x86_64/bin/aarch64-linux-android-objcopy

Kod gösterme veya simgeselleştirme dosyası yüklemek için:

1. Play Console'u açın.
2. Bir uygulama seçin.
3. Soldaki menüde Test edin ve yayınlayın > Uygulama paketi gezgini'ni seçin.
4. Sağ üst köşedeki seçiciyi kullanarak ilgili yapıyı seçin.
5. İndirilenler sekmesini seçip "Öğeler" bölümüne gidin.
6. Uygulamanızın ilgili sürümüne ait kod gösterme veya simgeselleştirme dosyasını yüklemek üzere uygun olan eşleme dosyası veya hata ayıklama simgeleri için yukarı oku tıklayın.

Dosyaları Google Play Geliştirici API'sini kullanarak yüklemek için Google Developers sitesine gidin.

Play Console, yerel uygulamalarda yığın izlemeleri (stack trace) simgeleştirmek için ndk-Stack ve Java kilitlenmeleri için ReTrace araçlarını kullanır. Kod gösterme dosyalarınızı paylaşmamayı seçerseniz, kodu karartılmış olan kilitlenmeyle sonuçlanan yığın izlemeleri Play Console'dan kopyalayıp bunları çevrimdışı simgeselleştirmek için uygun aracı kullanabilirsiniz. Ancak, bu işlem her kilitlenme yığını için manuel olarak yapılmalıdır. Bu da yavaş ve zaman alan bir süreçtir. Kod gösterme dosyalarınızı paylaşarak bu işi Play Console'un yapmasını sağlayabilirsiniz.

Uygulamanızın bir sürümü için ProGuard eşleme dosyası veya hata ayıklama simgeleri dosyası yüklediğinizde, yalnızca bu dosya yüklendikten sonra oluşan kilitlenme ve ANR'lerin kodu gösterilir. Kodu gösterilen kilitlenmeleri ve ANR'leri Play Console'da görmeden önce kullanıcı cihazlarının yeni kilitlenmeleri ve ANR'leri bildirmesi için belli bir süre beklemeniz gerekir.

Bu, eksik kod gösterme/simgeselleştirme dosyası yüklemekten kaynaklanır. Özellikle karmaşık veya çok aşamalı bir derleme işlemi kullanıyorsanız uygulamanızın tamamı için simgeselleştirme dosyaları eklediğinizden emin olun. Kısmi kod göstermenin en yaygın nedenlerinden biri, üçüncü taraf kitaplığı kullanılmasıdır. Bu durumda, kod gösterme dosyalarını kitaplık sağlayıcısından alabilirsiniz.

Kod gösterme dosyaları olmadan, ANR, 32 bit ve 64 bit bir cihazdaki veya ANR ya da Intel cihazındaki aynı kilitlenme ayrı gösterilir. Kod gösterme dosyaları sağlayarak, bu kilitlenmeleri bir kümede toplayıp uygulamanız için en etkili kilitlenmeler ve ANR'ler hakkında daha iyi bir bakış açısı sunabiliriz.

Dosyayı uygulamanızın yeni bir sürümü için yüklemeyi unutursanız kilitlenmeler ve ANR'ler kodları karartılmış hale döner. Şimdi yüklemek için yukarıdaki talimatları uygulayın. Uygulamanızın bir sürümü için ProGuard eşleme dosyası veya hata ayıklama simgeleri dosyası yüklediğinizde, yalnızca bu dosya yüklendikten sonra oluşan kilitlenme ve ANR'lerin kodu gösterilir. Kodu gösterilen kilitlenmeleri ve ANR'leri Play Console'da görmeden önce kullanıcı cihazlarının yeni kilitlenmeleri ve ANR'leri bildirmesi için belli bir süre beklemeniz gerekir.

Dosyayı yüklemeyi unutma riskini önlemek için derleme sürecinizi, Android Gradle eklentisi 4.1 veya sonraki bir sürümüne sahip uygulama paketleri kullanacak şekilde değiştirmeyi düşünün. Bu durumda, Android Geliştiricileri sitesindeki talimatları uygulayarak hata ayıklama simgeleri dosyasını uygulama paketine otomatik olarak ekleyebilirsiniz.

Uygulamanızın bir sürümü için yanlış dosyayı yüklerseniz kilitlenmeler ve ANR'ler kodları karartılmış hale döner. Düzeltilmiş sürümü yüklemek için:

1. Play Console'u açın.
2. Bir uygulama seçin.
3. Soldaki menüde Test edin ve yayınlayın > Uygulama paketi gezgini'ni seçin
4. Sağ üst köşedeki seçiciyi kullanarak ilgili yapıyı seçin.
5. İndirilenler sekmesini seçip "Öğeler" bölümüne gidin.
6. Yanlış kod gösterme veya simgeselleştirme dosyasının yanındaki sil simgesini tıklayın.
7. Yanlış sürüm silindikten sonra, yükleme simgesini tıklayıp uygulamanızın sürümü için doğru dosyayı yükleyin.

Uygulamanızın bir sürümü için ProGuard eşleme dosyası veya hata ayıklama simgeleri dosyası yükledikten sonra, yalnızca bu dosya yüklendikten sonra oluşan kilitlenme ve ANR'lerin kodu gösterilir. Kodu gösterilen kilitlenmeler ve ANR'leri Play Console'da görmeden önce kullanıcı cihazlarının yeni kilitlenmeleri ve ANR'leri bildirmesi için belli bir süre beklemeniz gerekir.

İpucu: Dosyanın yanlış sürümünü yükleme riskini önlemek için derleme sürecinizi, Android Gradle eklentisi 4.1 veya sonraki bir sürümüne sahip uygulama paketleri kullanacak şekilde değiştirmeyi düşünün. Bu durumda, Android Geliştiricileri sitesindeki talimatları uygulayarak hata ayıklama simgeleri dosyasını uygulama paketine otomatik olarak ekleyebilirsiniz.

Başlamak için Android Geliştiricileri sitesini ziyaret edin.

Evet.

Bazen sistem bir ANR ile karşılaşır ancak yığın izleme (stack trace) hakkında bilgi toplayamaz. Bu durumda, uygulamanızın kararlılığı hakkında daha kapsamlı bir değerlendirme sunabilmek için ANR gösterilir ancak ilgili yığın izleme gösterilemez. Yığın izleme içermeyen ANR'ler, tür ve etkinlik bazında gruplanır. Dolayısıyla benzer ANR'leri inceleyip düzeltmek, yığın izleme içermeyen ANR sayısını azaltmanıza yardımcı olabilir.