CDN + xasset

开箱即用的分布式打包工具 xasset

• 快速优化打包质量: xasset 提供开箱即用的分布式打包工具， 不仅可以实时直观的预览资源的依赖关系，还可以使用自动分组快速优化打包质量。仅需几分钟就能上手。
• 灵活把控安装大小: xasset 提供配置驱动的分包机制，不仅可以使用工具快速生成分包数据，还会自动剥离不在安装包中的数据。支持谷歌分包机制，一键发布谷歌商店应用。
• 按需处理更新下载: xasset 最小按资源为单位把控更新范围，已经加载的内容无需重启可以自动热重载，可以轻松获取每个下载的速度、进度和大小。多平台加载接口统一，一次编码到处运行。
• 全面保障运行性能: xasset 提供了负载均衡技术支持，可以轻松调整业务并发数量和处理时间，并通过自动切片技术来优化卡顿。 使用性能开销极低的加密措施为资源增加安全保护。采用异步渐进式回收来避免GC卡顿，所有高密集耗时长的业务都可以通过负载均衡机制得到更平滑的处理。同时支持仿真模式，编辑器开发可以跳过打包快速运行，也可以在打包后无缝调试真机热更加载过程，开发效率快到爆表。

了解更多 体验示例 GitHub

UOS CDN + xasset 使用示例

下载

首先创建一个空的 Unity Project，前往 xasset GitHub 下载工具包，解压后把 Assets 目录下的 xasset 文件夹复制到 Unity Project 的 Assets 文件夹下。

2. 创建和上传资源

打开 Unity Project 并点击 「xaseet -> Build Bundles」 创建 bundles 文件，可在 Unity Project 项目文件夹中看到新建的 Bundles 和 BundlesCache 文件夹（平台自适应）。

创建完成后，将 xasset 打包输出的 Bundles 目录及资源同步到云端。

// [BUCKET ID] 可在 UOS CDN 服务中创建存储桶(Bucket)后获取
$ uas entries sync [Unity Project Path]/Bundles Bundles --bucket [BUCKET ID]

3. 设置

点击 「xaseet -> open -> Settings」 打开设置，将云端资源路径配置到 xasset 的 Update Info URL 与 Download URL 。

// 需要将此处 [BUCKET ID] 替换成 UOS CDN Bucket Id
https://a.unity.cn/client_api/v1/buckets/{bucketId}/entry_by_path/content/?path=

选择 「xaseet -> Build Update Info」 选择项目文件夹下 Bundles -> [平台文件夹] -> versions_v1.json 文件。配置完路径文件后，上传 xasset 按平台build之后的 updateinfo.json 文件

// 注意此处上传到是 BundlesCache 文件夹下的 updateinfo.json 文件
// 需要将此处 [Unity Project Path] 替换为你项目所在的文件夹位置，[BUCKET ID]替换成UOS CDN Bucket Id
$ uas entries copy [Unity Project Path]/BundlesCache/OSX/updateinfo.json Bundles/OSX/updateinfo.json --bucket [BUCKET ID]

上传完成后可至 UOS 开发平台查看上传文件的列表。

4. 演示示例

在完成 UOS 相关设置后，配置 Assets 路径文件，「xaseet -> Build Player Assets」，同样选择项目文件夹下 Bundles -> [平台文件夹] -> versions_v1.json 文件。

选择 「xaseet -> open -> Startup Scene」 打开 Startup 示例场景，点击运行按钮，从控制台的 Log 中可以看到远端资源的下载。

至此，您已经完成了 UOS 与 xasset 的搭配操作，期待您在后续的探索中有更多的发现。

UOS CDN + xasset 进阶示例

Badge 可方便您选择应用程序使用的发布版本。在接下来的内容中，将介绍如何使用 Badge 更好地区分程序版本，为开发、测试、用户等不同人员提供便利。

1. 上传

首先，准备两个 bucket 并按照上文 「UOS CDN + xasset 使用示例」，将 xasst 打包出的 Bundles 文件夹上传到第一个 bucket 中。

2. 配置并运行

点击 「xaseet -> open -> Settings」 打开设置，将云端资源路径配置到 xasset 的 Download URL 中，Update Info URL 稍后再填写。 选择 「xaseet -> Build Update Info」 选择项目文件夹下 Bundles -> [平台文件夹] -> versions_v1.json 文件。并将更新了路径信息的 BundlesCache 文件夹下的 updateinfo.json 上传到另一个桶中，并创建第一个 Release。

新建 Release 后，为该 Release 设置一个 Badge，示例中为 "originalVersion"，点击 「复制 Entry URL 前缀」，并将其粘贴在 Update Info URL 处。

点击 「xaseet -> Build Player Assets」，选择项目文件夹下 Bundles -> [平台文件夹] -> versions_v1.json 文件，即可运行 Startup 示例场景，此时您将看到如上文示例中一样的画面。

3. 修改并上传资源

若您对项目资源进行了修改，本示例将 「xasset -> Samples -> Textures」 的 PPJT.png 进行了替换 (或修改)。

点击 「xaseet -> Build Bundles」 重新打包资源文件 (依旧是原来的 Bundles 和 BundlesCache 文件夹，改动后每打包一次都会生成一个新 version_vx.json 文件)，将 Bundles 文件夹以同样的方法上传到第一个 bucket 中，可以看到最新改动的 bundle 文件。

4. 更新版本

点击 「xaseet -> Build Update Info」 选择项目文件夹下 Bundles -> [平台文件夹] -> versions_v2.json 文件。将更新过的 BundlesCache 文件夹下的 updateinfo.json 上传到另一个桶中 (覆盖)。 上传完成后，为该 Bucket 创建新的 Release ，可以为该 Release 设置一个新的 Badge ，此处直接使用 latest 标示，并可在后续更新中一直使用该标签以获取最新的改动。

点击 「复制 Entry URL 前缀」，并将其更新到 Update Info URL 处。

点击 「xaseet -> Build Player Assets」，选择项目文件夹下 Bundles -> [平台文件夹] -> versions_v2.json 文件，同时 「xaseet -> Clear Download」 清空之前的下载内容后即可重新运行 Startup 示例场景。

可以看到，新的运行已经可以获取到改动后的图片资源了。您也可以按照此方法，继续更新、打包并上传项目资源，修改 updateinfo.json 并通过 latest 标示一直加载最新资源，也可以根据需求使用不同的 badge 灵活加载。