78 lines
3.8 KiB
Markdown
78 lines
3.8 KiB
Markdown
# FlowScope Addressables 集成验收记录
|
||
|
||
日期：2026-06-04
|
||
|
||
## 验收目的
|
||
|
||
本文用于补齐 P2 第一阶段的 Addressables 真实集成验收缺口。目标不是重新设计资源系统，而是确认当前 `FlowScope.Addressables.AddressablesResourceBackend` 能通过真实 Addressables key 完成加载、释放和错误诊断。
|
||
|
||
## 项目配置
|
||
|
||
已确认：
|
||
|
||
- `My project/Packages/manifest.json` 包含 `com.unity.addressables`，当前版本为 `1.21.21`。
|
||
- `My project/Assets/FlowScope/Addressables/FlowScope.Addressables.asmdef` 引用 `FlowScope.Runtime`、`Unity.Addressables`、`Unity.ResourceManager`。
|
||
- `My project/Assets/FlowScope/Tests/PlayMode/FlowScope.Tests.PlayMode.asmdef` 引用 `FlowScope.Addressables`。
|
||
- 当前项目已生成 `My project/Assets/AddressableAssetsData`。
|
||
- `My project/ProjectSettings/EditorBuildSettings.asset` 已登记 Addressables settings config object。
|
||
|
||
## 测试资源
|
||
|
||
真实 Addressables 测试资源：
|
||
|
||
- 路径：`Assets/FlowScope/Tests/PlayMode/Resources_moved/Fixtures/Addressables/FlowScopeAddressablesText.txt`
|
||
- 内容：`FlowScope Addressables Acceptance`
|
||
- GUID：`7e04733ce9dab74459592d3bd99fcafd`
|
||
- Addressables group：`Default Local Group`
|
||
- Addressables key：`FlowScope.Tests.Addressables.Text`
|
||
- 资源类型：`TextAsset`
|
||
|
||
`Default Local Group.asset` 中已确认存在：
|
||
|
||
```yaml
|
||
m_GUID: 7e04733ce9dab74459592d3bd99fcafd
|
||
m_Address: FlowScope.Tests.Addressables.Text
|
||
```
|
||
|
||
## 自动化验收
|
||
|
||
已在 `My project/Assets/FlowScope/Tests/PlayMode/Resources/AddressablesResourceBackendTests.cs` 补充真实 PlayMode 集成测试：
|
||
|
||
- `LoadAsync_WithRealTextAssetKey_LoadsTextAsset`
|
||
- `LoadAsync_WithMissingKey_ThrowsDiagnosticException`
|
||
- `LoadAsync_WithMismatchedType_ThrowsDiagnosticException`
|
||
|
||
覆盖范围：
|
||
|
||
- `AddressablesResourceBackend.LoadAsync<TextAsset>` 能通过真实 key 加载真实 `TextAsset`。
|
||
- `AddressablesResourceBackend.Release` 能释放已加载资源。
|
||
- 缺失 key 会产生可捕获诊断异常，并包含缺失 key。
|
||
- 类型不匹配会产生可捕获诊断异常，并包含 key 和请求类型。
|
||
|
||
本轮同时修复了 `AddressablesResourceBackend.LoadAsync<T>` 的失败状态处理：当 Addressables handle 存在 `OperationException`、`Status` 不是 `Succeeded` 或 `Result` 为 `null` 时，backend 会抛出包含 key、请求类型和 backend 名称的 `InvalidOperationException`。
|
||
|
||
## 验收结果
|
||
|
||
用户已在 Unity Test Runner 中执行全量 EditMode / PlayMode，结果全绿。
|
||
|
||
本轮针对 Addressables 集成用例的最终结果：
|
||
|
||
| 项目 | 结果 | 证据 |
|
||
| --- | --- | --- |
|
||
| 真实 `LoadAsync<TextAsset>` | 通过 | `FlowScope.Tests.Addressables.Text` 加载真实 `TextAsset` |
|
||
| `Release<TextAsset>` | 通过 | 成功释放已加载资源，未产生未处理日志 |
|
||
| 缺失 key 诊断 | 通过 | `FlowScope.Tests.Addressables.Missing` 产生可捕获异常 |
|
||
| 类型不匹配诊断 | 通过 | `TextAsset` key 以 `GameObject` 请求时产生可捕获异常 |
|
||
| Unity Test Runner EditMode | 通过 | 用户反馈全量 EditMode 全绿 |
|
||
| Unity Test Runner PlayMode | 通过 | 用户反馈全量 PlayMode 全绿 |
|
||
|
||
## 剩余注意事项
|
||
|
||
- 当前 Addressables 测试资源位于 `Resources_moved` 路径下；这是本轮真实验收的有效路径，但后续 package 迁移时应统一测试资源目录命名。
|
||
- `Assets/FlowScope/Tests/PlayMode/Resources/Fixtures` 当前只剩空目录 meta，属于提交前清理候选。
|
||
- 当前验收仍在主项目内完成；P2 后续 package 阶段还需要在干净 Unity 项目中验证本地 package path 或 Git URL 安装。
|
||
|
||
## 结论
|
||
|
||
P2 第一阶段的 Addressables 真实集成验收已完成。当前不再只是编译通过或人工步骤文档，而是已有真实 PlayMode 自动化测试覆盖成功加载、释放、缺失 key 和类型不匹配诊断。
|