|
|
@@ -0,0 +1,128 @@
|
|
|
+---
|
|
|
+title: Google Play Instant
|
|
|
+brief: 本教程介绍了使用 Defold 创建 Google Play Instant 游戏的方法.
|
|
|
+---
|
|
|
+
|
|
|
+# Google Play Instant
|
|
|
+
|
|
|
+Google Play Instant 可以让 Android 6.0+ 的设备运行无需安装的原生应用.
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+## 发布流程
|
|
|
+
|
|
|
+如果想让游戏作为 Google Play Instant 发布, 需要修改项目配置:
|
|
|
+
|
|
|
+1. 自定义 `AndroidManifest.xml` 文件加入 `<manifest>` 属性:
|
|
|
+
|
|
|
+```lua
|
|
|
+xmlns:dist="http://schemas.android.com/apk/distribution"
|
|
|
+android:targetSandboxVersion="2"
|
|
|
+```
|
|
|
+后面紧跟描述项:
|
|
|
+```lua
|
|
|
+<dist:module dist:instant="true" />
|
|
|
+```
|
|
|
+
|
|
|
+结果 AndroidManifest.xml 类似这样:
|
|
|
+
|
|
|
+```lua
|
|
|
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
|
|
|
+ package="{{android.package}}"
|
|
|
+ android:versionCode="{{android.version_code}}"
|
|
|
+ android:versionName="{{project.version}}"
|
|
|
+ android:installLocation="auto"
|
|
|
+ xmlns:dist="http://schemas.android.com/apk/distribution"
|
|
|
+ android:targetSandboxVersion="2">
|
|
|
+ <dist:module dist:instant="true" />
|
|
|
+```
|
|
|
+
|
|
|
+2. 在 “game.project” 文件里添加 Google Instant Apps 扩展. 加入 “https://github.com/defold/extension-instantapp/archive/master.zip” 地址依赖或者指定 [特定版本](https://github.com/defold/extension-instantapp/releases) 的依赖.
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+3. 下载库文件: Project->Fetch Libraries
|
|
|
+4. 打包 `aab` Project->Bundle->Android Application
|
|
|
+5. 上传 `aab` 至 Google Play Console 作为 Android Instant App 发布
|
|
|
+
|
|
|
+### 版本号
|
|
|
+注意 [关于版本号的建议](https://developer.android.com/topic/google-play-instant/getting-started/game-instant-app#version-codes): Instant 游戏版本号要小于可安装游戏的版本号.
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+### android:targetSandboxVersion="2"
|
|
|
+
|
|
|
+如果在可安装主游戏里设置 `android:targetSandboxVersion="2"` 就可以像 instant 游戏一样访问数据 (比如存取同一个文件). 但是这样一来主游戏程序就可能会受到一些限制. 详情请见 [官方文档](https://developer.android.com/guide/topics/manifest/manifest-element#targetSandboxVersion).
|
|
|
+::: 注意
|
|
|
+游戏一旦安装, 它的目标沙箱值只能增加. 要想降级, 只能把游戏删除再覆盖安装 manifest 属性里目标沙箱值较小的版本.
|
|
|
+:::
|
|
|
+即使在可安装游戏和 instant 游戏里的 `android:targetSandboxVersion` 设置了不同的值, 仍然可以使用 `instantapp.set_cookie()` 和 `instantapp.get_cookie()` 来进行游戏版本间通信.
|
|
|
+
|
|
|
+## API 使用
|
|
|
+
|
|
|
+Google Play Instant 扩展使用 `instantapp.*` 命名空间封装了 Java [PackageManagerCompat 方法](https://developers.google.com/android/reference/com/google/android/gms/instantapps/PackageManagerCompat) API 供 Lua 使用.
|
|
|
+
|
|
|
+如果你要制作跨平台游戏最好在使用前检查 `instantapp` 模块是否存在, 因为它只存在于安卓游戏包中:
|
|
|
+```lua
|
|
|
+if instantapp then
|
|
|
+ -- 调用 instantapp 方法
|
|
|
+end
|
|
|
+```
|
|
|
+例如:
|
|
|
+
|
|
|
+```lua
|
|
|
+if instantapp and instantapp.is_instant_app() then
|
|
|
+ -- 如果它是 instant 游戏就存档然后显示提示信息
|
|
|
+ local cookie_size = instantapp.get_cookie_max_size()
|
|
|
+ if cookie_size > 0 then
|
|
|
+ instantapp.set_cookie(bytes_of_save_data)
|
|
|
+ end
|
|
|
+ instantapp.show_install_prompt()
|
|
|
+else
|
|
|
+ -- 其他一般游戏的逻辑代码
|
|
|
+end
|
|
|
+```
|
|
|
+
|
|
|
+关于在 Defold 里使用 Google Instant API 的详细信息请见 [API 文档](https://github.com/defold/extension-instantapp/blob/master/README.md).
|
|
|
+
|
|
|
+## 限制
|
|
|
+遵循 [Google Play Instant Technical Requirements](https://developer.android.com/topic/google-play-instant/game-tech-requirements) `apk` 大小不得大于 15 MB. 游戏大小优化详见 [这里](extension-fbinstant/#reducing-bundle-size).
|
|
|
+
|
|
|
+## 测试
|
|
|
+
|
|
|
+
|
|
|
+1. 下载 Android SDK 工具:
|
|
|
+- macOS: https://dl.google.com/android/repository/tools_r25.2.3-macosx.zip
|
|
|
+- Windows: https://dl.google.com/android/repository/tools_r25.2.3-windows.zip
|
|
|
+- Linux: https://dl.google.com/android/repository/tools_r25.2.3-linux.zip
|
|
|
+2. 解压拷贝 `tools` 文件夹到 `android-sdk` 文件夹.
|
|
|
+3. 安卓编译工具:
|
|
|
+```console
|
|
|
+./android-sdk/tools/bin/sdkmanager --verbose “build-tools;25.0.3”
|
|
|
+```
|
|
|
+4. 安装 `extra-google-instantapps` 工具:
|
|
|
+```console
|
|
|
+sh ./android-sdk/tools/android update sdk --no-ui --all --filter extra-google-instantapps
|
|
|
+```
|
|
|
+5. 在设备上作为 Instant 游戏加载 `apk` 文件:
|
|
|
+```console
|
|
|
+android-sdk/extras/google/instantapps/ia run path_to_your_game.apk
|
|
|
+```
|
|
|
+
|
|
|
+前4步可以合并为一个脚本:
|
|
|
+```console
|
|
|
+mkdir ~/android
|
|
|
+cd ~/android
|
|
|
+mkdir android-sdk
|
|
|
+# Supported: macosx,linux,windows
|
|
|
+PLATFORM=macosx
|
|
|
+TOOL_VERSION=25.2.3
|
|
|
+wget https://dl.google.com/android/repository/tools_r$TOOL_VERSION-$PLATFORM.zip
|
|
|
+tar xvf tools_r$TOOL_VERSION-$PLATFORM.zip
|
|
|
+mv tools android-sdk/tools
|
|
|
+./android-sdk/tools/bin/sdkmanager --verbose "build-tools;25.0.3"
|
|
|
+sh ./android-sdk/tools/android update sdk --no-ui --all --filter extra-google-instantapps
|
|
|
+```
|
|
|
+
|
|
|
+设备调试详情请见 [调试教程](/manuals/debugging/#_debugging_on_mobile_devices).
|
COCO