Преобразуване в символи или опростяване на трасиранията на стека, свързани със сривове

За да се опростяват трасиранията на стека на Java, първо трябва да генерирате файл за съответствия в ProGuard. За да научите как, посетете сайта на Google Developers.

Версия 4.1 или по-нова на приставката на Android за Gradle

Ако проектът ви се компилира във формат Android App Bundle, можете автоматично да включите в него файла за преобразуване в символи с цел отстраняване на грешки. За целта добавете следния код към файла build.gradle на приложението си:

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

Забележка: Ограничението за файла за преобразуване в символи с цел отстраняване на грешки е 800 MB. Ако отпечатъкът на символите за отстраняване на грешки е твърде голям, използвайте SYMBOL_TABLE вместо FULL, за да намалите размера на файла.

Ако проектът ви се компилира в APK файл, използвайте горепосочената настройка за build.gradle, за да генерирате отделно файла със символи за отстраняване на грешки. Ръчно качете в Google Play Console файла със символи за отстраняване на грешки, както е описано по-долу в Стъпка 2: Качване на файл за опростяване или преобразуване в символи. В процеса на компилация приставката на Android за Gradle генерира този файл в следната директория на проекта:

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

Версия 4.0 или по-стара на приставката на Android за Gradle (и други системи за компилиране)

В процеса на компилацията за пакета с приложения или APK файла приставката на Android за Gradle запазва в директория на проекта копие на библиотеките, включващо информацията за отстраняване на грешки. Структурата на директорията е подобна на тази:

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

Забележка: Ако използвате друга система за компилиране, можете да я промените така, че да съхранява библиотеките, включващи информацията за отстраняване на грешки, в директория с горепосочената необходима структура.

1. Компресирайте съдържанието на тази директория:
   • $ cd app/build/intermediates/cmake/universal/release/obj
   • $ zip -r symbols.zip .
2. Качете ръчно файла symbols.zip в Play Console, както е описано по-долу в Стъпка 2: Качване на файл за опростяване или преобразуване в символи.

Ограничението за файла за преобразуване в символи с цел отстраняване на грешки е 800 MB. Ако файлът ви е твърде голям, това вероятно се дължи на факта, че .so файловете съдържат таблица със символи (имена на функции), както и информация за отстраняване на грешки във формат DWARF (файлови имена и редове код). Тези данни не са необходими за преобразуване на кода ви в символи и могат да бъдат премахнати чрез изпълнение на следната команда:

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

Забележка: $OBJCOPY посочва конкретната версия на приложния двоичен интерфейс (ABI), от който премахвате информацията за отстраняване на грешки, например: ndk-bundle/toolchains/aarch64-linux-android-4.9/prebuilt/linux-x86_64/bin/aarch64-linux-android-objcopy

За да качите файл за опростяване или преобразуване в символи:

1. Отворете Play Console.
2. Изберете приложение.
3. В менюто отляво изберете Тестване и публикуване > Инструмент за разглеждане на Android App Bundle.
4. Посредством инструмента за избор в горния десен ъгъл изберете съответния артефакт.
5. Изберете раздела Изтегляния и превъртете надолу до секцията „Активи“.
6. Кликнете върху стрелката за качване за файла за съответствия или този за преобразуване в символи с цел отстраняване на грешки (което е приложимо), за да качите файла за опростяване или преобразуване в символи за версията на приложението си.

За да качвате файлове посредством API на Google Play за програмисти, посетете сайта на Google Developers.

Play Console използва ndk-stack, за да преобразува в символи трасиранията на стека за приложения с директно изпълнение, и ReTrace за сривове на Java. Ако не споделите файловете си за опростяване, можете да копирате маскираните трасирания на стека, свързани със сривове, от Play Console и да използвате подходящия инструмент офлайн, за да ги преобразувате в символи. Този процес обаче трябва да се извърши ръчно за всяко трасиране, което го прави бавен и времеемък. Ако предоставите файловете си за опростяване, Play Console ще направи това вместо вас.

