Cocos Creator

简体中文

English

简体中文

English

主题

Cocos Creator

发布到 Google Play Instant ​

从 v2.0.4 版本开始，Cocos Creator 正式支持将游戏发布到 Google Play Instant。Google Play Instant 依赖于 Google Play，并不是一个新的分发渠道，而更接近一种游戏微端方案。它能够实现游戏的免安装即开即玩，有利于游戏的试玩、分享和转化。它和 Android Instant App 的主要区别在于：

  • 首包和 APK 附加包都限制在 10MB 以内（而不是 4MB）
  • 可以从第三方 CDN 动态加载不含二进制代码的资源（JS 也可以）
  • APK 附加包只能从 Google Play Store 下载，可以包含二进制代码和资源，可以后台加载，不需要切换 activity。

采用 Cocos Creator 开发的游戏，只需选择 Google Play Instant 作为发布平台，就可以自动完成标准适配工作，输出符合 Google Play Instant 技术标准的游戏。

环境配置 ​

  • 需要使用 Android Studio 3.0 版本及以上
  • Android Phone 6.0 及以上
    注意：Android SDK 版本在 6.0 到 7.0 之间的设备需要安装 Google 服务框架，SDK 版本在 8.0 以上的则不需要，可直接安装使用。
  • NDK 建议使用的版本为 r17 - r19

发布流程 ​

  1. 使用 Cocos Creator 打开需要发布的项目工程，从 菜单栏 -> 项目 中打开 构建发布 面板，发布平台 选择 Android Instant，API Level 选择 android-26 及以上。

  2. 如果希望直接打包而不使用分包功能的话，可以勾选 跳过录制和分包，然后直接点击 构建 -> 编译 -> 运行，连接手机之后即可看到 Google Play Instant 的运行效果。

    首次编译的话需要用 Android Studio 打开构建后的工程以下载 Google Play Instant Development SDK（windows 平台） 支持包，Mac 平台为 Instant Apps Development SDK 支持包。如果下载不成功的话建议设置一下 Android Studio 的 HTTP 代理。

  3. 如果需要进行分包操作就在 构建发布 面板点击 录制，该操作将会打开模拟器。然后进行游戏，模拟器会根据游戏流程自动记录游戏过程中使用到的资源信息。

  4. 录制完成后，点击 分包，该操作将会打开分包界面来完成分包操作。具体的分包步骤请查看下方的 分包器。

  5. 分包完成后，在 构建发布 面板中选择 分包配置路径 -> ...，该步骤会打开 profiles 文件夹来选择分包记录所在的路径（分包记录保存在 path_to_your_project/temp/android-instant-games/profiles 目录下）。用户可以通过删除对应的文件夹来删除不需要的分包记录。

  6. 在 构建发布 面板中点击 构建，就会使用该分包记录进行首包的分割。然后点击 编译 -> 运行 并确保手机跟 PC 在同一个局域网内，就可以测试游戏运行的情况了。

    若之前已经运行过游戏，要再次运行新的项目工程，需要在手机上将之前的游戏进程关闭，否则新的项目工程会因为端口被占用而导致无法在手机上运行。

相关配置说明 ​

构建发布 面板中关于发布到 Google Play Instant 的几个主要配置说明如下：

  • 主包压缩类型

    设置主包的压缩类型，具体内容可参考文档 Asset Bundle — 压缩类型。

  • 资源服务器地址

    远端资源的下载地址，可以是 CDN 地址，将 path_to_your_project/build/jsb-link/remote_assets 文件夹放入服务器或者 CDN 中即可，Creator 会去这个地址下载没有在首包当中的资源。注意：填写资源服务器地址时不用包含 /remote_assets。

  • 启动 URL

    Google Play Instant 会根据这个协议启动对应的应用和对应的 activity。该参数可为空，若不为空，当提交到 Google Store 的时候需要确保输入的 URL 是可以访问的。详情请查看 Google Instant App 文档。

  • 分包配置路径

    Creator 会根据这个分包配置生成首包的资源。

  • 生成 App Bundle (Google Play)

    勾选该项后，即可将游戏打包成 App Bundle 格式用于上传到 Google Play 商店。具体请参考 官方文档。

注意：如果 Google Play Instant 包的权限大于 Google Store 上 APP 的权限，在安装 APP 的时候可能会导致无法正常安装：

分包器 ​

分包器，主要用来编辑游戏的首包，选择放入首包的资源。

使用方法 ​

  1. 当录制完成后，选择 分包 就会打开分包界面，如上图所示

  2. 分包器默认打开的是最新的录制记录。也可以通过 + 打开记录 来打开之前的记录进行对比。切换不同的录制记录，下方资源的文件数量和资源大小等数据也会随着变化。

  3. 拖动录制记录中的 终止点，可以选择分入首包的资源。当拖动终止点时，下方文件列表的文件数量和总大小等数据也会随着变化。选择合适游戏的首包大小，即可粗略的分好首包资源。

  4. 分包器可以对所有资源进行调整。在文件列表的页面，展开各个分类的节点，可以看到对应各个文件的大小，取消 操作 的打钩就可以手动 取消 某个资源放入首包当中

  5. 如果想要把终止点之后的资源放入首包中，可以点击左下角的 + 手动添加 选择资源添加。只需要找到对应资源并在资源后面打上勾，然后点击 添加 即可

  6. 如果还有额外的资源需要加入首包，那么也可以从 资源管理器 面板选择资源，并拖拽进入 分包器 面板即可

  7. 分包完成之后，点击 保存。

Android Studio 支持 ​

  • Cocos Creator 推荐使用 Android Studio 进行编译

  • 对 Android 工程的其他修改，我们可以使用 Android Studio 直接打开工程，对 Android 工程进行其他代码的集成（工程路径：path_to_your_project/build/jsb-link/frameworks/runtime-src/proj.android-studio）

  • 在 Android Studio 中可以对 SDK 版本进行修改，修改路径及最低支持版本如下：

我们提供了一些 API 方便开发者直接调用 Google 的一些功能，目前开放了 Instant Google Cookie API，详情请前往谷歌文档查看。同时，我们也提供了 API 相关的 demo：AndroidInstantCookieDemo

相关参考链接 ​

基于 MIT 许可发布

版权所有 © 2019-2024 Cocos