游戏引擎 / 系统课时

完成 Android 导出配置

完成 Android 导出配置

Android 导出同时涉及引擎模板、SDK、应用标识和商店规则。本课先建立可以安装测试的构建链,再核对真实包的目标 API 与权限,明确普通 APK 测试和 Google Play 发布各自需要的条件。

学习目标

  • 能核对 Android 导出工具链与应用标识
  • 能区分引擎依赖、最低系统与商店目标 API
  • 能在授权真机上完成首次安装检查

按引擎版本准备工具链

使用 Godot 4.7.2 对应的导出模板,先查看 Android export 列出的 JDK 与 Android SDK 组件版本,再安装到独立可记录的目录。不要从旧教程复制 NDK、Build Tools 或模板版本,版本不匹配可能在 Gradle 或原生构建阶段失败。

Editor → Editor Settings → Export → Android 中配置 Java SDK Path 与 Android SDK Path。SDK 根目录应包含 platform-tools/adb;Java 路径是 JDK 安装根,不是随意找到的 java.exe。这些是当前电脑的编辑器设置,新构建机需要单独配置。

本课以 GDScript 项目为例。C#、Android 插件和自定义模板具有额外条件,应按各自版本核对。安装全部工具并不自动证明相互兼容,要保留版本记录与真实构建日志,失败时从最早的具体错误开始定位。

设置预设与包的身份

Project → Export → Add → Android,给测试与正式用途分别命名。设置唯一包名,例如 com.example.spacegame 作为格式示例,发布时必须换成自己的身份;应用名称可显示给用户,包名则用于安装和升级识别,不能随版本随意变化。

检查架构、图标、屏幕方向与权限。网络功能按实际需要开启 Internet,其他权限也应只对应真实功能,并在最终清单中核对。权限勾选不代表系统运行时授权已经获得,拒绝权限和缺网络时仍需有可理解的行为。

需要 Gradle 构建或 AAB 时,在编辑器 Project → Install Android Build Template 安装相应构建模板,再按 Android 预设的 Gradle Build 设置完成配置。Google Play 新应用采用 AAB,不能把一个本地可安装 APK 直接当成已满足全部商店提交要求。

分开最低系统和目标 API

最低 SDK 决定允许安装的系统范围,目标 SDK 声明应用适配的平台行为,编译 SDK 则属于构建链。它们不是同一个数字。引擎文档列出的 SDK 安装组件也不自动等于当前商店要求,必须检查最终产物。

截至二〇二六年十月八日核验,Google Play 对手机新应用和更新自二〇二六年八月三十一日起要求目标 Android 16、API 36 或更高;Wear、TV、Automotive、XR 有不同范围。以 Play target API policy 和账号实际政策为准,并确认当前引擎、模板、插件及工具链能构建和运行该目标。

检查设备连接再安装测试包

在测试手机启用开发者选项与 USB 调试,连接后在手机上授权。保存下面完整 PowerShell 入口为 check-adb.ps1,用 -AndroidSdk 传入已安装 SDK 根目录。本课没有连接真实手机,命令应在自己的授权测试环境执行。

powershell
param([Parameter(Mandatory)][string]$AndroidSdk)
$ErrorActionPreference = 'Stop'
$adb = Join-Path $AndroidSdk 'platform-tools/adb.exe'
if (-not (Test-Path -LiteralPath $adb -PathType Leaf)) { throw 'adb missing' }
# 指定SDK内工具,避免误用其他版本的adb。
& $adb devices
if ($LASTEXITCODE -ne 0) { throw 'adb failed' }

预期输出(设备编号不同,只有已授权在线设备才显示 device):

text
List of devices attached
<ID>    device

没有条目时查线缆、驱动与连接模式;unauthorized 时在设备上确认授权;多设备时后续命令使用 -s 指定编号。正式安装前保留重要存档,同包名不同签名会阻止覆盖,不能以卸载后能装来证明升级链正确。

导出成功还要核对产物

先导出测试 APK 并安装运行,检查图形、触控、后台和存档;再建立正式签名与 AAB 流程。通过 apkanalyzer 或相应 bundle 工具核对包名、版本、最低与目标 SDK 及权限,再进入内部测试轨道验收。SDK 未配置、未签名或未上真机时明确记录未完成,不把脚本检查写成 Android 导出成功。

工具连接见 adb,预设字段见 EditorExportPlatformAndroid。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

完成 Android 导出配置

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通