Needle 依赖注入框架使用教程

最新推荐文章于 2025-06-26 09:31:52 发布

原创最新推荐文章于 2025-06-26 09:31:52 发布 · 480 阅读

9 ·

CC 4.0 BY-SA版权

Needle 依赖注入框架使用教程

needle Compile-time safe Swift dependency injection framework 项目地址: https://gitcode.com/gh_mirrors/need/needle

1. 项目介绍

概述

Needle 是一个用于 Swift 的依赖注入（DI）框架，旨在通过代码生成确保编译时安全。与其他依赖注入框架（如 Cleanse 和 Swinject）不同，Needle 鼓励分层依赖注入结构，并利用代码生成来确保编译时安全。这意味着，如果代码能够编译通过，那么它就能正常工作。Needle 的目标是提供高可靠性，确保依赖注入代码在编译时是安全的，并且在处理大型代码库时保持高性能。

主要特性

编译时安全：通过代码生成确保依赖注入代码在编译时是安全的。
高性能：即使在处理多百万行代码库时，也能保持高性能。
兼容性：兼容各种 iOS 应用架构，包括 RIBs、MVx 等。

2. 项目快速启动

安装 NeedleFoundation 框架

使用 Carthage

github "https://github.com/uber/needle.git" ~> VERSION_OF_NEEDLE

使用 Swift Package Manager

dependencies: [
    .package(url: "https://github.com/uber/needle.git", from: "VERSION_NUMBER")
]

targets: [
    .target(
        name: "YOUR_MODULE",
        dependencies: ["NeedleFoundation"]
    )
]

使用 CocoaPods

pod 'NeedleFoundation'

安装代码生成器

使用 Carthage

如果使用 Carthage 集成 NeedleFoundation 框架，代码生成器可从 Carthage/Checkouts/needle/Generator/bin/needle 找到。

使用 Homebrew

brew install needle

编写依赖注入代码

import NeedleFoundation

// 定义依赖协议
protocol MyDependency: Dependency {
    var chocolate: Food { get }
    var milk: Food { get }
}

// 定义组件
class MyComponent: Component<MyDependency> {
    var hotChocolate: Drink {
        return HotChocolate(dependency.chocolate, dependency.milk)
    }

    var myChildComponent: MyChildComponent {
        return MyChildComponent(parent: self)
    }
}