Dip 是一个简单的 依赖注入容器。
它的目标是尽可能简单，同时提供其他平台上 DI 容器常用的丰富功能。它的灵感来自 .NET 的 Unity Container 和其他 DI 容器。
- 首先，创建
let container = DependencyContainer()并使用container.register { MyService() as Service }注册你的依赖项，通过将一个 *协议* 或 *类型* 关联到一个factory。 - 然后，你可以调用
container.resolve() as Service来使用该DependencyContainer解析 *协议* 或 *类型* 的实例。 - 你可以轻松地将 Dip 与 故事板和 Nib 一起使用。 还有一个 代码生成器，可以帮助简化注册新组件的过程。
基本用法
import Dip
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
// Create the container
private let container = DependencyContainer { container in
// Register some factory. ServiceImp here implements protocol Service
container.register { ServiceImp() as Service }
}
func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
// Resolve a concrete instance. Container will instantiate new instance of ServiceImp
let service = try! container.resolve() as Service
...
}
}
更复杂的示例
import Dip
class AppDelegate: UIResponder, UIApplicationDelegate {
private let container = DependencyContainer.configure()
...
}
//CompositionRoot.swift
import Dip
import DipUI
extension DependencyContainer {
static func configure() -> DependencyContainer {
return DependencyContainer { container in
unowned let container = container
DependencyContainer.uiContainers = [container]
container.register(tag: "ViewController") { ViewController() }
.resolvingProperties { container, controller in
controller.animationsFactory = try container.resolve() as AnimatonsFactory
}
container.register { AuthFormBehaviourImp(apiClient: $0) as AuthFormBehaviour }
container.register { container as AnimationsFactory }
container.register { view in ShakeAnimationImp(view: view) as ShakeAnimation }
container.register { APIClient(baseURL: NSURL(string: "https://:2368")!) as ApiClient }
}
}
}
extension DependencyContainer: AnimationsFactory {
func shakeAnimation(view: UIView) -> ShakeAnimation {
return try! self.resolve(withArguments: view)
}
}
extension ViewController: StoryboardInstantiatable {}
//ViewController.swift
class ViewController {
var animationsFactory: AnimationsFactory?
private let _formBehaviour = Injected<AuthFormBehaviour>()
var formBehaviour: AuthFormBehaviour? {
return _formBehaviour.value
}
...
}
Dip 有完整的 文档，并附带一个 Playground，可以让你尝试所有功能并熟悉 API。 你可以在 Dip.xcworkspace 中找到它。
注意：您可能需要先构建 Dip 框架，playground 才能使用它。为此，请选择
Dipscheme 并为 iPhone Simulator 构建。
你可以在 wiki 中找到大量用法示例和有用的技巧。
如果你正在使用 VIPER 架构 - 这里 是一个 VIPER 演示应用程序，它使用 Dip 代替手动依赖注入。
还有一些博客文章描述了如何使用 Dip 以及它的一些实现细节
如果您有任何问题，请提交 issue。 也热烈欢迎 pull request。
- 作用域。 Dip 支持 5 种不同的作用域（或生命周期策略）：Unique、Shared、Singleton、EagerSingleton、WeakSingleton；
- 自动装配 & 自动注入。 Dip 可以推断出组件构造函数中注入的依赖项，并自动解析它们，以及通过属性注入的依赖项。
- 解析可选类型。 Dip 能够解析定义为可选类型的构造函数或属性依赖项。
- 类型转发。 您可以注册相同的工厂来解析由单个类实现的不同的类型。
- 循环依赖。 如果你遵循一些简单的规则，Dip 将能够解析循环依赖；
- 故事板集成。 你可以轻松地将 Dip 与故事板和 Xib 一起使用，而无需在你的视图控制器代码中引用容器；
- 命名定义。 您可以通过使用 标签 注册，来为同一协议或类型注册不同的工厂；
- 运行时参数。 您可以注册最多接受 6 个运行时参数的工厂（如果需要，可以扩展）；
- 简单的配置 & 代码生成。 没有复杂的容器层次结构，没有不需要的功能。 厌倦了手动编写所有注册？ 有一个 很棒的代码生成器 将为你创建它们。 你唯一需要做的就是用一些注释来注释你的代码。
- 弱类型组件。 Dip 可以在编译时未知的情况下解析“弱”类型。
- 线程安全。 注册和解析组件是线程安全的；
- 有用的错误消息和配置验证。 您可以验证您的容器配置。 如果在运行时无法解析某些内容，Dip 会抛出一个完全描述问题的错误；
您可以使用您最喜欢的依赖管理器安装 Dip
CocoaPods
pod "Dip"
Carthage
github "AliSoftware/Dip"
要为 Swift 2.3 构建，请使用 --toolchain com.apple.dt.toolchain.Swift_2_3 选项运行 Carthage。
Swift Package Manager
.Package(url: "https://github.com/AliSoftware/Dip", majorVersion: 5, minor: 0)
在 OSX 上，您可以从 Xcode 运行测试。 在 Linux 上，您需要安装 Swift Package Manager，并使用它来构建和运行测试，使用以下命令：swift build --clean && swift build && swift test
此库由 Olivier Halligon 创建，并由 Ilya Puchka 维护。
Dip 在 MIT 许可证 下可用。 有关更多信息，请参见 LICENSE 文件。
此 README.md 顶部的动画 GIF 来自 这个食谱，来自 Kevin & Amanda 的美味博客。 去试试这个食谱吧！
用作 SampleApp 启动屏幕和图标的图像来自 Matthew Hine 并且属于 CC-by-2.0。
