Files
ShrinkNetwork.Integration.App/README.md
T
cneicy 123bd170d9
Publish UPM package / publish (push) Successful in 2s
Publish NuGet packages / publish (push) Successful in 4m51s
chore: align SDK dependencies and document reusable capabilities
2026-09-29 10:14:47 +08:00

36 lines
1.6 KiB
Markdown

# ShrinkNetwork.Integration.App
`ShrinkNetwork.Integration.App` 是 `ShrinkNetwork` 与 `ShrinkApp.Core` 的桥接层。它负责把默认网络服务挂进宿主服务容器,让项目在进入统一宿主模式后,能明确地从 `ShrinkApp` 取得网络服务,而不是在各处直接耦合 `ShrinkNetworkRuntime.Default`。
Godot 和普通 .NET 项目安装 `ShrinkSDK.Network.Integration.App`;可打包源码位于 `DotNet~`。
## 当前能力
- 提供原生 `ShrinkNetworkAppComponent`,发布 `shrink.service.network`
- 把 `ShrinkNetworkRuntime.Default` 包装为 `ShrinkNetworkAppService`
- ContextLoader 下由 Starter 组合根装配,服务门面随组件停用可逆注销
- `ShrinkNetworkAppInstaller` 仅保留给 ClassicHost 兼容路径,已标记过时
## 使用示例
```csharp
var network = ShrinkApp.ShrinkApp.Services.GetRequired<ShrinkNetwork.Integration.App.ShrinkNetworkAppService>();
var service = network.Service;
```
## 说明
- 本包当前不主动绑定传输层,也不替业务决定 TCP / KCP / Loopback。
- 静态消息合同与静态 handler 的默认注册仍由 `ShrinkNetworkRuntime.Default` 完成。
- 运行时实例 handler 仍然走 `RegisterHandlers(object target)`。
## 可复用能力
<!-- shrink:capabilities -->
Capability: 把网络服务作为 Context 组件和应用服务门面提供
Aliases: 网络宿主 network app
Limits: 不实现具体联网玩法;生命周期决定服务可用性
Extension: shrink.service.network 和原生组件
Evidence: [ShrinkNetworkAppComponent](Runtime/ShrinkNetworkAppComponent.cs)
<!-- /shrink:capabilities -->