Покрокова інструкція: генерація debug symbols для Android у Godot на Windows

Так, це можливо, але для завантаження в Play Console вам потрібні нативні debug symbols, які точно збігаються з тією збіркою Android, яку ви випускаєте, тому що символікація стеків потребує debug symbols, що відповідають експортованій збірці . Якщо ви використовуєте офіційні шаблони експорту без змін рушія, найпростішим варіантом буде скористатися офіційними нативними debug symbols від Godot, оскільки Godot надає їх для кожного офіційного шаблону експорту .

Як зібрати на Windows з вашими прапорцями

• Переконайтеся, що Android SDK встановлено, а потім встановіть змінну середовища ANDROID_HOME на шлях до папки Android SDK .

Приклад для командного рядка:

set ANDROID_HOME=C:\Users\ВашеІм'я\AppData\Local\Android\Sdk

• Склонуйте вихідний код Godot та перемкніться на ту саму версію, яку використовуєте для редактора/шаблонів експорту, адже debug symbols мають відповідати експортованій збірці, яку ви випускатимете .

git clone https://github.com/godotengine/godot.git
cd godot
git checkout 4.x

• Запустіть SCons із папки вихідного коду Godot; документація використовує команду scons для компіляції шаблонів експорту з debug symbols .

Для ваших прапорців використовуйте наступну команду (якщо ваша версія Godot підтримує ці опції):

scons platform=android target=template_debug generate_android_binaries=yes debug_symbols=yes gradle_do_not_strip=yes

• Документація Sentry також показує, що шаблон експорту Android можна зкомпілювати з target=template_debug, platform=android, arch=arm32 та debug_symbols=yes для створення шаблону з debug symbols .

Для Play Console краще збирати у release

• Для збірки, яку ви випускатимете, рекомендую використовувати ціль release, а не template debug.

scons platform=android target=template_release generate_android_binaries=yes debug_symbols=yes gradle_do_not_strip=yes

• Якщо потрібні окремі символи, документація Sentry для Godot пропонує опцію separate_debug_symbols=yes при компіляції шаблону експорту з debug symbols .

Приклад:

scons platform=android target=template_release generate_android_binaries=yes debug_symbols=yes gradle_do_not_strip=yes separate_debug_symbols=yes

Які файли завантажувати в Play Console

• Завантажуйте debug symbols, що походять з тієї самої збірки, що й AAB/APK, який ви завантажуєте, оскільки стек викликів можна зробити людино-читабельним лише якщо нативні debug symbols збігаються з експортованою збіркою .

• Якщо результат збірки не створює ZIP-файл, готовий до завантаження, наявні докази свідчать, що підтримка окремих символів для Google Play колись була непростою і могла потребувати ручного втручання .

• Для точної структури ZIP-файлу нативних символів, яку приймає Play Console, наявних доказів недостатньо, щоб підтвердити остаточний формат.

Важливі зауваження

• Не змішуйте символи з різних версій Godot або шаблонів експорту — debug symbols мають відповідати збірці вашої гри .

• Якщо ви не змінювали вихідний код Godot, безпечніше використовувати офіційні нативні debug symbols з тієї ж версії Godot, що й ваш офіційний шаблон експорту .

• Якщо ви змінювали вихідний код Godot або збирали власні шаблони, використовуйте символи з вашої власної збірки, а не офіційні, оскільки символи мають відповідати експортованій збірці вашої гри .

• Наявних доказів недостатньо для деталей про розташування вихідних файлів на Windows та процес пакування ZIP для Play Console; тому точне розташування файлів залишається невизначеним.