Men-deobfuscate atau melakukan simbolisasi pelacakan tumpukan error

Untuk men-deobfuscate pelacakan tumpukan Java, Anda harus membuat file pemetaan ProGuard terlebih dahulu. Untuk mempelajari caranya, buka situs Google Developers.

Versi plugin Android Gradle 4.1 dan yang lebih baru

Jika project Anda mem-build Android App Bundle, Anda dapat secara otomatis menyertakan file simbol debug di dalamnya. Untuk menyertakan file ini, tambahkan kode berikut ke file build.gradle aplikasi Anda:

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

Catatan: Batas untuk file simbol debug adalah 800 MB. Jika jejak simbol debug terlalu besar, gunakan SYMBOL_TABLE bukan FULL untuk mengurangi ukuran file.

Jika project Anda mem-build APK, gunakan setelan build build.gradle di atas untuk membuat file simbol debug secara terpisah. Upload file simbol debug secara manual ke Konsol Google Play seperti yang dijelaskan di bawah pada Langkah 2: Upload file deobfuscation atau simbolisasi. Sebagai bagian dari proses build, plugin Android Gradle akan menampilkan file ini pada lokasi project berikut:

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

Versi plugin Android Gradle 4.0 dan yang lebih lama (dan sistem build lainnya)

Sebagai bagian dari proses build untuk app bundle atau APK, plugin Android Gradle menyimpan salinan library simbolik dalam direktori project. Direktori ini mengikuti struktur yang mirip dengan hal berikut:

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

Catatan: Jika menggunakan sistem build yang berbeda, Anda dapat memodifikasinya untuk menyimpan library simbolik dalam direktori dengan struktur yang diperlukan di atas.

1. Gunakan konten direktori ini:
   • $ cd app/build/intermediates/cmake/universal/release/obj
   • $ zip -r symbols.zip .
2. Upload file symbols.zip ke Konsol Play secara manual seperti yang dijelaskan di bawah pada Langkah 2: Upload file deobfuscation atau simbolisasi.

Batas ukuran file simbol debug adalah 800 MB. Jika file terlalu besar, kemungkinan karena file .so Anda berisi tabel simbol (nama fungsi), juga info proses debug DWARF (nama file dan baris kode). Ini tidak diperlukan untuk melakukan simbolisasi pada kode Anda dan dapat dihapus dengan menjalankan perintah ini:

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

Catatan: $OBJCOPY mengarah ke versi spesifik untuk ABI yang Anda stripping, misalnya:ndk-bundle/toolchains/aarch64-linux-android-4.9/prebuilt/linux-x86_64/bin/aarch64-linux-android-objcopy

Untuk mengupload file simbolisasi atau deobfuscation:

1. Buka Konsol Play.
2. Pilih aplikasi.
3. Di menu kiri, pilih Uji dan rilis > Penjelajah app bundle.
4. Dengan alat pilih di pojok kanan atas, pilih artefak yang relevan.
5. Pilih tab Download, lalu scroll ke bawah ke bagian "Aset".
6. Klik panah upload untuk file pemetaan atau simbol debug sebagaimana yang berlaku guna mengupload file deobfuscation atau simbolisasi untuk versi aplikasi Anda.

Untuk mengupload file menggunakan Google Play Developer API, kunjungi situs Google Developers.

Konsol Play menggunakan ndk-stack untuk menyimbolkan stack trace untuk aplikasi native dan ReTrace untuk error Java. Jika Anda memilih untuk tidak membagikan file deobfuscation, Anda dapat menyalin tumpukan error yang di-deobfuscate dari Konsol Play dan menggunakan alat yang sesuai secara offline untuk menyimbolkannya. Namun, proses ini harus dilakukan secara manual untuk setiap tumpukan error, sehingga proses menjadi lambat dan memakan waktu. Dengan menyediakan file deobfuscation, Konsol Play akan menangani masalah ini untuk Anda.

Setelah mengupload file pemetaan ProGuard atau file simbol debug untuk versi aplikasi Anda, hanya error dan ANR yang terjadi setelahnya yang akan di-deobfuscate. Anda harus memberikan waktu agar error dan ANR yang baru dapat dilaporkan oleh perangkat pengguna sebelum Anda melihat error dan ANR yang di-deobfuscate di Konsol Play.

