نمادهای بومی را در ساخت نسخهٔ پخش خود بگنجانید

به‌طور پیش‌فرض، کتابخانه‌های کد بومی در ساخت‌های نسخه پخش برنامه شما حذف می‌شوند. این حذف شامل برداشتن جدول نماد و اطلاعات اشکال‌زدایی موجود در هر کتابخانه بومی استفاده‌شده توسط برنامه شما است. حذف کتابخانه‌های کد بومی منجر به صرفه‌جویی قابل‌توجهی در اندازه می‌شود؛ بااین‌حال، به‌دلیل اطلاعات مفقود (مانند نام کلاس و تابع)، تشخیص خرابی‌ها در کنسول Google Play غیرممکن است. برای اشکال‌زدایی ازکارافتادگی‌ها، باید فایل نمادهای اشکال‌زدایی را همراه با برنامه‌تان در «کنسول Play» اضافه کنید.

بارگذاری فایل نمادها

«کنسول Google Play» خرابی‌های بومی را در بخش معیارهای کلیدی Android گزارش می‌کند. با چند مرحله، می‌توانید فایل نمادهای اشکال‌زدایی بومی را برای برنامه‌تان تولید و بارگذاری کنید. این فایل ردیابی‌های پشته‌ای خرابی بومی نمادین‌شده (که شامل نام‌های کلاس و تابع است) را در معیارهای کلیدی Android فعال می‌کند تا به شما کمک کند اشکال‌زدایی برنامه‌تان را در تولید انجام دهید. این مراحل بسته به نسخه افزایه Android Gradle استفاده‌شده در پروژه‌تان و اینکه از Android App Bundle (توصیه‌شده) یا APK استفاده می‌کنید متفاوت است.

افزایه Android Gradle نسخه ۴.۱ یا بالاتر

اگر پروژه‌تان «بسته ترکیبی برنامه Android»‏ (AAB) می‌سازد، می‌توانید ساختتان را پیکربندی کنید تا به‌طور خودکار فایل نمادهای اشکال‌زدایی بومی را در AAB بگنجاند تا هنگام انتشار برنامه‌تان در «کنسول Play» بارگذاری شود. برای گنجاندن این فایل در ساخت‌های نسخه پخش، موارد زیر را به فایل build.gradle.kts برنامه‌تان اضافه کنید:

android.buildTypes.release.ndk.debugSymbolLevel = { SYMBOL_TABLE | FULL }

سطح نماد اشکال‌زدایی را از موارد زیر انتخاب کنید:

  • از SYMBOL_TABLE برای دریافت نام توابع در ردیابی پشته نمادین‌شده «کنسول Play» استفاده کنید. این سطح از سنگ قبر پشتیبانی می‌کند.
  • از FULL برای دریافت نام توابع، فایل‌ها، و شماره خطوط در ردگیری‌های پشته نمادین‌شده «کنسول Play» استفاده کنید.

اگر پروژه‌تان APK می‌سازد، از تنظیم android.buildTypes.release.ndk.debugSymbolLevel که قبلاً نشان داده شد استفاده کنید تا فایل نمادهای اشکال‌زدایی بومی را به‌طور جداگانه تولید کنید. فایل نمادهای اشکال‌زدایی بومی را به‌صورت دستی در «کنسول Google Play» بارگذاری کنید (این فرایند شبیه به بارگذاری فایل نگاشت برای ابهام‌زدایی از ردیابی پشته است). به‌عنوان بخشی از فرایند ساخت، افزایه Android Gradle این فایل را در مکان پروژه زیر برونداد می‌کند:

app/build/outputs/native-debug-symbols/<var>variant-name</var>/native-debug-symbols.zip

اگر وابستگی‌های شما حاوی کتابخانه‌های بومی باشد، احتمالاً اطلاعات اشکال‌زدایی برای کاهش اندازه حذف شده است. می‌توانید این موضوع را با اجرای ساخت با سطح گزارش info و تنظیم debugSymbolLevel = { SYMBOL_TABLE | FULL } تأیید کنید. سپس خط زیر را در خروجی ساخت پیدا کنید:

Unable to extract native debug metadata from ... because the native debug metadata has already been stripped.

افزایه Android Gradle نسخه ۴.۰ یا قدیمی‌تر (و دیگر سیستم‌های ساخت)

به‌عنوان بخشی از فرایند ساخت، افزونه Android Gradle نسخه‌ای از کتابخانه‌های حذف‌نشده را در دایرکتوری پروژه نگه می‌دارد. این ساختار دایرکتوری مشابه موارد زیر است:

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
  1. محتویات این دایرکتوری را فشرده کنید:

    cd app/build/intermediates/cmake/universal/release/obj
    zip -r symbols.zip .
    
  2. فایل symbols.zip را به‌صورت دستی در «کنسول Google Play» بارگذاری کنید.