版本 CDN 服务

一、使用 CDN 服务

使用自己已有的 CDN 网络

• 相应设置到自己工程的 AA Profile 配置档中

二、版本资源构建、部署

1. 设置 AA profile：本地构建路径
2. 设置 AA profile：加载路径
3. 构建资源
4. 本地输出 bundles
5. 上传到 CDN
6. 最后：打包 Build 版本 Apk

下面小节，对此进行详述。

三、构建和上传部署 bundle 文件

首先，正式发布版本，一般推荐选择 AA profile:ttcdn

设置一个使用自己已有的 CDN 网络。

查看原图

以下以 AA profile:ttcdn为例，分步介绍该 profile 设置中相关的路径、变量。

1.设置 AA profile：构建路径 RemoteBuildPath

查看原图

RemoteBuildPath变量决定：编辑器构建输出 bundle 的本地目录。

2.设置 AA profile：加载路径 RemoteLoadPath

查看原图

设置界面

RemoteLoadPath变量决定：运行时加载 bundle 的远端 url。

例如：{AddressableConfig.CdnRootUrl}/[CdnProjPath]/[BuildTarget]

• 其中：{AddressableConfig.CdnRootUrl} 使用了花括号，是引用一个类的 static 属性，运行时动态解析。
• 此时应当在游戏启动代码中，将它 set 赋值为实际使用的 CDN 根目录 url。

例如：

// in your game initialize code
AddressableConfig.CdnRootUrl =
  "https://lf3-stark-cdn.bdgp.cc/obj/game-res-cn/ucmc" // 举例：默认使用我们字节游戏StarkContainer这边的CDN根目录

// AddressableConfig.CdnRootUrl = "https://sf1-ttcdn-tos.pstatp.com/obj/game-res-cn/ucmc"; // 2021.08.23 已废除旧域名

AddressableConfig.CdnRootUrl = "https://your-cdn-site.com/obj/res" // 举例：使用你自定义的CDN站点的根目录

// then, more initialize codes, load assets after this ...

查看原图

• CdnRootUrl 应当设置的链接网址，可以从你的 CDN 服务页面去寻找， 例如：此页面中的【复制下载链接】，例如得到：https://lf3-stark-cdn.bdgp.cc/obj/game-res-cn/ucmc/mushroomch.mini/_dummy.txt 然后再去掉自己工程的那些子目录和文件的字符串部分（/mushroomch.mini/_dummy.txt ），即可 上图箭头位置下载
• 其中：[CdnProjPath] 使用了中括号，引用另一个编辑器变量，为你的工程的子目录路径， 可以设置为：

例如：YourGameName/test

例如：mushroomch.mini/release

• 以上全部拼接后，最终 RemoteLoadPath 会解释为例如：
• 【可选】或者，也可以把 <span style="background-color: rgba(245, 246, 247, 1)"><strong>RemoteLoadPath</strong></span>** **整个变量手动修改为完整 url。

例如这样填写并拼接：

查看原图

查看原图

• 【注意】1：profile 配置档变量有修改后，应及时 Ctrl/Cmd + S 保存。
• 【注意】2：对于 Play Mode 3: Use Existing Build 模式的调试、以及对于打包 Android Apk 构建出版本：

profile 配置档变量有修改后（例如修改加载 CDN url、子目录文件夹），必须再次“构建 AA 资源”才能正确生效。

保证构建最新 AA 资源后，然后再调试、打包。

3.构建 AA 资源

构建 AA 资源 bundle 应完成：

• 选择 AA profile（例如 ttcdn）
• 构建 AA 资源，输出 bundle 文件

4.本地输出

找到构建输出的本地目录：

此目录对应 AA profile 中的 RemoteBuildPath变量配置。

例如：/ServerData/ttcdn/Android

查看原图

5.上传到 CDN

将上一步输出目录所有内容，上传部署到 CDN 服务的某个子目录，应与 AA profile 中的 RemoteLoadPath变量匹配。

6.检查确认 url 正确性

通过以下几种方法，确认所 build 的 AA 资源配置的 url，与实际 hosting 工具 或 真实 CDN 网络上资源的下载链接，进行比对，以确认 url 正确性。

• 可以通过选择一个 AA Group，确认检查 inspector 面板中的 LoadPath；

检查 LoadPath

• 可以编辑器中，确认 AA 配置窗口选择 profile（例如 ttcdn）、并选择 Play Mode: 3. Use Existing Build，编辑器 Play 运行后，检查这样格式的 log：AssetBundle - First request url:
• 可以打开工程目录中 build 构建 AA 资源后的 catalog.json，该文件位于例如：Library/com.unity.addressables/aa/Android/catalog.json，其中找到任意一个htttp开头的*.bundle 的 url，即可确认。
• 可以构建 Apk 并真机运行游戏，adb logcat 检查这样格式的 log：AssetBundle - First request url:

7.最后：打包 Build 版本 Apk

8.每当更新 CDN 资源

涉及包括 bundle 资源本身变更、要更新部署到 CDN，或修改 CDN url 更改，或者更改 CDN 上子目录等情况时需按以下步骤操作：

• 如果有 url、子目录变动，确认 Editor 中修改 AA Profile 配置档
• Editor 中执行：构建 AA 资源。
• 部署更新到 CDN 网络。
• 最后打包构建游戏包 APK