Read this manual in English

Android 开发

Android 设备允许自由允许你开发的应用. 可以很容易地编译好游戏拷贝到 Android 设备上. 本手册介绍了对于 Android 游戏的打包步骤. 推荐开发时, 从 开发应用 上运行游戏因为可以通过无线连接设备进行代码和内容的热重载.

Android 和 Google Play 签名

Android 要求每个 APK 文件在被安装到设备上或者在设备上更新之前必须进行数字签名. 如果你是安卓开发者, 只需要在把程序包上传到 Play Console 之前, 经过 Play App Signing 的自动处理即可. 然而, 你还可以选择手动对程序包进行签名以便上传到 Google Play, 其他应用商店以及在整个互联网上传播.

从 Defold 编辑器或者 命令行工具 打包安卓包需要提供一个 keystore (包括证书和公匙), 然后对应用签名时还要用到私匙. 没有的话, Defold 会自动生成一个临时调试用 keystore 用于打包和签名.

制作 keystore

也可以 使用 Android Studio 或者通过使用控制台命令来生成签名:

keytool -genkey -v -noprompt -dname "CN=John Smith, OU=Area 51, O=US Air Force, L=Unknown, ST=Nevada, C=US" -keystore mykeystore.keystore -storepass 5Up3r_53cR3t -alias myAlias -keyalg RSA -validity 9125

这个命令会生成一个叫做 mykeystore.keystore 的签名, 其中包含了证书和密码. 密匙 5Up3r_53cR3t 保护其不备破解. 这个签名有效期为 25 年 (9125 天). 这个签名的id叫做 myAlias.

安卓应用打包

编辑器打包安卓包十分方便. 打包之前可以为应用指定图标, 设置版本号等等, 都在 game.project 项目配置文件 里设置.

选择菜单栏 Project ▸ Bundle... ▸ Android Application... 就可以打包了.

要让编辑器自动生成调试用签名, 只需把 Keystore 和 Keystore password 字段留空即可:

要让编辑器使用你自己指定的签名打包, 就要设置好 Keystore 和 Keystore password 字段. Keystore 的扩展名是 .keystore, 而密码要保存成文本 .txt 文件. 如果 keystore 里的 key 使用了自己的密码, 也可在 Key password 里指定:

Defold 支持创建 APK 和 AAB 文件. 从打包格式下拉菜单中选择.

点击 Create Bundle 会提示选择打包文件存放位置.

安装 Android 应用包

安装 APK

编辑器生成 Android 应用包 .apk 文件. 应用包可以通过 adb 工具安装到设备上, 或者通过 Google Play 开发者控制台 发布到 Google Play 上.

$ adb install Defold\ examples.apk
4826 KB/s (18774344 bytes in 3.798s)
  pkg: /data/local/tmp/my_app.apk
Success

使用编辑器安装 APK

你可以在编辑器的打包对话框中勾选 “Install on connected device” 和 “Launch installed app” 安装并启动 .apk:

为了顺利运行, 你要安装好 ADB 并打开连接设备的 USB debugging. 如果编辑器无法找到 ADB 命令行工具的地址, 你要在 Preferences 中指定好.

安装 AAB

对于 .aab 文件可以通过 Google Play 开发者控制台 上传给 Google Play. 也可以使用 .aab 文件制作 .apk 以便使用 Android 打包工具 在本地安装.

权限

Defold 引擎需要一些权限来运行各种功能. 权限在 AndroidManifest.xml 文件中定义, 并在 game.project 项目配置文件 中配置. 关于 Android 权限详见 官方文档. 默认配置需要如下权限:

android.permission.INTERNET and android.permission.ACCESS_NETWORK_STATE (Protection level: normal)

允许应用打开网络连接访问互联网. 需要上网时需要此权限. 见 (Android 官方文档-网络) 和 (Android 官方文档-网络状态).

android.permission.WAKE_LOCK (Protection level: normal)

允许应用阻止屏幕息屏和调光. 接收通知保持亮屏时需要此权限. ([Android 官方文档-亮屏锁定)

使用 AndroidX

AndroidX 一個較大改動就是, 不再維護 Android Support Library 了. AndroidX 應用使用雲計算功能和新庫完整取代了 Support Library. Asset Portal 裏的绝大多数擴展包已經支持 AndroidX. 如果希望使用旧版安卓库而不是 AndroidX, 可以创建新的 app manifest 文件或在 Defold Manifest 文件里勾選 “Use Android Support lib” 選項.

常见问题

Q: 安卓系统有办法隐藏导航栏和状态栏吗?

A: 有, 在你的 game.project 文件的 Android 部分的 immersive_mode 项. 这项可以使你获得全部的屏幕及屏幕触摸事件.

Q: 在设备上安装 Defold 游戏时总是出现 “Failure [INSTALL_PARSE_FAILED_INCONSISTENT_CERTIFICATES]” 错误?

A: 安卓系统发现你的更新app使用了新的证书. 打包调试版本时, 使用的是一个临时证书. 所以在更新版本前要删除旧版本:

$ adb uninstall com.defold.examples
Success
$ adb install Defold\ examples.apk
4826 KB/s (18774344 bytes in 3.798s)
      pkg: /data/local/tmp/Defold examples.apk
Success