title: 迁移指南

迁移指南

RFC 2119 中的必须(MUST)，不可(MUST NOT)，建议(SHOULD)，不建议(SHOULD NOT)，可以/可能(MAY)等关键词将在本节用来做一些解释性的描述。

从 1.2 迁移到 1.3

1.3 版本的改动轻微不兼容与 1.2 您需要根据提示修改。

不兼容部分

  • OnResolve 不再支持返回值覆盖，如果您使用了这一特性，请使用Extend替换。
  • Inject 不再支持定义别名
  • 上下文隐式变量注入被废弃，请使用显式声明替换
  • Watch接口对下面的调用形式进行了废弃: {% issues 163%}

语意变更

  • Bind,BindIf,Singleton,SingletonIf，行为语意变更。
  1. // 旧的语意为:
  2. IBindData Bind<TService, TAlias>();
  3. // 行为语意, 变更为：
  4. IBindData Bind<TService, TConcrete>();

这意味着下面的写法应该被新的写法替换:

已过时的写法

  1. App.Bind<FileSystem>().Alias<IFileSystem>();

推荐写法

  1. App.Bind<IFileSystem, FileSystem>();

虽然使用已过时的写法不会对项目造成明显的问题，但是存在一些功能需求上的潜在隐患，您应该尽早更换为新写法。

代码规范

如果您的代码违反了代码规范框架会抛出一个CodeStandardException，请根据提示更正。

从 1.1 迁移到 1.2

1.2 版本的改动轻微不兼容与 1.1 您需要根据提示修改。

不兼容部分

  • 移除了LRUCache，理由是由于性能不过关。
  • 移除了Inject注入标记的Required选项，因为我们认为Required的存在使开发者不再注重对传入值的校验，这对于非catlib下使用组件是存在安全风险的。

从 1.0 迁移到 1.1

这个版本您可以平滑迁移。所有需要您手动修正的问题都会主动抛出警告和修正建议。

从 0.8 迁移至 1.0

这是一个主版本变化，意味着出现了不向下兼容的更新，我们尽可能保证迁移的平滑，但是不可避免将会出现一些改动。

  • 移除了 ServiceProvider 抽象类 ，您必须使用IServiceProvider代替
  • 移除了 Container.ReleaseAll接口 , 您可能使用 Flush 代替（注意与ReleaseAll不同的是Flush将会清空一切绑定关系）
  • 移除了旧的事件系统 , 这意味着您必须重新适配新的事件系统接口
  • 移除了Config.AddLocator函数 ，您必须使用Config.SetLocator代替 ，由于移除了多数据源的支持，所以您不可重复的SetLocator
  • 移除了IStart增强接口 , 您不可再使用这个接口。
  • Application.GetPriorities 更名为 Application.GetPriority
  • Application.GetGuid 更名为 Application.GetRuntimeId
  • App.Instance 更名为 App.Handler
  • Timer.OnComplete 更名为 Timer.OnCompleted
  • 事件 Application.OnStartComplete 更名为 Application.OnStartCompleted
  • Application.Attach 函数迁移至 MonoDriver 组件 ， 您不可再使用App.Instance.Attach
  • Application.Detach 函数迁移至 MonoDriver 组件 ， 您不可再使用App.Instance.Detach
  • ServiceProvider.Init 由异步逻辑变更为同步逻辑。如果服务需要异步等待请使用IAWait
  • Container.Make 第二个参数拆分至 Container.MakeWith , 如果您的代码对容器构建有传参操作，您必须切换至Container.MakeWith
  • Application.Register 要求传入的是一个具体实例而不是一个Type
  • Application.Bootstrap 要求传入的是一个具体实例而不是一个Type
  • 配置名已经被统一调整,涉及到的组件有调试控制台,环境,路由,国际化