Swinject for Swift: Complete Guide with Examples

What is Swinject and why is it needed?

Swinject is a lightweight dependency injection (DI) library for the Swift language. It provides a simple and declarative way to manage dependencies between objects, making code more modular, testable, and maintainable.

In the traditional approach, objects create their own dependencies, leading to tight coupling. For example, a UserService class might directly create an instance of NetworkClient. If you want to replace NetworkClient with a mock object for testing, you would have to change the UserService code. Swinject solves this problem by moving object creation and binding into a separate container.

Main advantages of Swinject:

\n
• Reduced coupling: Classes do not know how their dependencies are created.
\n
• Improved testability: Easily replace real dependencies with mocks and stubs.
\n
• Simplified configuration: All dependency configuration is gathered in one place.
\n
• Lifecycle support: Manage object lifetimes (singleton, new instance, etc.).
\n
• Clean architecture: Encourages adherence to SOLID principles, especially the Dependency Inversion Principle.
\n

Swinject is especially useful in large projects where the number of classes and their dependencies grows, making manual management complex and error-prone.

Installing Swinject

Swinject can be installed via Swift Package Manager (SPM) or CocoaPods. We'll cover both methods.

Installation via Swift Package Manager (recommended)

In Xcode, go to File → Add Packages.... Enter the repository URL in the search bar: https://github.com/Swinject/Swinject.git. Select the desired version (usually the latest stable) and click Add Package.

Alternatively, you can add the dependency to your Package.swift:

// swift-tools-version:5.7\nimport PackageDescription\n\nlet package = Package(\n    name: "YourProject",\n    dependencies: [\n        .package(url: "https://github.com/Swinject/Swinject.git", from: "2.8.0")\n    ],\n    targets: [\n        .target(\n            name: "YourTarget",\n            dependencies: ["Swinject"])\n    ]\n)\n

Installation via CocoaPods

Add the following to your Podfile:

pod 'Swinject', '~> 2.8'

Then run the command pod install.

Note: Unlike Python (pip) or Node.js (npm), Swift does not have a single package manager, but SPM is the standard and built into Xcode.

Quick start with a code example

Let's look at a simple example: we have a LoggerProtocol protocol and its implementation ConsoleLogger. We want the UserService class to receive the logger via dependency injection.

import Swinject\n\n// 1. Define the protocol\nprotocol LoggerProtocol {\n    func log(message: String)\n}\n\n// 2. Protocol implementation\nclass ConsoleLogger: LoggerProtocol {\n    func log(message: String) {\n        print("LOG: \\(message)")\n    }\n}\n\n// 3. Class that uses the dependency\nclass UserService {\n    private let logger: LoggerProtocol\n\n    // Injection via initializer\n    init(logger: LoggerProtocol) {\n        self.logger = logger\n    }\n\n    func createUser(name: String) {\n        logger.log(message: "Creating user: \\(name)")\n        // User creation logic\n    }\n}\n\n// 4. Container setup\nlet container = Container()\ncontainer.register(LoggerProtocol.self) { _ in ConsoleLogger() }\ncontainer.register(UserService.self) { r in\n    UserService(logger: r.resolve(LoggerProtocol.