След като качите файл за съответствия в ProGuard или файл за преобразуване в символи с цел отстраняване на грешки за дадена версия на приложението си, ще се опростяват данните само за сривовете и ANR, които възникват в бъдеще. За да видите опростени данни в Play Console, ще трябва да изчакате, докато бъдат подадени сигнали за нови сривове и ANR от потребителски устройства.

Причината за това е качването на непълен файл за опростяване/преобразуване в символи. Не забравяйте да включите съответните файлове за цялото си приложение, особено ако използвате сложен или многоетапен процес на компилация. Една от най-често срещаните причини за частично опростяване е използването на библиотека на трета страна. В този случай може да сте в състояние да получите файловете за опростяване от доставчика на библиотеката.

Без файлове за опростяване едни и същи срив или ANR на 32- и 64-битово устройство или на устройство с архитектура ARM и такова, базирано на Intel, ще се показват отделно. Файловете за опростяване ни дават възможност да групираме тези данни, за да ви дадем по-добра представа за най-значимите сривове и ANR за приложението ви.

Ако забравите да качите файла за нова версия на приложението си, данните за сривовете и ANR отново ще бъдат маскирани. Изпълнете инструкциите по-горе, за да го качите сега. След като качите файл за съответствия в ProGuard или файл със символи за отстраняване на грешки за дадена версия на приложението си, ще се опростяват данните само за сривовете и ANR, които възникват в бъдеще. За да видите опростени данни в Play Console, ще трябва да изчакате, докато бъдат подадени сигнали за нови сривове и ANR от потребителски устройства.

За да не рискувате да забравите да качите файла, бихте могли да промените процеса на компилация така, че да се използват пакети Android App Bundle с версия 4.1 или по-нова на приставката на Android за Gradle. В този случай файлът със символи за отстраняване на грешки може автоматично да бъде включен в Android App Bundle, като изпълните инструкциите на сайта за програмисти за Android.

Ако качите грешен файл за дадена версия на приложението си, данните за сривовете и ANR отново ще бъдат маскирани. За да качите коригирана версия:

1. Отворете Play Console.
2. Изберете приложение.
3. В менюто отляво изберете Тестване и публикуване > Инструмент за разглеждане на Android App Bundle
4. Посредством инструмента за избор в горния десен ъгъл изберете съответния артефакт.
5. Изберете раздела Изтегляния и превъртете надолу до секцията „Активи“.
6. Кликнете върху иконата за изтриване до неправилния файл за опростяване или преобразуване в символи.
7. След като неправилната версия бъде изтрита, кликнете върху иконата за качване и качете правилния файл за версията на приложението си.

След като качите правилния файл за съответствия в ProGuard или файла със символи за отстраняване на грешки, ще се опростяват само данните за сривовете и ANR, които възникват в бъдеще. За да видите опростени данни в Play Console, ще трябва да изчакате, докато бъдат подадени сигнали за нови сривове и ANR от потребителски устройства.

Съвет: За да избегнете риска от качване на неправилна версия на файла, бихте могли да промените процеса на компилация така, че да се използват пакети Android App Bundle с версия 4.1 или по-нова на приставката на Android за Gradle. В този случай файлът със символи за отстраняване на грешки може автоматично да бъде включен в Android App Bundle, като изпълните инструкциите на сайта за програмисти за Android.

Посетете сайта за програмисти за Android, за да започнете.

Да.

Понякога системата се натъква на ANR, но не може да събере трасирането на стека. В този случай ANR се показва, за да ви предостави по-пълен преглед за стабилността на приложението ви, но самото трасиране на стека не може да бъде показано. Грешките от типа ANR без трасирания на стека се групират по тип и активност. По този начин преглеждането и отстраняването на подобни ANR може да помогне за намаляването на броя ANR без трасирания на стека.