feat(packages): 内置 SDK 包并完善 ContextLoader 集成

- 将 ShrinkEventBus、ShrinkDataSaver 及其 EventBus 集成从 gitlink 转为仓库直接维护的完整 UPM 包，补齐运行时、编辑器工具、测试与文档 - 新增 Command 和 Network 的 App 集成组件，支持 ContextLoader 服务发布、可逆注销及 Network Loopback 生命周期管理 - 更新 Starter 与演示组合逻辑，缺失模块时可注册、已有兼容安装器时可覆盖，并补充宿主启动断言 - 升级内部包依赖与 Shared CodeGen 包定义，放宽 Integration.App 包的 Git 忽略规则 - 将独立服务器生成器改为基于已编译程序集的语义扫描，支持 partial、复杂泛型、命名冲突检测及模板 SHA-256 覆写保护 - 新增 Network 语义扫描、模板保护和 App 组件生命周期测试 - 新增真实 UPM 消费工程验证脚本，校验内部版本一致性、程序集加载及 EditMode 测试 - 重构当前架构文档并归档已完成的 Cordis 迁移与旧代码地图
2026-08-18 18:06:34 +08:00
parent 517c4cf46e
commit d74c2f08ca
240 changed files with 13647 additions and 545 deletions
@@ -0,0 +1,200 @@
+using System;
+using System.Collections.Generic;
+using Cysharp.Threading.Tasks;
+using NUnit.Framework;
+
+namespace ShrinkEventBus.Tests
+{
+    [TestFixture]
+    public sealed class EventBusDispatchTests
+    {
+        private class PlainEvent : EventBase
+        {
+        }
+
+        private sealed class DerivedPlainEvent : PlainEvent
+        {
+        }
+
+        [Cancelable]
+        private sealed class CancelableEvent : EventBase
+        {
+        }
+
+        [HasResult]
+        private sealed class ResultEvent : EventBase
+        {
+        }
+
+        [Test]
+        public void TriggerEvent_ReturnsFalseWithoutSubscribers_TrueWhenHandled()
+        {
+            var bus = EventBus.CreateBus();
+
+            Assert.IsFalse(bus.TriggerEvent(new PlainEvent()));
+
+            bus.RegisterEvent<PlainEvent>(_ => { }, EventPriority.NORMAL);
+            Assert.IsTrue(bus.TriggerEvent(new PlainEvent()));
+        }
+
+        [Test]
+        public void CanceledEvent_SkipsHandlersUnlessReceiveCanceled()
+        {
+            var bus = EventBus.CreateBus();
+            var order = new List<string>();
+
+            bus.RegisterEvent<CancelableEvent>(evt =>
+            {
+                order.Add("canceler");
+                evt.SetCanceled(true);
+            }, EventPriority.HIGHEST);
+            bus.RegisterEvent<CancelableEvent>(_ => order.Add("skipped"), EventPriority.NORMAL);
+            bus.RegisterEvent<CancelableEvent>(evt => order.Add($"monitor:{evt.IsCanceled}"),
+                EventPriority.MONITOR, receiveCanceled: true);
+
+            var evt = new CancelableEvent();
+            bus.TriggerEvent(evt);
+
+            Assert.IsTrue(evt.IsCanceled);
+            CollectionAssert.AreEqual(new[] { "canceler", "monitor:True" }, order);
+        }
+
+        [Test]
+        public void SetCanceled_OnNonCancelableEvent_ThrowsWithMessage()
+        {
+            var evt = new PlainEvent();
+
+            var ex = Assert.Throws<UnsupportedOperationException>(() => evt.SetCanceled(true));
+            Assert.IsFalse(string.IsNullOrWhiteSpace(ex.Message));
+        }
+
+        [Test]
+        public void SetResult_OnEventWithoutResult_ThrowsWithMessage()
+        {
+            var evt = new PlainEvent();
+
+            var ex = Assert.Throws<InvalidOperationException>(() => evt.SetResult(EventResult.ALLOW));
+            Assert.IsFalse(string.IsNullOrWhiteSpace(ex.Message));
+        }
+
+        [Test]
+        public void SetResult_OnResultEvent_PersistsResult()
+        {
+            var bus = EventBus.CreateBus();
+            bus.RegisterEvent<ResultEvent>(evt => evt.SetResult(EventResult.DENY), EventPriority.HIGH);
+
+            var evt = new ResultEvent();
+            bus.TriggerEvent(evt);
+
+            Assert.AreEqual(EventResult.DENY, evt.Result);
+        }
+
+        [Test]
+        public void ParentSubscriber_ReceivesDerivedEvent()
+        {
+            var bus = EventBus.CreateBus();
+            var hits = 0;
+            bus.RegisterEvent<PlainEvent>(_ => hits++, EventPriority.NORMAL);
+
+            bus.TriggerEvent(new DerivedPlainEvent());
+
+            Assert.AreEqual(1, hits);
+        }
+
+        [Test]
+        public void ParentSubscriber_RegisteredAfterChildWasTriggered_StillReceivesChild()
+        {
+            var bus = EventBus.CreateBus();
+
+            // 先触发子事件，让子类型的监听列表先于父监听器创建（覆盖脏传播路径）
+            bus.TriggerEvent(new DerivedPlainEvent());
+
+            var hits = 0;
+            bus.RegisterEvent<PlainEvent>(_ => hits++, EventPriority.NORMAL);
+            bus.TriggerEvent(new DerivedPlainEvent());
+
+            Assert.AreEqual(1, hits);
+        }
+
+        [Test]
+        public void PerPhaseDispatch_OnlyRunsRequestedPhase()
+        {
+            var bus = EventBus.CreateBus(builder => builder.AllowPerPhaseDispatch());
+            var order = new List<string>();
+
+            bus.RegisterEvent<PlainEvent>(_ => order.Add("high"), EventPriority.HIGH);
+            bus.RegisterEvent<PlainEvent>(_ => order.Add("normal"), EventPriority.NORMAL);
+
+            bus.TriggerEvent(EventPriority.HIGH, new PlainEvent());
+
+            CollectionAssert.AreEqual(new[] { "high" }, order);
+        }
+
+        [Test]
+        public void PerPhaseDispatch_ThrowsWhenNotEnabled()
+        {
+            var bus = EventBus.CreateBus();
+
+            Assert.Throws<InvalidOperationException>(() => bus.TriggerEvent(EventPriority.HIGH, new PlainEvent()));
+        }
+
+        [Test]
+        public void TriggerEventAsync_RunsHandlersSequentiallyByPriority()
+        {
+            var bus = EventBus.CreateBus();
+            var order = new List<string>();
+
+            async UniTask AsyncHandler(PlainEvent evt)
+            {
+                order.Add("async-high");
+                await UniTask.CompletedTask;
+            }
+
+            bus.RegisterEvent<PlainEvent>(AsyncHandler, EventPriority.HIGH, receiveCanceled: false);
+            bus.RegisterEvent<PlainEvent>(_ => order.Add("sync-normal"), EventPriority.NORMAL);
+
+            var handled = bus.TriggerEventAsync(new PlainEvent()).GetAwaiter().GetResult();
+
+            Assert.IsTrue(handled);
+            CollectionAssert.AreEqual(new[] { "async-high", "sync-normal" }, order);
+        }
+
+        [Test]
+        public void TriggerEventAsync_AsyncHandlerCancellation_SkipsLaterHandlers()
+        {
+            var bus = EventBus.CreateBus();
+            var order = new List<string>();
+
+            async UniTask CancelingHandler(CancelableEvent evt)
+            {
+                evt.SetCanceled(true);
+                order.Add("async-canceler");
+                await UniTask.CompletedTask;
+            }
+
+            bus.RegisterEvent<CancelableEvent>(CancelingHandler, EventPriority.HIGHEST, receiveCanceled: false);
+            bus.RegisterEvent<CancelableEvent>(_ => order.Add("skipped"), EventPriority.NORMAL);
+
+            bus.TriggerEventAsync(new CancelableEvent()).GetAwaiter().GetResult();
+
+            CollectionAssert.AreEqual(new[] { "async-canceler" }, order);
+        }
+
+        [Test]
+        public void GetSubscribers_ReturnsDefensiveCopyOfDispatchSnapshot()
+        {
+            var bus = EventBus.CreateBus();
+            bus.RegisterEvent<PlainEvent>(_ => { }, EventPriority.NORMAL);
+
+            var evt = new PlainEvent();
+            bus.TriggerEvent(evt);
+
+            var first = evt.GetSubscribers();
+            Assert.AreEqual(1, first.Length);
+
+            first[0] = null;
+            var second = evt.GetSubscribers();
+            Assert.IsNotNull(second[0]);
+        }
+    }
+}