发布到淘宝小游戏

环境配置

  • 桌面端下载 淘宝开发者工具 并安装。

  • 下载 淘宝，并安装到手机设备上。

  • 淘宝客户端在 Android 上支持的最低版本为 10.22.30，在 iOS 为 10.22.30。

发布流程

使用 Cocos Creator 打开需要发布的项目工程，在 构建发布 面板的 发布平台 中选择 淘宝小游戏，然后点击 构建。

build option

参数项配置

相关参数配置具体的填写规则如下：

  • 主包压缩类型

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

  • 配置主包为远程包

    该项为可选项，需要与 资源服务器地址 选项配合使用。
    勾选后，主包会配置为远程包，并且与其相关依赖资源一起被构建到发布包目录 remote 下的内置 Asset Bundle — main 中。开发者需要将整个 remote 文件夹上传到远程服务器。

  • 初始场景分包

    该项为可选项。
    勾选后，首场景及其相关的依赖资源会被构建到发布包目录 assets 下的内置 Asset Bundle — start-scene 中，提高初始场景的资源加载速度。具体内容可参考文档 初始场景的资源加载。

  • 资源服务器地址

    该项为选填项，用于填写资源存放在远程服务器上的地址。开发者需要在构建后手动将发布包目录下的 remote 文件夹上传到所填写的资源服务器地址上。

  • 分离引擎 该项为可选项。
    勾选后，可以减小游戏的首包大小。使用方法可以参考文档 使用说明，其中构建平台选择淘宝小游戏。

运行预览

  • 构建完成后点击 构建任务 左下角的文件夹图标按钮，可以看到在项目的 build 目录下生成了淘宝小游戏工程文件夹 taobao-mini-game，其中已经包含了淘宝小游戏环境的配置文件 game.json。

build

  • 使用 淘宝开发者工具 打开构建生成的 taobao-mini-game 文件夹，即可打开淘宝小游戏项目以及预览调试游戏内容。

preview

淘宝小游戏环境的资源管理

淘宝小游戏与微信小游戏类似，都存在着包体限制，超过 4MB 的额外资源，必须通过网络请求下载。
当包体过大时，可在 构建发布 面板配置 资源服务器地址 选项，将资源上传到远程服务器，详情请参考 上传资源到远程服务器。

我们建议用户只保存脚本文件在小游戏包内，其他资源都从远程服务器下载。Cocos Creator 已经帮用户做好了远程资源的下载、缓存和版本管理，详情请参考 缓存管理器。

淘宝小游戏的限制

不支持以下模块：

  • WebView
  • VideoPlayer
  • 自定义字体

淘宝与其他小游戏平台的差异

  • 全局变量的访问，需要挂载到 global 变量上。例：$global.my = my;
  • ‘global-variables.js’ 说明: window 变量是 global 的引用，需要先确保 global上变量已经存在，定义的临时变量才会有值。若使用自定义脚本或使用第三方插件，发现全局变量不存在，通常是加载时机问题导致脚本还没被加载，就使用到了脚本内的全局变量。
  • 淘宝的 js 虚拟机是自研的，不是基于 v8 开发。draw call 次数相比其他平台对帧率的影响更大，应该尽量减少 draw call 的次数。 引擎中可以开启图集合批功能来降低 draw call 次数，在creator 项目设置中，开启 CLEANUP_IMAGE_CACHE，在构建的 taobao-mini-game/src 目录下查找 settings.json, 修改 CLEANUP_IMAGE_CACHE 为 false。
  • 淘宝 IDE, 模拟器和真机的 JS 环境是不一致的；若是真机无问题，直接把问题反馈给淘宝平台
  • 由于真机调试模式会有额外的性能开销，因此在验证帧率的时候应该使用真机预览模式，而非真机调试模式

相关文档