โดยค่าเริ่มต้น ระบบจะตัดไลบรารีโค้ดแบบเนทีฟในบิลด์ที่เผยแพร่ของแอปออก การตัดนี้ประกอบด้วยการนำตารางสัญลักษณ์และข้อมูลการแก้ไขข้อบกพร่องที่มีอยู่ในไลบรารีแบบเนทีฟที่แอปใช้ การตัดไลบรารีโค้ดแบบเนทีฟช่วยประหยัดขนาดได้มาก แต่จะวิเคราะห์ข้อขัดข้องใน Google Play Console ไม่ได้เนื่องจากไม่มีข้อมูล (เช่น ชื่อคลาสและฟังก์ชัน) หากต้องการแก้ไขข้อบกพร่องของข้อขัดข้อง คุณต้องใส่ไฟล์สัญลักษณ์สำหรับแก้ไขข้อบกพร่องไว้กับแอปใน Play Console
อัปโหลดไฟล์สัญลักษณ์
Google Play Console จะรายงานการขัดข้องของระบบในส่วน Android Vitals คุณสามารถสร้างและอัปโหลดไฟล์สัญลักษณ์สำหรับแก้ไขข้อบกพร่องของระบบสำหรับแอปได้โดยทำตามขั้นตอนไม่กี่ขั้นตอน ไฟล์นี้จะเปิดใช้สแต็กเทรซข้อขัดข้องของระบบที่แทนที่ด้วยสัญลักษณ์ (ซึ่งรวมถึงชื่อคลาสและฟังก์ชัน) ใน Android Vitals เพื่อช่วยคุณแก้ไขข้อบกพร่องของแอปในเวอร์ชันที่ใช้งานจริง ขั้นตอนเหล่านี้จะแตกต่างกันไปตามเวอร์ชันของปลั๊กอิน Android Gradle ที่ใช้ในโปรเจ็กต์ และขึ้นอยู่กับว่าคุณใช้ Android App Bundle (แนะนำ) หรือ APK
ปลั๊กอิน Android Gradle เวอร์ชัน 4.1 ขึ้นไป
หากโปรเจ็กต์สร้าง Android App Bundle (AAB) คุณสามารถกำหนดค่าบิลด์ให้รวมไฟล์สัญลักษณ์สำหรับแก้ไขข้อบกพร่องแบบเนทีฟไว้ใน AAB โดยอัตโนมัติ เพื่อให้อัปโหลดไปยัง Play Console เมื่อคุณเผยแพร่แอป หากต้องการรวมไฟล์นี้ในบิลด์ที่เผยแพร่ ให้เพิ่มโค้ดต่อไปนี้ลงในไฟล์ build.gradle.kts ของแอป
android.buildTypes.release.ndk.debugSymbolLevel = { SYMBOL_TABLE | FULL }
เลือกระดับสัญลักษณ์การแก้ไขข้อบกพร่องจากตัวเลือกต่อไปนี้
- ใช้
SYMBOL_TABLEเพื่อดูชื่อฟังก์ชันในสแต็กเทรซที่แปลงเป็นสัญลักษณ์ของ Play Console ระดับนี้รองรับทูมสโตน - ใช้
FULLเพื่อดูชื่อฟังก์ชัน ไฟล์ และหมายเลขบรรทัดในสแต็กเทรซที่แปลงเป็นสัญลักษณ์ของ Play Console
หากเป็นโปรเจ็กต์สร้าง APK ให้ใช้การตั้งค่า android.buildTypes.release.ndk.debugSymbolLevel ที่แสดงไว้ก่อนหน้านี้เพื่อสร้างไฟล์สัญลักษณ์สำหรับแก้ไขข้อบกพร่องแบบเนทีฟแยกกัน อัปโหลดไฟล์สัญลักษณ์สำหรับแก้ไขข้อบกพร่องแบบเนทีฟไปยัง Google Play Console ด้วยตนเอง (กระบวนการนี้คล้ายกับการอัปโหลดไฟล์การแมปเพื่อถอดรหัสซอร์สโค้ดที่สร้างความสับสนของสแต็กเทรซ)
เนื่องจากเป็นส่วนหนึ่งของกระบวนการบิลด์ ปลั๊กอิน Android Gradle จะเอาต์พุตไฟล์นี้ในตำแหน่งของโปรเจ็กต์ดังต่อไปนี้
app/build/outputs/native-debug-symbols/<var>variant-name</var>/native-debug-symbols.zip
หากทรัพยากร Dependency มีไลบรารีแบบเนทีฟ ข้อมูลการแก้ไขข้อบกพร่องอาจถูกตัดออกเพื่อลดขนาด คุณสามารถตรวจสอบได้โดยเรียกใช้บิลด์ที่มีระดับบันทึก info และการตั้งค่า debugSymbolLevel = { SYMBOL_TABLE | FULL }
จากนั้นมองหาบรรทัดต่อไปนี้ในเอาต์พุตบิลด์
Unable to extract native debug metadata from ... because the native debug metadata has already been stripped.
ปลั๊กอิน Android Gradle เวอร์ชัน 4.0 ลงไป (และระบบบิลด์อื่นๆ)
ในกระบวนการบิลด์ ปลั๊กอิน Android Gradle จะเก็บสำเนาของไลบรารีที่ยังไม่ได้ Strip เอาไว้ในไดเรกทอรีของโปรเจ็กต์ โครงสร้างไดเรกทอรีนี้คล้ายกับโครงสร้างต่อไปนี้
app/build/intermediates/cmake/universal/release/obj/
├── armeabi-v7a/
│ ├── libgameengine.so
│ ├── libothercode.so
│ └── libvideocodec.so
├── arm64-v8a/
│ ├── libgameengine.so
│ ├── libothercode.so
│ └── libvideocodec.so
├── x86/
│ ├── libgameengine.so
│ ├── libothercode.so
│ └── libvideocodec.so
└── x86_64/
├── libgameengine.so
├── libothercode.so
└── libvideocodec.so
บีบอัดเนื้อหาของไดเรกทอรีนี้
cd app/build/intermediates/cmake/universal/release/obj zip -r symbols.zip .อัปโหลดไฟล์
symbols.zipไปยัง Google Play Console ด้วยตนเอง