com.cneicy.shrink-app-core (0.2.0)
Published 2026-09-05 04:11:44 +08:00 by cneicy
Installation
registry=https://git.crash.work/api/packages/ShrinkSDK/npm/npm install com.cneicy.shrink-app-core@0.2.0"com.cneicy.shrink-app-core": "0.2.0"About this package
Shrink 系列统一宿主层，提供模块安装器、服务容器与统一启动流程。
ShrinkApp.Core
ShrinkApp.Core 是 Shrink 系列模块的统一宿主层。它不直接替代各个基础包的独立使用方式，而是在项目需要“导入一组包后直接起盘”时，提供统一的启动链、模块安装器、服务容器和基础生命周期事件。
Godot 和普通 .NET 项目安装 ShrinkSDK.App.Core；可打包源码位于 DotNet~，其公开合同与 Unity 包共用同一份 Runtime 源码。
当前定位
- 统一宿主：在
BeforeSceneLoad阶段创建ShrinkAppHost - 模块安装器：通过编译期注入的安装器注册表获取
IShrinkAppModuleInstaller - 服务容器：各模块通过
RegisterServices(...)暴露门面服务 - 生命周期事件：通过
ShrinkEventBus发布ShrinkAppStartedEvent/ShrinkAppStartFailedEvent
核心类型
ShrinkApp
ShrinkAppHost
ShrinkAppSettings
ShrinkAppServices
ShrinkAppContext
IShrinkAppModuleInstaller
[ShrinkAppModuleInstaller]
ShrinkAppSettings 运行时优先从
Resources/GameAssets/Runtime/Data/ShrinkSDK/ShrinkAppSettings.asset 加载；旧项目的
Resources/ShrinkAppSettings.asset 继续作为回退。菜单 ShrinkSDK/应用/创建设置
会直接创建到新的标准目录。
启动流程
ShrinkApp在RuntimeInitializeOnLoadMethod(BeforeSceneLoad)创建宿主。- 宿主从编译期注册表
ShrinkAppGeneratedRegistry读取全部安装器类型。 - 安装器按
DependsOn + Order排序。 - 先执行
RegisterServices(...)，再顺序执行InitializeAsync(...)。 - 启动完成后在首场景
Start()阶段发布ShrinkAppStartedEvent。 - 任一安装器重复、依赖缺失、循环依赖、初始化异常都会 fail-fast。
Dependencies
Dependencies
| ID | Version |
|---|---|
| com.cneicy.shrink-eventbus | 2.1.0 |
| com.cneicy.shrink-shared-codegen | 0.1.1 |
| com.cysharp.unitask | 2.5.10 |
Keywords
app
bootstrap
framework
host
starter