- 将 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 迁移与旧代码地图
110 lines
4.7 KiB
C#
110 lines
4.7 KiB
C#
using System;
|
|
using System.Collections.Generic;
|
|
using System.Reflection;
|
|
using Cysharp.Threading.Tasks;
|
|
|
|
namespace ShrinkEventBus
|
|
{
|
|
public interface IShrinkEventSubscription : IDisposable
|
|
{
|
|
long SubscriptionId { get; }
|
|
bool IsDisposed { get; }
|
|
}
|
|
|
|
public readonly struct ShrinkEventSubscriptionSnapshot
|
|
{
|
|
public ShrinkEventSubscriptionSnapshot(long subscriptionId, Type eventType, EventPriority priority,
|
|
int numericPriority, bool receiveCanceled, object target, string targetTypeName, string methodName,
|
|
string debugInfo, DateTime registeredAtUtc)
|
|
{
|
|
SubscriptionId = subscriptionId;
|
|
EventType = eventType ?? throw new ArgumentNullException(nameof(eventType));
|
|
Priority = priority;
|
|
NumericPriority = numericPriority;
|
|
ReceiveCanceled = receiveCanceled;
|
|
Target = target;
|
|
TargetTypeName = targetTypeName ?? string.Empty;
|
|
MethodName = methodName ?? string.Empty;
|
|
DebugInfo = debugInfo ?? string.Empty;
|
|
RegisteredAtUtc = registeredAtUtc;
|
|
}
|
|
|
|
public long SubscriptionId { get; }
|
|
public Type EventType { get; }
|
|
public EventPriority Priority { get; }
|
|
public int NumericPriority { get; }
|
|
public bool ReceiveCanceled { get; }
|
|
public object Target { get; }
|
|
public string TargetTypeName { get; }
|
|
public string MethodName { get; }
|
|
public string DebugInfo { get; }
|
|
public DateTime RegisteredAtUtc { get; }
|
|
public bool IsStaticHandler => Target == null;
|
|
}
|
|
|
|
public interface IShrinkEventBus
|
|
{
|
|
event Action<EventBase, Type> OnEventTriggered;
|
|
|
|
#if UNITY_EDITOR
|
|
event Action<EventBase, string, string, EventHandlerInfo[]> OnEventTriggeredForEditor;
|
|
bool EnableDebugRecord { get; set; }
|
|
#endif
|
|
|
|
bool IsStarted { get; }
|
|
|
|
void Start();
|
|
void AutoRegister(object target);
|
|
void Register(object target);
|
|
void Unregister(object target);
|
|
|
|
void RegisterEvent<TEvent>(Action<TEvent> handler, EventPriority priority = EventPriority.NORMAL,
|
|
bool receiveCanceled = false) where TEvent : EventBase;
|
|
void RegisterEvent<TEvent>(Action<TEvent> handler, int priority) where TEvent : EventBase;
|
|
void RegisterEvent<TEvent>(Func<TEvent, UniTask> handler, EventPriority priority = EventPriority.NORMAL,
|
|
bool receiveCanceled = false) where TEvent : EventBase;
|
|
void RegisterEvent<TEvent>(Func<TEvent, UniTask> handler, int priority) where TEvent : EventBase;
|
|
IShrinkEventSubscription SubscribeEvent<TEvent>(Action<TEvent> handler,
|
|
EventPriority priority = EventPriority.NORMAL, bool receiveCanceled = false) where TEvent : EventBase;
|
|
IShrinkEventSubscription SubscribeEvent<TEvent>(Action<TEvent> handler, int priority)
|
|
where TEvent : EventBase;
|
|
IShrinkEventSubscription SubscribeEvent<TEvent>(Func<TEvent, UniTask> handler,
|
|
EventPriority priority = EventPriority.NORMAL, bool receiveCanceled = false) where TEvent : EventBase;
|
|
IShrinkEventSubscription SubscribeEvent<TEvent>(Func<TEvent, UniTask> handler, int priority)
|
|
where TEvent : EventBase;
|
|
|
|
void UnregisterEvent<TEvent>(Action<TEvent> handler) where TEvent : EventBase;
|
|
void UnregisterEvent<TEvent>(Func<TEvent, UniTask> handler) where TEvent : EventBase;
|
|
void ClearAllSubscribersForEvent<TEvent>() where TEvent : EventBase;
|
|
void UnregisterAllEventsForObject(object targetObject);
|
|
void UnregisterAllEvents();
|
|
|
|
bool TriggerEvent<TEvent>(TEvent eventArgs) where TEvent : EventBase;
|
|
bool TriggerEvent<TEvent>(EventPriority phase, TEvent eventArgs) where TEvent : EventBase;
|
|
UniTask<bool> TriggerEventAsync<TEvent>(TEvent eventArgs) where TEvent : EventBase;
|
|
UniTask<bool> TriggerEventAsync<TEvent>(EventPriority phase, TEvent eventArgs) where TEvent : EventBase;
|
|
|
|
EventHandlerInfo[] GetEventSubscribers<TEvent>() where TEvent : EventBase;
|
|
ListenerList GetListenerList<TEvent>() where TEvent : EventBase;
|
|
IReadOnlyDictionary<Type, EventHandlerInfo[]> GetAllSubscribersSnapshot();
|
|
IReadOnlyList<ShrinkEventSubscriptionSnapshot> GetActiveSubscriptionsSnapshot();
|
|
|
|
bool IsInstanceRegistered(object target);
|
|
int GetRegisteredInstanceCount();
|
|
int GetRegisteredEventTypeCount();
|
|
}
|
|
|
|
public interface IShrinkEventExceptionHandler
|
|
{
|
|
void HandleException(IShrinkEventBus bus, EventBase eventArgs, EventHandlerInfo[] listeners, int index,
|
|
Exception exception);
|
|
}
|
|
|
|
public enum ShrinkEventExceptionHandlingMode
|
|
{
|
|
LogAndContinue,
|
|
Throw,
|
|
LogAndThrow
|
|
}
|
|
}
|