cneicy
d74c2f08ca
- 将 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 迁移与旧代码地图
63 lines
2.9 KiB
C#
63 lines
2.9 KiB
C#
#nullable enable
|
||
using System;
|
||
using System.Collections.Generic;
|
||
using System.Linq;
|
||
using Cysharp.Threading.Tasks;
|
||
using ShrinkApp;
|
||
|
||
namespace ShrinkContext.AppAdapter
|
||
{
|
||
/// <summary>
|
||
/// 把现有 <see cref="IShrinkAppModuleInstaller"/> 包装为 ShrinkContext 组件：
|
||
/// - inject 由 <c>DependsOn</c> 派生（模块依赖 → 模块键），依赖未就绪时安装器保持非活动等待，
|
||
/// 而不是像拓扑排序那样直接抛错；
|
||
/// - provide 发布模块键 <c>app.module.<ModuleId></c>（安装器 Active 后对依赖者可见）；
|
||
/// - apply 依次执行 RegisterServices + InitializeAsync，config 必须传入 <see cref="ShrinkAppServices"/>。
|
||
///
|
||
/// 兼容安装器只负责执行既有 RegisterServices + InitializeAsync。需要停用时撤回服务的模块应使用
|
||
/// 原生 Context 组件，并通过 ShrinkAppServices.TryUnregister(instance) 登记对应逆操作。
|
||
/// </summary>
|
||
public sealed class ShrinkAppInstallerComponent : IShrinkComponent
|
||
{
|
||
/// <summary>模块键前缀：依赖声明 <c>DependsOn = ["a"]</c> 映射为 <c>app.module.a</c>。</summary>
|
||
public const string ModuleKeyPrefix = "app.module.";
|
||
|
||
private readonly IShrinkAppModuleInstaller _installer;
|
||
private readonly ShrinkAppSettings? _settings;
|
||
private readonly string[] _inject;
|
||
|
||
public ShrinkAppInstallerComponent(IShrinkAppModuleInstaller installer, ShrinkAppSettings? settings = null)
|
||
{
|
||
_installer = installer ?? throw new ArgumentNullException(nameof(installer));
|
||
_settings = settings;
|
||
_inject = (installer.DependsOn ?? Array.Empty<string>())
|
||
.Where(id => !string.IsNullOrWhiteSpace(id))
|
||
.Select(id => ModuleKeyPrefix + id.Trim())
|
||
.ToArray();
|
||
}
|
||
|
||
public string Name => "app-installer:" + _installer.ModuleId;
|
||
|
||
public IReadOnlyList<string> Inject => _inject;
|
||
|
||
public IReadOnlyList<string> Provide => new[] { ModuleKeyPrefix + _installer.ModuleId };
|
||
|
||
public IShrinkAppModuleInstaller Installer => _installer;
|
||
|
||
public async UniTask ApplyAsync(ShrinkCtx ctx, object? config)
|
||
{
|
||
if (config is not ShrinkAppServices services)
|
||
throw new InvalidOperationException(
|
||
$"ShrinkAppInstallerComponent '{_installer.ModuleId}' requires ShrinkAppServices as fiber config.");
|
||
|
||
// 先发布模块键再执行安装：装载期绑定对依赖者不可见（提供者须 Active），
|
||
// 供给冲突（重复 ModuleId）在安装器初始化之前即失败
|
||
ctx.Set(Provide[0], _installer.ModuleId);
|
||
|
||
var appContext = ShrinkAppContext.CreateStandalone(services, _settings);
|
||
_installer.RegisterServices(appContext);
|
||
await _installer.InitializeAsync(appContext);
|
||
}
|
||
}
|
||
}
|