doc/docs/zh/manuals/extension-googleplayinstant.md

---

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> 属性：

   xmlns:dist="http://schemas.android.com/apk/distribution"
   android:targetSandboxVersion="2"
   

后面紧跟描述项：

<dist:module dist:instant="true" />

结果 AndroidManifest.xml 类似这样：

<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" />

1. 在 "game.project" 文件里添加 Google Instant Apps 扩展。加入 "https://github.com/defold/extension-instantapp/archive/master.zip" 地址依赖或者指定 特定版本 的依赖。

1. 下载库文件：Project->Fetch Libraries
2. 打包 aab：Project->Bundle->Android Application
3. 上传 aab 至 Google Play Console 作为 Android Instant App 发布

版本号

注意 关于版本号的建议：Instant 游戏版本号要小于可安装游戏的版本号。

android:targetSandboxVersion="2"

如果在可安装主游戏里设置 android:targetSandboxVersion="2" 就可以像 instant 游戏一样访问数据（比如存取同一个文件）。但是这样一来主游戏程序就可能会受到一些限制。详情请见 官方文档。 ::: sidenote 游戏一旦安装，它的目标沙箱值只能增加。要想降级，只能把游戏删除再覆盖安装 manifest 属性里目标沙箱值较小的版本。 ::: 即使在可安装游戏和 instant 游戏里的 android:targetSandboxVersion 设置了不同的值，仍然可以使用 instantapp.set_cookie() 和 instantapp.get_cookie() 来进行游戏版本间通信。

API 使用

Google Play Instant 扩展使用 instantapp.* 命名空间封装了 Java PackageManagerCompat 方法 API 供 Lua 使用。

如果你要制作跨平台游戏最好在使用前检查 instantapp 模块是否存在，因为它只存在于安卓游戏包中：

if instantapp then
  -- 调用 instantapp 方法
end

例如:

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 文档。

限制

遵循 Google Play Instant Technical Requirements apk 大小不得大于 15 MB。游戏大小优化详见 这里。

测试

1. 下载 Android SDK 工具：
2. macOS: https://dl.google.com/android/repository/tools_r25.2.3-macosx.zip
3. Windows: https://dl.google.com/android/repository/tools_r25.2.3-windows.zip
4. Linux: https://dl.google.com/android/repository/tools_r25.2.3-linux.zip
5. 解压拷贝 tools 文件夹到 android-sdk 文件夹。

6. 安卓编译工具：

   ./android-sdk/tools/bin/sdkmanager --verbose "build-tools;25.0.3"
   

7. 安装 extra-google-instantapps 工具：

   sh ./android-sdk/tools/android update sdk --no-ui --all --filter extra-google-instantapps
   

8. 在设备上作为 Instant 游戏加载 apk 文件：

   android-sdk/extras/google/instantapps/ia run path_to_your_game.apk
   

前4步可以合并为一个脚本：

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

设备调试详情请见 调试教程。