Cách tạo native debug symbol cho Godot Android trên Windows và upload lên Play Console

Bạn hoàn toàn có thể tạo debug symbol cho Godot Android trên Windows để upload lên Play Console, nhưng cần đảm bảo debug symbols khớp chính xác với build đã phát hành. Việc này rất quan trọng vì Play Console yêu cầu native debug symbols tương ứng để symbolicate stack trace .

Sử dụng native debug symbols chính thức (không cần build lại engine)

Nếu bạn dùng export template chính thức từ Godot mà không chỉnh sửa engine, cách dễ nhất là tải native debug symbols có sẵn cho mỗi bản phát hành Godot. Godot cung cấp các file này cho mọi stable release . Điều này giúp bạn tránh phải tự build và đảm bảo tính tương thích.

Hướng dẫn build trên Windows với các flag của bạn

Nếu bạn muốn tự build (ví dụ vì đã chỉnh sửa engine), làm theo các bước sau:

1. Cài đặt môi trường

• Đảm bảo Android SDK đã được cài đặt.
• Set biến môi trường ANDROID_HOME trỏ đến thư mục Android SDK .

Ví dụ trong Command Prompt:

set ANDROID_HOME=C:\Users\TenBan\AppData\Local\Android\Sdk

2. Clone source Godot và checkout đúng phiên bản

Clone source Godot và checkout đúng phiên bản với editor/export template bạn đang dùng. Debug symbols phải tương ứng chính xác với build game bạn phát hành .

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

3. Chạy SCons với các flag mong muốn

Sử dụng lệnh SCons từ thư mục source Godot. Tài liệu về debug symbols cũng dùng scons để compile export templates với debug symbols .

Với flag bạn đã liệt kê (chỉ dùng nếu build system Godot phiên bản của bạn hỗ trợ):

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

Tài liệu Sentry cũng chỉ ra rằng export template Android có thể được compile với target=template_debug, platform=android, arch=arm32, và debug_symbols=yes để tạo template có debug symbols .

Khuyến nghị cho Play Console: build release

• Để upload lên Play Console, bạn nên dùng target release thay vì template debug.

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

• Nếu muốn tách riêng file symbol, tài liệu Sentry cho Godot có thêm tùy chọn separate_debug_symbols=yes :

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

File cần upload lên Play Console

• Upload debug symbols từ cùng một build với AAB/APK bạn upload. Stack trace chỉ có thể đọc được nếu native debug symbols khớp với exported build .
• Nếu build không tự động tạo file ZIP sẵn sàng upload, các tài liệu hiện có cho thấy việc tách symbols cho Google Play từng không đơn giản và có thể cần làm thủ công . Tuy nhiên, không có đủ thông tin về cấu trúc ZIP chính xác mà Play Console yêu cầu.

Lưu ý quan trọng

• Không trộn lẫn symbols từ các phiên bản Godot/export template khác nhau. Debug symbols phải tương ứng với build game đã xuất .
• Nếu bạn không chỉnh sửa source Godot, an toàn nhất là dùng native debug symbols chính thức từ phiên bản Godot tương ứng với export template bạn dùng .
• Nếu bạn chỉnh sửa source Godot hoặc tự build template, hãy dùng symbols từ build của bạn, không phải symbols chính thức .
• Tài liệu hiện tại còn hạn chế về vị trí output file trên Windows và quy trình đóng gói ZIP cho Play Console, do đó không có đủ thông tin cho các bước chi tiết cuối cùng.