Sandbox Radar 60 FPS - Android Build Configuration

此项目包含完整的Android构建配置，用于生成支持60 FPS的Sandbox Radar气象模拟应用。

构建要求

• Android Studio/SDK
• Android NDK (版本 25.2.9519653)
• CMake (版本 3.22.1)
• Java 8 或更高版本

项目结构

android-apk/
├── build.gradle (Project-level)
├── settings.gradle
├── gradle.properties
├── CMakeLists.txt (项目级)
├── gradlew
├── gradle/
│   └── wrapper/
├── app/
│   ├── build.gradle (Module-level)
│   ├── proguard-rules.pro
│   └── src/
│       └── main/
│           ├── AndroidManifest.xml
│           ├── java/
│           │   └── com/sandbox/radar/
│           │       └── MainActivity.java
│           └── res/
└── src/ (原生C++代码)
    ├── core/
    └── interpolate/

构建命令

生成Release APK

./gradlew assembleRelease

输出文件: app/build/outputs/apk/release/app-release.apk (约181 MB)

生成AAB (用于Google Play)

./gradlew bundleRelease

输出文件: app/build/outputs/bundle/release/app-release.aab (约180 MB)

配置详情

• API级别: 最小26 (Android 8.0), 目标34 (Android 14)
• 架构: 仅arm64-v8a (减小体积)
• 60 FPS: 已启用解耦模拟架构
• 代码混淆: 已启用R8 fullMode
• 资源压缩: 已启用shrinkResources

60 FPS特性

• 模拟步长: 3秒 (保持物理精度)
• 渲染帧率: 60 FPS (视觉流畅)
• 双时钟架构: 模拟与渲染线程解耦
• 插值系统: 场数据、Agent位姿、音频参数平滑插值

签名配置

Release版本需要签名配置，构建脚本会从环境变量读取密钥信息:

• KEYSTORE_PWD - 密钥库密码
• KEY_PWD - 密钥密码

输出文件

• APK: app/build/outputs/apk/release/app-release.apk
• AAB: app/build/outputs/bundle/release/app-release.aab
• Mapping文件: app/build/outputs/mapping/release/mapping.txt
• 符号文件: app/build/outputs/native-debug-symbols/release/

使用Bitrise自动构建

如果在本地环境无法构建，可以使用Bitrise CI/CD服务自动构建APK：

1. 在Bitrise上创建应用：

   • 登录 https://www.bitrise.io
   • 添加新应用
   • 选择您的代码仓库

2. 配置构建环境：

   • 在Bitrise控制台中配置构建工作流
   • 确保使用Android构建环境
   • 配置必要的环境变量

3. 使用脚本构建：

   # 设置Bitrise访问令牌
   export BITRISE_ACCESS_TOKEN="your_token_here"
   
   # 设置应用slug (在Bitrise控制台中找到)
   export APP_SLUG="your_app_slug_here"
   
   # 运行自动构建脚本
   ./build_with_bitrise.sh

4. 构建参数：

   • 脚本会自动压缩项目、上传到Bitrise
   • 触发构建并监控进度
   • 构建完成后自动下载APK到apk/目录

注意事项

由于当前在Termux环境中，完整构建需要在具有完整Android SDK的环境中进行。

使用Bitrise构建时，请确保：

• 已在Bitrise上正确配置了构建工作流
• 已设置必要的环境变量（如签名密钥）
• 构建配置与本项目中的gradle文件匹配