实战-Unity Addressable Assets实战篇章10-实战篇-从零搭建状态已完成阅读时间约 25 分钟一、引言1.1 本章在系列中的定位Addressable Assets简称 AA是 Unity 官方推出的资源管理解决方案目的是取代传统 AssetBundle。它的核心理念是资源位置 资源标签的解耦让开发者只关心我想要什么资源而不必关心资源在哪个包里。作为 Unity 官方的资源管理方案AA 与 YooAsset 在设计上有许多相似之处。本章将系统对比 AA 与 YooAsset帮助你深入理解 YooAsset 的设计取舍。1.2 本章要解决的核心问题Addressable Assets 的核心概念是什么AA 与 YooAsset 在架构上有何异同AA 的最佳实践是什么什么场景下选 AA什么场景下选 YooAsset1.3 阅读前置要求完成 10-01 YooAsset 项目搭建完成 10-02 Unity 原生 AB 实战了解 Unity 编辑器扩展基础二、Addressable Assets 核心概念2.1 安装通过 Package Manager 安装Window → Package Manager → 搜索 Addressables → Install安装后菜单栏会出现Window → Asset Management → Addressables。2.2 核心概念2.2.1 Address地址Address是资源的唯一标识符类似 YooAsset 的Location// YooAsset var op YooAssets.LoadAssetAsyncSprite(Assets/UI/Button.png); // Addressable var op Addressables.LoadAssetAsyncSprite(Button_Normal);AA 的 Address 可以是资源路径自定义标签资源 GUID2.2.2 Group组Group是资源的容器类似 YooAsset 的 GroupAA ├── Group_Default ← 默认组 │ ├── UI_Button_Normal.png │ ├── UI_Icon_Home.png │ └── ... ├── Group_Battle │ ├── Hero_Assassin.prefab │ ├── Skill_Fireball.prefab │ └── ... └── Group_Shared └── Atlas_Common.png2.2.3 Label标签Label是资源的软分组可以在运行时按标签批量加载Addressables.LoadAssetsAsyncSprite(ui_icons, null);2.2.4 Catalog目录AA 的 Catalog 类似 YooAsset 的 Manifest记录所有资源与 Group 的映射。2.3 Addressable 的工作流[Editor 端] 1. 标记资源为 Addressable 2. 配置 Group 3. 构建Build → New Build [Runtime 端] 1. Addressables.InitializeAsync() 2. LoadAssetAsync(address) 3. Release(handle)三、Addressable 实战3.1 标记资源步骤 1开启 AddressableWindow → Asset Management → Addressables → Groups步骤 2标记资源选中资源 → Inspector 中勾选AddressableSprite Icon_Home ├── Asset Name: Home ├── Address: icons/home └── Labels: [ui, icons]3.2 配置 Group// Group 配置示例 public class MyGroupConfig { public string GroupName Default Local Group; public BundleNamingStyle Naming BundleNamingStyle.NoHash; // 或 FileNameHash public bool IncludeInBuild true; public bool UseAssetBundleCache true; public bool UseAssetBundleCrc true; }3.3 加载资源using UnityEngine.AddressableAssets; using UnityEngine.ResourceManagement.AsyncOperations; public class AddressableLoader { /// summary /// 同步获取句柄 /// /summary public AsyncOperationHandleSprite LoadSprite(string address) { return Addressables.LoadAssetAsyncSprite(address); } /// summary /// 异步加载 /// /summary public async TaskSprite LoadSpriteAsync(string address) { var handle Addressables.LoadAssetAsyncSprite(address); await handle.Task; return handle.Result; } /// summary /// 按标签批量加载 /// /summary public async TaskListSprite LoadSpritesByLabel(string label) { var handle Addressables.LoadAssetsAsyncSprite(label, null); await handle.Task; return new ListSprite(handle.Result); } /// summary /// 释放 /// /summary public void ReleaseT(AsyncOperationHandleT handle) { Addressables.Release(handle); } }3.4 加载场景public async Task LoadSceneAsync(string address) { var handle Addressables.LoadSceneAsync(address, LoadSceneMode.Single); await handle.Task; } public void UnloadScene(AsyncOperationHandleSceneInstance handle) { Addressables.UnloadSceneAsync(handle); }四、AA 高级特性4.1 远端分发public class RemoteDistribution { /// summary /// 配置远端 CDN /// /summary public void SetupRemote() { // Profile 配置 var profile AddressableAssetSettingsDefaultObject.Settings.profileSettings.GetProfile(Remote); var remoteLoadPath profile.GetValueByName(RemoteLoadPath); var remoteBuildPath profile.GetValueByName(RemoteBuildPath); } /// summary /// 检查更新 /// /summary public async Task CheckForCatalogUpdates() { var checkHandle Addressables.CheckForCatalogUpdates(false); await checkHandle.Task; if (checkHandle.Result.Count 0) { // 有更新更新 Catalog var updateHandle Addressables.UpdateCatalogs(checkHandle.Result, false); await updateHandle.Task; } Addressables.Release(checkHandle); } }4.2 资源变体VariantsAA 支持按变体打包如中/英/日语言包Group_UI ├── ui_textures_zh ├── ui_textures_en └── ui_textures_japublic async TaskSprite LoadWithVariant(string baseAddress, string variant) { var address ${baseAddress}[{variant}]; return await Addressables.LoadAssetAsyncSprite(address).Task; }4.3 资源预加载public class ResourcePreloader { public async Task PreloadByLabel(string label, int priority 0) { var handle Addressables.LoadAssetsAsyncObject( label, null, Addressables.MergeMode.Union, releaseDependenciesOnFailure: false, priority: priority ); await handle.Task; } }4.4 内存管理public class AAMemoryManager { public void ReleaseAll() { // 释放所有引用 Resources.UnloadUnusedAssets(); } public long EstimateMemory() { // AA 不直接提供内存查询 // 需结合 Profiler return Profiler.GetTotalAllocatedMemoryLong(); } }五、AA vs YooAsset 对比5.1 架构对比维度AddressableYooAsset厂商Unity 官方tuyoogame 团队内核资源管理框架资源管理框架上层抽象ResourceManagerYooAssets异步系统AsyncOperationHandleAsyncOperationBase引用计数自动基于 handle显式基于 Release缓存Resource LocatorIFileSystem加密无内置支持断点续传内置内置跨平台完整完整含小游戏VFS 抽象无完整支持性能高高易用性★★★★★★★★文档丰富中等社区庞大活跃中文支持一般完善5.2 API 对比功能AddressableYooAsset加载资源LoadAssetAsyncT(address)LoadAssetAsyncT(location)按标签加载LoadAssetsAsyncT(label, callback)不直接支持需遍历加载场景LoadSceneAsync(address, mode)LoadSceneAsync(name, mode)释放Release(handle)op.Release()检查更新CheckForCatalogUpdatesRequestCheckVersionAsync更新目录UpdateCatalogsRequestPackageManifestAsync加载进度handle.PercentCompleteop.Progress取消加载Release(handle)op.Cancel()实例化InstantiateAsync(address)自己实现5.3 详细对比5.3.1 异步操作// Addressable var handle Addressables.LoadAssetAsyncSprite(icon); await handle.Task; var sprite handle.Result; // YooAsset var op YooAssets.LoadAssetAsyncSprite(icon); await op.Task; var sprite op.Result;差异AA 的 handle 需要手动 ReleaseYooAsset 的 op 同样需要 Release。两者 API 高度相似。5.3.2 批量加载// Addressable按 Label 加载 var handles Addressables.LoadAssetsAsyncSprite( ui_icons, sprite Debug.Log($Loaded: {sprite.name}) ); // YooAsset按 Tag 或遍历加载 // YooAsset 没有直接的批量加载 API // 需自己遍历资源差异AA 的 Label 系统更强大YooAsset 需要自己遍历。5.3.3 多 Package// Addressable通过不同的 Group 实现 // 一个 Group 一个 Package // 运行时通过 Address 自动路由 // YooAsset内置多 Package var package await YooAssets.LoadPackageAsync(ActivityPackage); var op package.LoadAssetAsyncSprite(activity_icon);差异YooAsset 的多 Package 更显式适合复杂业务场景。5.4 选型建议场景推荐理由全新 Unity 项目AA 或 YooAsset 均可两者都能满足中文项目YooAsset中文文档完善小游戏项目YooAssetYooAsset VFS 专为小游戏设计海外项目AA 或 YooAsset都支持已有 AA 项目继续用 AA迁移成本高已有 YooAsset 项目继续用 YooAsset迁移成本高多 Package 复杂业务YooAsset内置多 Package单机游戏AA简单易用联机游戏两者均可看团队偏好六、AA 性能优化6.1 内存优化// 1. 及时释放 public void OnDestroy() { if (_handle.IsValid()) Addressables.Release(_handle); } // 2. 预加载控制 public async Task PreloadCritical(string label) { var handle Addressables.LoadAssetsAsyncObject(label, null); await handle.Task; _criticalHandles.Add(handle); } // 3. 异步释放 public async Task UnloadCritical() { foreach (var handle in _criticalHandles) { Addressables.Release(handle); } _criticalHandles.Clear(); Resources.UnloadUnusedAssets(); }6.2 加载优化// 1. 并发控制 public async Task BatchLoad(Liststring addresses, int maxConcurrent 10) { var semaphore new SemaphoreSlim(maxConcurrent); var tasks addresses.Select(async address { await semaphore.WaitAsync(); try { return await Addressables.LoadAssetAsyncSprite(address).Task; } finally { semaphore.Release(); } }); return await Task.WhenAll(tasks); }6.3 构建优化// 1. 压缩配置 public class BuildConfig { public void Optimize() { // 在 Group 配置中 BundleMode BundlePackMode.PackTogetherByLabel; IncludeAddressInCatalog false; IncludeGUIDInCatalog false; IncludeLabelsInCatalog true; } }七、AA 踩坑记录7.1 常见问题问题原因解决方案资源找不到Address 拼写错误启用Addressable Asset Settings → Send Diagnostic Event内存泄漏忘记 Release配合 weak reference加载失败构建时未包含检查 Group 的 Include In Build跨域错误CDN 配置错误检查 Profile 中的 RemoteLoadPath场景加载慢资源未预加载用PreloadDependenciesAsyncHash 变化资源被修改启用Use Asset Bundle Cache7.2 调试技巧// 开启诊断事件 [InitializeOnLoadMethod] public static void EnableDiagnostics() { Addressables.ResourceManager.ResourceProviders .OfTypeIResourceProvider() .ToList() .ForEach(p { if (p is ResourceProvider rp) rp.DiagnosticEvent (op, type, ctx) Debug.Log($[AA] {type}: {ctx}); }); }7.3 监控面板public class AAMonitor { public void ShowStatus() { Debug.Log($正在下载: {Addressables.WebRequestOverride}); Debug.Log($已加载 Bundle: {GetBundleCount()}); Debug.Log($总内存: {Profiler.GetTotalAllocatedMemoryLong() / 1024 / 1024} MB); } }八、迁移到 YooAsset8.1 迁移评估评估项内容AA 资源数统计需要迁移的资源API 使用面列出所有 LoadAssetAsync 调用跨域资源是否有 CDN 资源自定义 Provider是否有自定义 ResourceProvider8.2 迁移工具public class AAToYooAssetMigrator { public void MigrateAddressables() { // 1. 读取 AA 配置 var aaSettings AddressableAssetSettingsDefaultObject.Settings; // 2. 创建 YooAsset Group foreach (var group in aaSettings.groups) { var yooGroup new PackRule { Name group.Name, Filter Assets/..., // 根据 Group 配置生成 }; } // 3. 转换 Address foreach (var entry in aaSettings.GetAllAssets()) { // entry.address → YooAsset Location } } }九、总结9.1 本章要点回顾AA 核心Address Group Label CatalogAA 工作流Editor 标记 → Build → Runtime LoadAA 优势Unity 官方、Label 系统、丰富的文档AA 痛点没有原生加密、引用计数相对隐式YooAsset 优势VFS小游戏、中文支持、多 Package9.2 与前后章节的关联前章10-02 介绍了 Unity 原生 AssetBundle本章对比 Addressable介绍 AA 与 YooAsset 的异同后章10-04 将介绍资源组织与依赖管理9.3 实践建议新项目选型根据团队熟悉度、是否需要小游戏、是否多语言决定不轻易切换AA ↔ YooAsset 切换成本高选定后就坚持用混合使用理论上可行但不推荐增加复杂度关注性能两者都需要关注内存、并发、构建时长上一篇Unity 原生 AssetBundle 实战下一篇资源组织与依赖管理实战