SuperAPI AI 工具集

unity-addressables

编程与开发

查看项目

更新于 10-15 16:47

技能介绍

用途:管理 Unity Addressables 资源组、条目与内容构建,是 unity-asset-management 在内容分发方面的补充技能。

主要能力:列出或创建 Addressables 组;添加或移除条目;构建与清理 Addressables 内容;在发布前执行分析并自动修复问题。

推荐流程:先检查现有组,再用 addressables_manage 应用组或条目变更;构建前运行 addressables_analyze,仅在报告变更可接受时使用 fix_issues;最后用 addressables_build 构建,结构大幅变动时使用 clean_build。

常用命令: unity-cli raw addressables_manage --json '{"action":"list_groups"}' unity-cli raw addressables_manage --json '{"action":"create_group","groupName":"Characters"}' unity-cli raw addressables_manage --json '{"action":"add_entry","groupName":"Characters","assetPath":"Assets/Prefabs/Hero.prefab","address":"hero"}' unity-cli raw addressables_analyze --json '{"action":"analyze"}' unity-cli raw addressables_build --json '{"action":"clean_build"}'

适用场景:创建角色预制体等 Addressables 组并添加条目;分析问题后构建内容;重组组后执行干净构建。

限制:不适用于 Addressables 之外的通用资源导入设置或依赖分析(应使用 unity-asset-management),也不适用于场景对象搭建(应使用 unity-gameobject-edit 或 unity-scene-create)。运行前需满足连接与实例前提,参见 runtime-checklist.md;组变更、分析与干净构建的安全顺序参见 addressables-build-loop.md。