常见问题(FAQ)¶

安装与更新¶

Git URL 和 unitypackage 怎么选?¶

为什么更新器检测不到刚发布的版本?¶

版本检测按「直连 GitHub → 镜像站 → CDN 中转」三层兜底,能直连 GitHub 就是 100% 最新(窗口会显示本次直连是否可用)。只有当直连与镜像站都不可用、结果来自 CDN 中转时,才可能因分支缓存(最长约 12 小时)拿到旧版本 —— 此时窗口会给出延迟提示,可点「打开 Releases 页面」人工确认。

更新器能更新 Git URL(UPM)安装的包吗?¶

不能。更新器只管辖 Assets/Runestone/ 下的代码导入副本;UPM 副本请直接用 Package Manager 更新。开发仓库(存在 .git)切勿点更新 —— Release 内容会覆盖本地源码(窗口已内置警告)。

Git URL 分支策略是什么?¶

常驻分支 AesirArchitecture-latest / AesirModules-latest 由 CI 在每次推送 main 时自动按包目录 subtree split 滚动更新,分支名永久固定——Git URL 一次输入持续可用,升级 = Package Manager 移除后用同一 URL 重新添加。想锁旧版本请用 Release tag(?path=Assets/Runestone/<包目录>#v<版本>,tag 永久保留)或 Releases 页面的 unitypackage。(旧策略的版本分支 AesirXxx-v<版本> 随发版轮换并删除,已废弃——钉住它的 URL 会在发版后失效。)

安装 Aesir Modules 时为什么还要添加 Architecture 的 URL?¶

Modules 依赖 Architecture(必需)。UPM 对 Git URL 安装的包不会自动解析包内 dependencies 为 Registry 引用,因此两个包的 Git URL 都要添加(推荐同版本)。

使用问题¶

没装 Odin Inspector 能用吗?¶

能。核心架构流程闭环(Context 注册 → Model/Service 初始化 → Command/Query 执行 → ObservableValue 通知)与 UI 框架核心功能无 Odin 完整可用;Odin 相关代码经 #if ODIN_INSPECTOR 条件编译自动排除,只影响 Inspector 增强体验(AesirView<T> 系列基类、Binder、Drawer 等)。

示例怎么导入?会进构建吗?¶

• Git URL 安装:Package Manager → 选中包 → Samples 标签页按需 Import
• unitypackage 导入 / 本仓库浏览:示例随包内含,位于各包 Samples/ 目录
• 示例程序集为运行时程序集 + 整文件 #if UNITY_EDITOR:编辑器内可运行,玩家构建整体剔除(示例类型 0 入包)

示例场景打开后脚本 Missing / 无法挂载?¶

请确认使用 Unity / 团结引擎 2022.3+,并完整导入包(含 Samples)。本仓库直接浏览时示例就在 Samples/ 目录下,场景可直接打开运行。

高频陷阱与修法¶

完整 10 条陷阱清单见包内 Documentation/常见陷阱清单.md。异常消息已含修复指引(fail-fast)。

GetModel<T>() 抛"未注册"异常¶

按实现类注册、按接口获取(或反过来)—— Register 与 Get 必须使用相同类型参数(推荐都用接口)。异常消息含近失识别提示。

拿到了第二个 Context 实例 / 空引用¶

Configure() 与各模块 OnInitialize() 中禁止访问 Instance —— 会递归创建第二个上下文。模块间互相访问放到 OnInitialize()(此时全部已注册完毕)。

抛"该 Model 尚未初始化"¶

注册顺序错误或循环依赖 —— Configure 中被依赖的模块先注册(框架按注册顺序初始化 Model → Service)。

一个监听者抛异常后,后面的监听者不执行了¶

MiniEvent 是零分配直调,异常语义 = 原生 C# 事件(fail-fast)。监听回调不应抛异常(框架约定);业务异常在回调内部自行 try-catch。

GameObject 销毁后仍收到事件 / 内存泄漏¶

AddListener 返回的 AutoRemoveListenerHandle 未绑定生命周期。一行修法:

model.Count.AddListenerAndInvoke(OnCountChanged)
    .RemoveListenerWhenGameObjectOnDestroyed(gameObject);   // UI 面板用 RemoveListenerWhenGameObjectOnDisable

外部代码把我的事件链整体替换了(view.Xxx = null)¶

用 public Action Xxx { get; set; } 代替了 event。接口中声明 event Action Xxx; —— 编译期限制外部只能 += / -=。

事件模块(EventModule)与 MiniEvent 怎么选?¶

跨模块解耦、按 4 档优先级编排订阅者、需要精确投递过滤器或 Inspector 配置(SO 资产化 / UnityEvent 桥接)时用 EventModule;单类型自包含事件、追求零开销直调时用 MiniEvent / ObservableValue。两者可共存 —— EventModule 负责发布-订阅调度,MiniEvent / ObservableValue 负责"事件实例"与"数据驱动"语义。

未找到答案?¶

前往支持或在 GitHub Issues 提问(附复现步骤与 Unity 版本)。