VContainer-integrations/entrypoint | 集成——纯 C# 入口点

合集 - VContainer 中文文档(33)

1.VContainer 介绍02-172.VContainer-about/what-is-vcontainer | 概述——VContainer 是什么？02-173.VContainer-about/what-is-di | 概述——DI 是什么？02-174.VContainer-getting-started/installation | 入门——安装02-175.VContainer-getting-started/hello-world | 入门——Hello World02-176.VContainer-resolving/constructor-injection | 解析——构造函数注入02-177.VContainer-resolving/method-injection | 解析——方法注入02-178.VContainer-resolving/property-field-injection | 解析——属性/字段注入02-179.VContainer-resolving/gameobject-injection | 解析——注入到 MonoBehaviours 中02-1710.VContainer-resolving/container-api | 解析——容器 API02-1711.VContainer-registering/register-type | 注册——注册纯 C# 类型02-1712.VContainer-registering/register-using-delegate | 注册——注册使用委托02-1713.VContainer-registering/register-factory | 注册——注册工厂02-1714.VContainer-registering/register-monobehaviour | 注册——注册 MonoBehaviour02-1715.VContainer-registering/register-scriptable-object | 注册——注册 ScriptableObject02-1716.VContainer-registering/register-collection | 注册——注册集合02-1717.VContainer-registering/register-callbacks | 注册——注册回调02-17

18.VContainer-integrations/entrypoint | 集成——纯 C# 入口点02-17

19.VContainer-integrations/unitask | 集成——Unitask02-1820.VContainer-integrations/unirx | 集成——UniRx02-1821.VContainer-integrations/messagepipe | 集成——MessagePipe02-1822.VContainer-integrations/ecs | 集成——ECS (beta)02-1823.VContainer-scoping/lifetime-overview | 作用域——生命周期管理总览02-1824.VContainer-scoping/generate-child-via-scene | 作用域——通过场景或 prefab 生成子作用域02-1825.VContainer-scoping/generate-child-with-code-first | 作用域——通过代码优先生成子作用域02-1826.VContainer-scoping/project-root-lifetimescope | 作用域——项目根作用域 LifetimeScope02-1827.VContainer-diagnostics/diagnostics-window | 诊断——VContainer 诊断窗口02-1828.VContainer-optimization/source-generator | 优化——源码生成器02-1829.**VContainer-optimization/async-container-build | 优化——异步容器构建02-1830.VContainer-optimization/parallel-container-build | 优化——并行容器构建02-1831.VContainer-optimization/codegen | 优化——预生成 IL 代码（已弃用）02-1832.VContainer-comparing/comparing-to-zenject | 对比 Zenject02-1833.MessagePipe 中文文档02-20

收起

VContainer 允许使用纯 C# 类作为应用入口点。
相比功能复杂的 MonoBehaviour，这种方式能简化控制流。

class FooController : IStartable
{
    void IStartable.Start()
    {
        // 初始化逻辑...
    }
}

builder.RegisterEntryPoint<FooController>();

参见 注册纯 C# 类型

VContainer 通过自定义 PlayerLoopSystem 实现生命周期管理。

注册实现了标记接口的类后，它们会被调度到 Unity 的主循环中执行。

由于它使用了 PlayerLoopSystem，在任何时候注册（例如：IStartable 等）类，它都能正常工作。

可用的接口

VContainer 入口点	时机
IInitializable.Initialize()	容器构建后立即执行
IPostInitializable.PostInitialize()	晚于 IInitializable.Initialize()
IStartable.Start()	近似 MonoBehaviour.Start()
IAsyncStartable.StartAsync()	近似 MonoBehaviour.Start()
IPostStartable.PostStart()	晚于 MonoBehaviour.Start()
IFixedTickable.FixedTick()	近似 MonoBehaviour.FixedUpdate()
IPostFixedTickable.PostFixedTick()	晚于 MonoBehaviour.FixedUpdate()
ITickable.Tick()	近似 MonoBehaviour.Update()
IPostTickable.PostTick()	晚于 MonoBehaviour.Update()
ILateTickable.LateTick()	近似 MonoBehaviour.LateUpdate()
IPostLateTickable.PostLateTick()	晚于 MonoBehaviour.LateUpdate()

以及

• IDisposable : 随容器销毁时调用。（适用于 Lifetime.Singleton / Lifetime.Scoped）

:::note
Unity - Manual: Order of Execution for Event Functions
:::

async 异步支持

IAsyncStartable 是 IStartable 的一个变体。
其执行时机与 IStartable 相同，但可使用 async Awaitable StartAsync() 语法。

UniTask 用户可以选择 UniTask 版本的 StartAsync。
UniTask 集成

处理未捕获的异常

在应用程序端，无法捕获在 Start() 和 Tick() 等过程中抛出的异常。

默认情况下，VContainer 会将未处理的异常记录为 UnityEngine.Debug.LogException。
也可以为每个 LifetimeScope 注册一个回调用来自定义异常处理：

builder.RegisterEntryPointExceptionHandler(ex =>
{
    // ...
});

:::caution
注册自定义处理器 RegisterEntryPointExceptionHandler 后，默认的错误日志记录将失效。
:::