Studio 可以把完整游戏构建为 Android APK，并在构建完成后直接安装到 USB 真机或托管模拟器。APK 安装后可以离线游玩，适合移动端适配和分发试玩。
Android 构建目前为测试版，只生成 debug 签名 APK。它可以直接安装和分享测试，但不能代替应用商店要求的正式签名产物。
构建前准备
进入顶部「发布游戏」，在目标平台中选择「移动端」。首次使用时，页面顶部会检查以下工具：
| 工具 | 要求 | 准备方式 |
|---|
| Java JDK | 构建页一键安装使用 JDK 21；已有 JDK 需为 17 或更高 | 点击「一键安装」，或到「设置 → 第三方 → Java JDK」登记本机版本 |
| Android SDK | Studio 构建所需的平台与命令行组件 | 点击「一键安装」下载到用户目录 |
配置应用
| 配置 | 说明 |
|---|
| 游戏名 | 显示在手机桌面图标下方 |
| 包名 | Android 用来识别应用的唯一身份，例如 com.yourname.game |
| 版本号 | 语义化版本号，例如 1.0.0 |
| 应用图标 | 支持正方形 PNG、JPG 或 WebP，建议至少 512 × 512 |
| 游玩时保持屏幕常亮 | 开启后，阅读剧情时不会按系统超时自动熄屏 |
| 切到后台时暂停游戏 | 开启后，切走时画面和声音一起暂停 |
首次对外发布后不要再修改包名。包名变化会让 Android 把新 APK 识别为另一款应用，原应用无法直接覆盖更新，存档也不会自动共用。
构建 APK
- 确认「安卓构建工具链」显示已就绪。
- 填写游戏名、包名和版本号，按需选择图标与行为开关。
- 点击右侧的构建按钮，等待预检、素材处理和 Android 打包完成。
- 在项目的
dist/android 目录取得 APK。
游戏剧本、素材和运行时会一起写入 APK。移动端画面会适配刘海和挖孔屏的安全区域；仍建议在目标手机上检查横屏画面、文字尺寸、按钮触控区域和音频切后台行为。
在设备上运行
构建成功后，右侧会出现「在设备上运行」。Studio 的选择顺序如下：
- 检测到开启 USB 调试的 Android 真机时，直接安装并启动 APK。
- 没有真机时，尝试启动 Studio 托管的 Android 模拟器。
- 模拟器尚未安装时，可以按提示下载约 2 GB 的模拟器组件，再继续运行。
运行成功后可以继续使用「重新运行」「停止」和「卸载」。Studio 会优先操作上一次成功运行的设备。
「卸载」会同时移除该设备上的应用与存档数据。需要保留测试进度时，不要使用卸载；重新构建后直接覆盖安装即可。
连接真机
不同品牌手机开启开发者选项的路径略有不同，通常需要：
- 在系统设置中连续点击版本号，开启「开发者选项」。
- 在开发者选项中打开「USB 调试」。
- 用数据线连接电脑，并在手机上允许当前电脑进行 USB 调试。
- 回到构建结果，点击「在设备上运行」。
如果设备没有出现，先确认数据线支持数据传输、手机已授权当前电脑，再重新连接并重试。
JDK 管理
构建页的一键安装适合首次配置。如果电脑已有多个 Java 环境，可以在「设置 → 第三方 → Java JDK」中：
- 下载并选用 Studio 托管的 JDK 21；
- 扫描系统中已安装的 JDK；
- 浏览并登记指定 JDK 目录；
- 在多个可用版本间切换；
- 不固定版本，按「Studio 托管 → 系统
JAVA_HOME」自动选择。
从列表移除手动登记的 JDK 只会解除 Studio 的记录，不会删除电脑上的 JDK 文件。
当前限制
- APK 使用 debug 签名，适合测试，不适合直接上架应用商店。
- iOS 构建暂不可用；iOS 还需要 macOS、开发者证书和对应签名流程。
- 首次安装工具链、模拟器和 Gradle 依赖需要联网。
准备分发测试前，至少在一台带挖孔或刘海的手机和一台普通横屏设备上完整试玩，并固定包名、递增版本号。
