📦 Carthage для Swift: децентрализованный менеджер зависимостей

Carthage — это децентрализованный менеджер зависимостей для экосистемы Apple (iOS, macOS, tvOS, watchOS). В отличие от CocoaPods, Carthage не модифицирует проект автоматически — он собирает фреймворки, а вы сами подключаете их к Xcode. Это даёт полный контроль над процессом сборки и минимум «магии».

Библиотека использует Carthage (название совпадает с инструментом) и работает через Cartfile — декларативный файл, в котором перечисляются зависимости. Carthage клонирует репозитории, собирает их (используя xcodebuild) и помещает готовые .framework в папку Carthage/Build. Вы вручную добавляете их в проект.

Зачем нужен Carthage? Если вы цените прозрачность, хотите избежать конфликтов версий и не любите, когда инструменты автоматически правят ваш проект. Он идеален для команд, где каждый сам решает, как подключать зависимости, и для проектов с жёсткими требованиями к безопасности сборки.

1. Установка Carthage

Carthage можно установить через Homebrew (рекомендуется) или скачать .pkg с GitHub.

# Установка через Homebrew
brew install carthage

# Проверка версии
carthage version

Если Homebrew не установлен, сначала установите его: /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Для Linux или Windows Carthage официально не поддерживается (только macOS).

2. Быстрый старт — минимальный рабочий пример

Создайте новый проект Xcode (например, Single View App). Затем в корне проекта создайте файл Cartfile (без расширения) и добавьте зависимость:

# Cartfile
github "Alamofire/Alamofire" ~> 5.8

Теперь выполните команду в терминале (из папки проекта):

carthage update --platform iOS

После завершения в папке Carthage/Build/iOS появится Alamofire.framework. Откройте Xcode, перетащите этот .framework в секцию Frameworks, Libraries, and Embedded Content вашего таргета. Выберите «Embed & Sign».

Теперь можно импортировать библиотеку:

import Alamofire

// Минимальный запрос
AF.request("https://api.github.com/users/defunkt").response { response in
    debugPrint(response)
}

Готово! Вы только что подключили зависимость через Carthage.

3. Основные методы и функции Carthage

Ниже приведены ключевые команды и возможности Carthage. Большинство из них вызываются из терминала.

# Обновить только для iOS, используя xcframeworks
carthage update --platform iOS --use-xcframeworks

# Пересобрать всё, как указано в Cartfile.resolved
carthage bootstrap --platform macOS

# Пересобрать все фреймворки для iOS
carthage build --platform iOS --no-skip-current

# Скачать исходники без сборки
carthage checkout

# Проверить устаревшие пакеты
carthage outdated

# Пример скрипта в Xcode (вводится в Run Script)
/usr/local/bin/carthage copy-frameworks

carthage version
# Пример вывода: 0.39.1

# Примеры строк Cartfile
github "ReactiveX/RxSwift" ~> 6.5
git "https://gitlab.com/company/private-lib.git" >= 2.0
binary "https://mycompany.com/MyFramework.json" == 1.2

# Пример содержимого Cartfile.resolved
github "Alamofire/Alamofire" "5.8.1"
github "ReactiveX/RxSwift" "6.6.0"

carthage update --platform iOS --use-xcframeworks

4. Реальный практический пример (150+ строк кода)

Создадим простое приложение для iOS, которое загружает список пользователей GitHub с помощью Alamofire и отображает их в таблице. Carthage будет управлять зависимостью.

Шаг 1. Cartfile

# Cartfile
github "Alamofire/Alamofire" ~> 5.8
github "onevcat/Kingfisher" ~> 7.10

Шаг 2. Установка зависимостей

carthage update --platform iOS --use-xcframeworks

Шаг 3. Код приложения (Swift)

import UIKit
import Alamofire
import Kingfisher

// Модель пользователя GitHub
struct GitHubUser: Decodable {
    let login: String
    let id: Int
    let avatarUrl: String
    let htmlUrl: String

    enum CodingKeys: String, CodingKey {
        case login, id
        case avatarUrl = "avatar_url"
        case htmlUrl = "html_url"
    }
}

// ViewController с таблицей
class UsersViewController: UIViewController {

    @IBOutlet weak var tableView: UITableView!
    private var users: [GitHubUser] = []
    private let cellIdentifier = "UserCell"

    override func viewDidLoad() {
        super.viewDidLoad()
        title = "GitHub Users"
        tableView.dataSource = self
        tableView.delegate = self
        tableView.register(UITableViewCell.self, forCellReuseIdentifier: cellIdentifier)
        fetchUsers()
    }

    // MARK: - Networking with Alamofire
    private func fetchUsers() {
        let url = "https://api.github.com/users"
        AF.request(url).responseDec