Back to Details

unity-addressables

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Unity Addressables

Unity Addressables

Purpose

目的

Use Addressables with explicit grouping, loading, update, and fallback rules instead of ad hoc content loading.
采用具有明确分组、加载、更新和回退规则的Addressables，而非临时内容加载方式。

Use When

适用场景

  • the Unity project uses Addressables
  • downloadable or patchable content exists
  • memory and content lifetime need stronger structure
  • Unity项目使用Addressables
  • 存在可下载或可补丁更新的内容
  • 需要更严谨的内存与内容生命周期管理结构

Inputs

输入信息

  • content groups
  • platform needs
  • patching model
  • offline behavior requirements
  • 内容分组
  • 平台需求
  • 补丁更新模型
  • 离线行为要求

Process

实施流程

  1. group content by lifetime, dependency behavior, and update cadence
  2. avoid scattered string-based address lookups
  3. document environment and catalog strategy
  4. test offline, slow-download, cache, and corruption cases
  5. review patch-size and duplication risk before release
  1. 按生命周期、依赖行为和更新节奏对内容进行分组
  2. 避免分散的基于字符串的地址查找
  3. 记录环境与目录策略
  4. 测试离线、慢速下载、缓存和内容损坏场景
  5. 发布前检查补丁大小和重复风险

Outputs

输出成果

  • Addressables strategy
  • group rules
  • loading/fallback expectations
  • QA scenarios
  • Addressables策略
  • 分组规则
  • 加载/回退预期
  • QA测试场景

Quality Bar

质量标准

  • respects Unity lifecycle, serialization, and content authoring realities
  • keeps editor/runtime/test boundaries clean
  • prevents scene, prefab, and package complexity from becoming hidden architecture
  • 遵循Unity生命周期、序列化和内容创作的实际情况
  • 保持编辑器/运行时/测试边界清晰
  • 避免场景、预制件和包的复杂性演变为隐藏架构

Common Failure Modes

常见失败模式

  • inspector wiring being the only source of truth
  • overusing MonoBehaviours or scene setup as architecture
  • package or scene drift reaching release without review
  • 检查器连线作为唯一的事实来源
  • 过度依赖MonoBehaviours或场景设置作为架构基础
  • 包或场景漂移未经过审查就发布

Related Agents

相关Agent

  • unity-reviewer
  • build-engineer
  • technical-artist
  • unity-reviewer
  • build-engineer
  • technical-artist

Related Commands

相关命令

  • unity-review
  • unity-build-fix
  • verify
  • unity-review
  • unity-build-fix
  • verify

Notes

注意事项

  • Keep this skill aligned with the relevant rules layer and current project documentation.
  • If engine-specific constraints materially change the workflow, hand off to the matching engine skill or engine-specific reviewer.
  • 保持此skill与相关规则层和当前项目文档一致。
  • 如果引擎特定约束显著改变工作流程，移交至匹配的引擎skill或引擎特定审核人员。