游戏引擎 / 系统课时
怎样完成一次 Android 本地安装
怎样完成一次 Android 本地安装
把 APK 复制到手机还不算完成 Android 发布验证。本节从确认本次构建产物开始,连接指定设备完成安装,再检查冷启动、资源加载和基础交互,让一次本地安装同时留下可追溯的包与设备证据。
学习目标
- 从本次 Creator 构建定位对应的原生工程与 APK。
- 使用明确的设备标识执行安装,识别连接和安装错误。
- 在真机检查首场景、延迟资源和后台恢复。
先生成对应的 APK
准备 Creator 3.8 LTS 项目,以及与该精确版本匹配的 Android SDK、NDK、JDK 和原生构建工具。在 Creator 的 Android 构建任务中核对首场景、包名、ABI 和签名选择,构建到独立目录,再完成原生编译打包。不要照搬其他 Creator 版本的工具链版本号。
若在 Android Studio 中继续操作,打开本次生成的工程,等待 Gradle 同步成功,再构建目标变体。同步失败先看依赖下载和工具链配置;编译失败看首次原生错误;这些问题未解决时,不要拿以前的 APK 继续做本轮验收。Creator Android 发布说明
记录实际 APK 的完整路径和摘要。首次本地测试可使用明确的调试签名,但这只证明测试路线成立,不能替代正式签名包的验收。AAB 不是这里要安装的文件,若渠道给出拆分 APK 集合,应使用相应的完整安装流程。
确认设备已经授权
安装 Android SDK Platform Tools,让 adb 可以在终端调用。手机开启开发者选项与 USB 调试,连接数据线并在手机上确认调试授权。只充电的线、未安装的设备驱动或未确认授权,都可能让主机看不到可用设备。
下面是操作片段示例,依赖已连接的 Android 设备和可用的 adb。在 PowerShell 执行后,从结果中找到目标设备序列号;<SERIAL> 表示实际设备值,不能原样复制到后续命令。官方 adb 使用说明
# 在安装前确认目标,防止装到另一台设备或模拟器。
adb devices -l预期结果:列表中目标序列号后状态为 device,并可包含型号等附加字段。空列表表示连接未建立,unauthorized 表示需要确认授权,offline 表示连接不可用。只有设备状态正确后才继续。
安装指定的测试包
下面同样是片段示例,依赖上一步得到的序列号以及本次真实 APK。把 <SERIAL> 与 <APK_PATH> 替换成实际值,路径保留双引号。-r 请求替换已有应用并保留数据,适合验证同一签名身份下的更新安装。
# 明确指定设备;目标文件必须是完整、可安装的 APK。
adb -s "<SERIAL>" install -r "<APK_PATH>"预期结果:安装成功时最后给出成功标记,之前可能出现传输方式等日志:
Success若报签名不兼容,应核对当前已安装应用与新包的证书,不要先删应用掩盖更新问题。卸载会清除该应用本地数据,只在测试数据可丢弃且明确要做首次安装时使用。版本降级、ABI 不匹配或系统版本不支持也需要分别修复,不能把所有错误归为数据线问题。
在真机确认游戏运行
从手机桌面启动刚安装的应用,确认首场景、屏幕方向和触摸输入;执行一条最小主流程,再触发一个不会在首屏加载的资源。切到后台再返回,观察画面、音频和交互是否恢复;断网时应显示可理解的结果而不是无限等待。
首次安装和保留数据更新要分开记录。干净安装能检查首包是否自足,更新安装能暴露旧存储与新版本不兼容。每次将设备型号、系统版本、包摘要和测试结果写在一起,避免“这个手机上昨天能运行”成为唯一证据。
按失败阶段缩小范围
| 失败阶段 | 优先保留的证据 | 优先检查 |
|---|---|---|
| 原生编译 | 首条构建错误及工具链版本 | 依赖、NDK、Gradle 与原生插件 |
| 安装 | adb 的完整失败代码 | 签名、版本、ABI 与系统兼容 |
| 冷启动 | 对应进程日志和崩溃信息 | 原生库、启动配置与首场景 |
| 进入后缺资源 | 请求地址与资源名 | 打包依赖、远程地址与网络 |
本节的完成证据是指定设备上运行了指定摘要的 APK,并完成基本交互检查。修复后重新打包产生新摘要时,应重新安装并检查受影响路径,不能把上一份包的成功记录直接沿用。