跳转至
来源: android/AGENTS.md android/app/build.gradle android/app/jni/CMakeLists.txt android/app/src/main/java/com/crimsoncrossbunker/cataclysmcb/AndroidHudModel.java .github/workflows/release-android-bundle.yaml commit d32b9cc880a8 build-config

Android 开发

Android 由 Gradle application 与 native CMake build 组成，使用 SDL3、按 ABI 的 native artifact、Java Activity/HUD 集成、Android resource、打包游戏数据，以及不同 debug/ release signing 路径。

权威入口

  • android/gradlew、android/app/build.gradle、android/app/jni/CMakeLists.txt 定义 本地 application/native build；
  • android/app/src/main/AndroidManifest.xml 与 Java source 定义 application/UI bridge；
  • .github/workflows/matrix.yml 包含当前 build-only Android CI lane；
  • .github/workflows/release-android-bundle.yaml 定义 release bundle 与 signing。

先运行最窄验证

在 android/ 使用 wrapper，并把 SDK/NDK 配置留在 Git 外：

./gradlew test
./gradlew assembleDebug

第一条覆盖 Android HUD model/geometry/schema 等 JVM unit test。APK assemble 还需要配置 SDK/NDK，并复制 native/game asset。报告 variant、ABI、SDK/NDK、Gradle/Java、SDL、安装 设备与安装结果。

运行时边界

Java 拥有 Activity lifecycle、storage path、Android HUD/editor/dialog，并通过定义 bridge 调用 native；native 拥有游戏 runtime。保持 pause/resume、surface/renderer recreation、 text input、touch coordinate、storage permission 和 desktop/Android 行为边界。

打包与安全

不要提交 local.properties、SDK path、keystore、password、签名 APK/AAB、Gradle state 或 生成 native library。CI release signing 使用 secret，只暴露预期 bundle/artifact。debug 安装不能验证 release signing 或商店交付。

失败证据

收集 commit、variant/ABI、device/API level、准确 Gradle task、首个 Gradle/CMake error 和 聚焦 logcat crash 段。区分 Java exception、native tombstone、renderer recovery、asset copy、install/signature 与 storage-path 故障。