Hal ini disebabkan oleh upload file deobfuscation/simbolisasi yang tidak lengkap. Pastikan Anda menyertakan file simbolisasi untuk seluruh aplikasi, terutama jika Anda menggunakan proses build yang kompleks atau multi-tahap. Salah satu alasan paling umum untuk deobfuscation sebagian adalah jika Anda menggunakan library pihak ketiga. Dalam hal ini, Anda mungkin bisa mendapatkan file deobfuscation dari penyedia library.

Tanpa file deobfuscation, error atau ANR yang sama pada perangkat 32-bit dan 64-bit atau perangkat ARM dan Intel akan ditampilkan secara terpisah. Dengan menyediakan file deobfuscation, kami dapat mengelompokkan error ini bersama-sama, sehingga memberikan Anda perspektif yang lebih baik tentang error dan ANR yang paling berpengaruh untuk aplikasi Anda.

Jika Anda lupa mengupload file untuk versi aplikasi yang baru, error dan ANR akan kembali di-obfuscate. Ikuti petunjuk di atas untuk menguploadnya sekarang. Setelah mengupload file pemetaan ProGuard atau file simbol debug untuk versi aplikasi Anda, hanya error dan ANR yang terjadi setelahnya yang akan di-deobfuscate. Anda harus memberikan waktu agar error dan ANR yang baru dapat dilaporkan oleh perangkat pengguna sebelum Anda melihat error dan ANR yang di-deobfuscate di Konsol Play.

Untuk menghindari risiko lupa mengupload file, pertimbangkan untuk mengubah proses build agar menggunakan app bundle dengan plugin Android Gradle versi 4.1 atau yang lebih baru. Dalam hal ini, Anda dapat secara otomatis menyertakan file simbol debug dalam app bundle dengan mengikuti petunjuk di situs Developer Android.

Jika Anda mengupload file yang salah untuk versi aplikasi, error dan ANR akan kembali di-obfuscate. Untuk mengupload versi yang dikoreksi:

1. Buka Konsol Play.
2. Pilih aplikasi.
3. Di menu kiri, pilih Uji dan rilis > Penjelajah app bundle
4. Dengan alat pilih di pojok kanan atas, pilih artefak yang relevan.
5. Pilih tab Download, lalu scroll ke bawah ke bagian "Aset".
6. Klik ikon hapus di samping file deobfuscation atau simbolisasi yang salah.
7. Setelah versi yang salah dihapus, klik ikon upload lalu upload file yang benar untuk versi aplikasi Anda.

Setelah mengupload file pemetaan ProGuard atau file simbol debug yang benar untuk versi aplikasi Anda, hanya error dan ANR yang terjadi setelahnya yang akan di-deobfuscate. Anda harus memberikan waktu agar error dan ANR yang baru dapat dilaporkan oleh perangkat pengguna sebelum Anda melihat error dan ANR yang di-deobfuscate di Konsol Play.

Tips: Guna menghindari risiko mengupload versi file yang salah, pertimbangkan untuk mengubah proses build agar menggunakan app bundle dengan plugin Android Gradle versi 4.1 atau lebih baru. Dalam hal ini, Anda dapat secara otomatis menyertakan file simbol debug dalam app bundle dengan mengikuti petunjuk di situs Developer Android.

Kunjungi situs Developer Android untuk memulai.

Ya.

Terkadang, sistem menemukan ANR, tetapi tidak dapat mengumpulkan pelacakan tumpukan. Dalam hal ini, ANR ditampilkan untuk memberi Anda gambaran yang lebih lengkap tentang stabilitas aplikasi, tetapi pelacakan tumpukan itu sendiri tidak dapat ditampilkan. ANR tanpa pelacakan tumpukan dikelompokkan berdasarkan jenis dan aktivitas, sehingga meninjau dan memperbaiki ANR serupa dapat membantu mengurangi jumlah ANR tanpa pelacakan tumpukan.