VContainer-resolving/gameobject-injection | 解析——注入到 MonoBehaviours 中

合集 - 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-17

9.VContainer-resolving/gameobject-injection | 解析——注入到 MonoBehaviours 中02-17

10.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-1718.VContainer-integrations/entrypoint | 集成——纯 C# 入口点02-1719.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

收起

由于 Unity 的 MonoBehaviours 不支持构造函数，必须使用 方法注入 来注入依赖项。

注意：即使 MonoBehaviour 的方法带有 [Inject] 特性标记，也不会自动触发注入。必须通过以下三种方式之一手动注入依赖：

1. 如果想注入到特定的 MonoBehaviour，可以在 LifetimeScope 的检查器(Inspector)中进行指定。
   • 所有指定 GameObject（及其子对象）的 MonoBehaviours 将在 LifetimeScope 初始化时自动 Inject。
2. 使用 RegisterComponent* 系列方法将 MonoBehaviour 实例注册到容器中。
   • 在这种情况下，注册的 MonoBehaviour 将同时 Inject 和被 Inject 到其他类中。
   • 参见 注册 MonoBehaviour
3. 要在运行时注入到动态生成的 MonoBehaviours 中（例如预制体的生成），应使用 IObjectResolver.Instantiate 代替 UnityEngine.Object.Instantiate。（可以注册工厂模式和对象生成表达式。）
   • 参见 注册回调
   • 参见 注册工厂

为什么 VContainer 不自动注入到所有 MonoBehaviours 中？

• Unity 没有提供监听所有 GameObjects 或 MonoBehaviours 创建的机制。与其有一些情况自动 Inject 而另一些情况不自动 Inject，我们采用显式 Inject 以满足不同需求。
• 推荐在 GameObject 层级调用 InjectGameObject；不建议直接在 MonoBehaviours 上执行 Inject。原因如下：
  • MonoBehaviour 是一个 C# 类，允许你为任何东西编写代码，而且它在运行时动态创建/销毁。注入到具有动态生命周期的对象会使引用管理复杂化。最简单的解决方案是不这样做。
  • VContainer 和 DI 的目的是反转 MonoBehaviour 的控制。
    • 视图组件通常是检测事件和发生的起点，但它也可以通知外部世界它拥有检测到的事件。
  • 如果 MonoBehaviour 需要显式的 Inject 调用，可能会失去 Unity 预制件的可移植性优势。
  • 为了让视图组件正常工作，它需要知道要在屏幕上显示的数据/状态，但运行时频繁变化的数据应通过参数传递而非依赖注入 Inject 。