构建 Android 工程、APK 与 AAB
构建 Android 工程、APK 与 AAB:GalCraft Studio 操作与参考。
在“发布”选择 Android,在“目标构建器”选择已安装的 Android 0.1.0。目录为空时,从插件页安装对应目标包。先按发行总览应用发行配置、保存作品并检查目标素材。
1. 填写应用配置
| 字段 | 填写方式 |
|---|---|
| 应用 ID(applicationId) | 如 com.example.springlights;每段以小写字母开头,使用小写字母、数字和下划线,至少两段 |
| 构建序号(versionCode) | 1~2100000000 的整数;新构建从 1 开始,后续发布递增 |
| 屏幕方向 | “固定横屏”或“横屏随设备旋转”,默认为固定横屏 |
| 输出类型 | “完整 Android 工程”、APK 或 AAB |
当前模板固定 minSdk 26、targetSdk 35。可在“目标能力与版本”查看构建器、架构和工具要求。图标沿用作品已保存的图像素材;Android 图标接受 PNG、JPEG 或 WebP。
2. 导出完整工程
选择 完整 Android 工程,选择专用输出目录,检查已保存版本后确认构建。输出目录中的 android-project/ 包含 Gradle 工程、Player、快照、资源与原生桥。把整个工程交给 Android Studio 打开,在那里配置 JDK、SDK 与签名。
工程输出直接准备文件;工具检测与下载属于 APK/AAB 路径。导出的工程将签名配置留给 Android Studio,作者可从 Build → Generate Signed Bundle/APK 选择输出并填写自己的密钥库与别名。详细步骤见 Android 官方签名指南。
3. 准备 APK/AAB 工具
- 输出选择 APK 或 AAB,填写“工具下载位置”,或点击“选择工具目录”。默认位置为用户目录下
.galcraft/tools。 - 已有工具时展开“复用已有 JDK / SDK”,填写 JDK 根目录和 Android SDK 根目录,点击“检测环境”。JDK 需为 17 或 21,并包含 javac;SDK 需有 Platform 35 和 Build Tools 35.0.0。
- 需要准备工具时阅读 Android SDK 许可并勾选同意,再点击“准备环境”。工具会复用兼容 JDK,补齐 command-line tools 13114758、SDK 35 与 Build Tools 35.0.0。工程使用 Gradle 8.9、AGP 8.7.3。
- 等待“环境可用”,核对显示的 JDK、SDK 与缓存路径。准备中可取消;已经完成的组件保留供下次使用。网络或路径错误修正后重新检测或准备。
工具与缓存位于所选目录下 galcraft-android-0.1.0/,默认 SDK 为其 sdk/,Gradle 缓存为 gradle-cache/。复用工具保留原目录。自行管理 SDK 时按 Android SDK 工具说明安装对应版本并接受所需许可。
4. 设置签名与密码环境变量
APK 默认选择“明确用于本地测试”;AAB 默认选择“作者发布签名”。本地测试使用 Android debug 身份。作者发布签名填写:
| 字段 | 示例与含义 |
|---|---|
| 密钥库路径 | 作者的 .jks 或兼容密钥库完整路径 |
| 密钥别名 | 密钥库中所选签名键的 alias |
| 库密码环境变量 | 如 SPRING_STORE_PASSWORD,填写变量名 |
| 密钥密码环境变量 | 如 SPRING_KEY_PASSWORD,填写变量名 |
让执行构建的 Studio 本机服务读取这两个环境变量。Windows 可在“编辑账户的环境变量”中设置,然后停止已运行的 Studio 服务,重新打开终端并启动 Studio。也可在 PowerShell 7 中交互输入后启动桌面程序:
$env:SPRING_STORE_PASSWORD = Read-Host 'Keystore password' -MaskInput
$env:SPRING_KEY_PASSWORD = Read-Host 'Key password' -MaskInput
& 'C:\GalCraft\win-unpacked\GalCraft Studio.exe'把程序路径换为实际安装位置;先在“本机服务”中停止同一数据目录的旧服务,使新服务继承当前终端环境。npm 入口同样在该终端运行 galcraft-studio。界面字段保存环境变量名,构建进程读取对应值。
5. 构建并找到产物
- 选择专用输出目录,点击“检查已保存版本”。修正检查问题后“确认构建”。
- 构建进度显示 Gradle 任务:测试 APK 为 assembleDebug,作者 APK 为 assembleRelease,AAB 为 bundleRelease。
- 阅读回执中的签名模式、身份及结果。最终文件位于
artifacts/<projectId>-<发行版本>.apk或.aab;输出目录也保留android-project/供继续开发。 - 使用 APK 在目标设备安装并检查阅读与资料保存;AAB 按所选分发平台上传。Google Play 的上传密钥和 Play App Signing 操作见官方签名指南。