feat(cordis): 接入上下文组合与模组事务热替换

2026-08-16 23:20:40 +08:00
commit ad256f109b
676 changed files with 52168 additions and 0 deletions
@@ -0,0 +1,99 @@
+#nullable enable
+using System.Collections.Generic;
+using Cysharp.Threading.Tasks;
+using NUnit.Framework;
+using ShrinkCommand.Integration;
+using ShrinkCommand.Integration.App;
+using ShrinkContext;
+using ShrinkDataSaver.Integration.App;
+using ShrinkNetwork;
+using ShrinkNetwork.Integration.App;
+
+namespace ShrinkCommand.Integration.Network.Tests
+{
+    /// <summary>
+    /// 阶段 3 集成组件模式（论文 6.5）：
+    /// 核心（command/network/datasaver）互不依赖，集成组件注入双方服务键；
+    /// 全部提供者就绪才激活，任一退役即停用——依赖接线由响应式余效应完成。
+    /// </summary>
+    public class IntegrationComponentsTests
+    {
+        private ShrinkContextRuntime _runtime = null!;
+
+        [SetUp]
+        public void SetUp()
+        {
+            _runtime = new ShrinkContextRuntime();
+        }
+
+        [TearDown]
+        public void TearDown()
+        {
+            _runtime.ShutdownAsync().GetAwaiter().GetResult();
+        }
+
+        private static void Run(UniTask task) => task.GetAwaiter().GetResult();
+
+        [Test]
+        public void Integration_ActivatesOnlyWhenBothProvidersActive()
+        {
+            var integration = _runtime.Use(new ShrinkCommandNetworkIntegrationComponent());
+            Assert.AreEqual(ShrinkFiberState.Inactive, integration.State, "两个服务键都缺失时等待");
+
+            var command = _runtime.Use(new ShrinkCommandAppComponent());
+            Assert.AreEqual(ShrinkFiberState.Active, command.State);
+            Assert.AreEqual(ShrinkFiberState.Inactive, integration.State, "仅命令服务就绪仍等待网络服务");
+
+            var network = _runtime.Use(new ShrinkNetworkAppComponent());
+            Assert.AreEqual(ShrinkFiberState.Active, network.State);
+            Assert.AreEqual(ShrinkFiberState.Active, integration.State,
+                "双键齐备后集成组件激活并完成桥注册");
+        }
+
+        [Test]
+        public void EitherProviderRetire_DeactivatesIntegration_AndReactivatesOnReturn()
+        {
+            var command = _runtime.Use(new ShrinkCommandAppComponent());
+            var network = _runtime.Use(new ShrinkNetworkAppComponent());
+            var integration = _runtime.Use(new ShrinkCommandNetworkIntegrationComponent());
+            Assert.AreEqual(ShrinkFiberState.Active, integration.State);
+
+            Run(_runtime.RetireAsync(network));
+            Assert.AreEqual(ShrinkFiberState.Inactive, integration.State,
+                "网络提供者退役，集成组件自动停用（服务键撤回触发）");
+            Assert.AreEqual(ShrinkFiberState.Active, command.State, "命令核心不受影响");
+
+            var networkAgain = _runtime.Use(new ShrinkNetworkAppComponent());
+            Assert.AreEqual(ShrinkFiberState.Active, integration.State,
+                "提供者回归后集成组件自动重新激活");
+        }
+
+        [Test]
+        public void CommandComponent_ProvidesDefaultServiceKey()
+        {
+            var fiber = _runtime.Use(new ShrinkCommandAppComponent());
+            Assert.AreEqual(ShrinkFiberState.Active, fiber.State);
+            Assert.IsTrue(_runtime.TryGetRaw<ShrinkCommandService>(_runtime.RootContext,
+                ShrinkCommandAppComponent.ServiceKey, out var service));
+            Assert.AreSame(ShrinkCommandRuntime.Default, service);
+
+            Run(_runtime.RetireAsync(fiber));
+            Assert.IsFalse(_runtime.TryGetRaw<ShrinkCommandService>(_runtime.RootContext,
+                ShrinkCommandAppComponent.ServiceKey, out _), "退役撤回服务键");
+        }
+
+        [Test]
+        public void DataSaverComponent_Activates_FlushesOnDeactivate_WithdrawsKey()
+        {
+            var fiber = _runtime.Use(new ShrinkDataSaverAppComponent());
+            Assert.AreEqual(ShrinkFiberState.Active, fiber.State);
+            Assert.IsTrue(_runtime.TryGetRaw<object>(_runtime.RootContext,
+                ShrinkDataSaverAppComponent.ServiceKey, out _));
+
+            Assert.DoesNotThrow(() => Run(_runtime.RetireAsync(fiber)),
+                "停用执行补偿式收尾（设置最终落盘；未初始化环境安全跳过）");
+            Assert.IsFalse(_runtime.TryGetRaw<object>(_runtime.RootContext,
+                ShrinkDataSaverAppComponent.ServiceKey, out _));
+        }
+    }
+}
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 5c9445def3a931642955715272969a72
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -0,0 +1,28 @@
+{
+    "name": "ShrinkCommand.Integration.Network.Tests",
+    "rootNamespace": "ShrinkCommand.Integration.Network.Tests",
+    "references": [
+        "ShrinkCommand.Integration.Network",
+        "ShrinkCommand.Integration.App",
+        "ShrinkDataSaver.Integration.App",
+        "ShrinkNetwork.Integration.App",
+        "ShrinkCommand.Runtime",
+        "ShrinkNetwork.Runtime",
+        "ShrinkContext.Core.Runtime",
+        "UniTask",
+        "UnityEngine.TestRunner",
+        "UnityEditor.TestRunner"
+    ],
+    "includePlatforms": [
+        "Editor"
+    ],
+    "excludePlatforms": [],
+    "allowUnsafeCode": false,
+    "overrideReferences": false,
+    "autoReferenced": false,
+    "defineConstraints": [
+        "UNITY_INCLUDE_TESTS"
+    ],
+    "versionDefines": [],
+    "noEngineReferences": false
+}
@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: dd3e105f80569534b9ba2d6fa913a2cc
+AssemblyDefinitionImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: