iOS/macOS 개발을 하다 보면 외부 라이브러리(의존성)를 프로젝트에 추가해야 하는 순간이 반드시 옴. Alamofire, SnapKit, Kingfisher 같은 유명한 라이브러리들을 직접 소스코드 복붙해서 쓸 수도 있지만... 그건 진짜 노답이잖아? 😅

그래서 등장한 게 바로 패키지 매니저(Package Manager)! 의존성을 자동으로 다운로드하고, 버전을 관리하고, 프로젝트에 통합시켜주는 도구야.

Swift 생태계에서는 크게 3가지 패키지 매니저가 있어:

이 세 가지를 제대로 이해하면 프로젝트 상황에 맞는 최적의 선택을 할 수 있어. 지금부터 하나씩 뜯어보자! 🔥

Swift 생태계에서 패키지 매니저가 3개나 공존하게 된 건 사실 역사적인 이유가 있어. 타임라인으로 보면 이해가 쉬움!

SPM은 Apple이 공식으로 만든 패키지 매니저야. Swift 언어 자체에 내장되어 있고, Xcode와 완벽하게 통합되어 있어서 별도 설치가 필요 없음!

SPM의 모든 설정은 Package.swift 파일 하나로 관리돼. Swift 코드로 작성하는 게 특징!

// Package.swift 예시
// Swift: Package Description
import PackageDescription

let package = Package(
    name: "MyAwesomeApp",
    platforms: [
        .iOS(.v15),
        .macOS(.v12)
    ],
    products: [
        .library(
            name: "MyAwesomeApp",
            targets: ["MyAwesomeApp"]
        ),
    ],
    dependencies: [
        // 의존성 추가하는 곳!
        .package(
            url: "https://github.com/Alamofire/Alamofire.git",
            .upToNextMajor(from: "5.8.0")
        ),
        .package(
            url: "https://github.com/onevcat/Kingfisher.git",
            from: "7.0.0"
        ),
    ],
    targets: [
        .target(
            name: "MyAwesomeApp",
            dependencies: [
                "Alamofire",
                "Kingfisher"
            ]
        ),
        .testTarget(
            name: "MyAwesomeAppTests",
            dependencies: ["MyAwesomeApp"]
        ),
    ]
)

SPM에서 버전을 지정하는 방법이 여러 가지 있는데, 이게 진짜 중요해!

SPM은 의존성을 설치하면 Package.resolved 파일을 자동 생성해. 이 파일은 정확한 버전 정보를 담고 있어서 팀원들이 동일한 버전을 사용하도록 보장해줌.

// Package.resolved 예시 (JSON 형식)
{
  "pins" : [
    {
      "identity" : "alamofire",
      "kind" : "remoteSourceControl",
      "location" : "https://github.com/Alamofire/Alamofire.git",
      "state" : {
        "revision" : "f455c2975872ccd2d9c81594c658af65716e9b9a",
        "version" : "5.8.1"
      }
    }
  ],
  "version" : 2
}

Carthage는 "Simple, decentralized dependency manager for Cocoa"를 표방해. CocoaPods처럼 프로젝트 파일을 건드리지 않고, 프레임워크를 빌드해서 직접 링크하는 방식이야.

# Homebrew로 설치 (권장)
brew install carthage

# 버전 확인
carthage version

Carthage는 Cartfile에 의존성을 정의해. 문법이 매우 간단함!

# Cartfile 예시

# GitHub 저장소 (가장 일반적)
github "Alamofire/Alamofire" ~> 5.8
github "onevcat/Kingfisher" ~> 7.0
github "SnapKit/SnapKit" >= 5.6.0

# Git 저장소 직접 지정
git "https://my-private-server.com/MyLib.git" "main"

# 바이너리 프레임워크 (빌드 없이 바로 사용)
binary "https://my-server.com/MyFramework.json" ~> 2.0

# 의존성 빌드 (처음 설치 또는 Cartfile 변경 시)
# iOS용 XCFramework 빌드 (Xcode 12+, 권장)
carthage bootstrap --use-xcframeworks --platform iOS

# 업데이트
carthage update --use-xcframeworks --platform iOS

# 특정 라이브러리만 업데이트
carthage update Alamofire --use-xcframeworks --platform iOS

# 빌드만 (다운로드 없이)
carthage build --use-xcframeworks --platform iOS

Carthage는 빌드 후 수동으로 Xcode 프로젝트에 프레임워크를 연결해야 해. 이게 CocoaPods와 가장 큰 차이점!

# Build Phases → Run Script에 추가 (구형 방식)
/usr/local/bin/carthage copy-frameworks

# Input Files:
$(SRCROOT)/Carthage/Build/iOS/Alamofire.framework
$(SRCROOT)/Carthage/Build/iOS/Kingfisher.framework

MyApp/
├── Cartfile              ← 의존성 정의
├── Cartfile.resolved     ← 버전 잠금 (Git 커밋 필수!)
├── Carthage/
│   ├── Build/           ← 빌드된 프레임워크 (Git 커밋 선택)
│   │   ├── iOS/
│   │   └── XCFrameworks/
│   └── Checkouts/       ← 소스코드 체크아웃 (Git 커밋 비권장)
├── MyApp.xcodeproj      ← 원본 그대로! (xcworkspace 불필요)
└── Sources/

자 이제 세 가지를 한눈에 비교해보자! 표로 정리하면 이해가 훨씬 쉬움 ㅋㅋ

많은 팀들이 CocoaPods에서 SPM으로 이전하고 있어. 어떻게 하는지 알아보자!

# 1. CocoaPods 제거
pod deintegrate  # Xcode 프로젝트에서 CocoaPods 설정 제거
pod clean        # 캐시 정리

# 2. 관련 파일 삭제
rm Podfile
rm Podfile.lock
rm -rf Pods/
rm MyApp.xcworkspace  # xcworkspace 삭제 (xcodeproj 남겨둠)

# 3. Xcode에서 SPM 패키지 추가
# File → Add Package Dependencies...
# 각 라이브러리의 GitHub URL 입력

# 4. 빌드 테스트
xcodebuild -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15'

패키지 매니저를 잘 쓰는 것도 중요하지만, 의존성 관리 자체를 잘 하는 게 더 중요해! 실무에서 바로 써먹을 수 있는 팁들을 모았음 ㅋㅋ

# SPM - Package.resolved 확인 후 업데이트
# Xcode → File → Packages → Update to Latest Package Versions

# CocoaPods - 특정 팟만 업데이트
pod update Alamofire  # 전체 업데이트 대신 개별 업데이트

# 업데이트 후 반드시 전체 테스트 실행!
xcodebuild test -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 15'

회사 내부 라이브러리를 패키지로 관리하는 방법도 알아두면 좋아!

// SPM - Private 패키지 (Package.swift)
.package(
    url: "https://github.com/mycompany/private-lib.git",
    from: "1.0.0"
)
// → GitHub/GitLab에서 SSH 키 또는 토큰 설정 필요

// CocoaPods - Private Podspec 저장소
source 'https://github.com/mycompany/private-specs.git'
source 'https://cdn.cocoapods.org/'

pod 'MyPrivateLib', '~> 1.0'

# GitHub Actions에서 SPM 캐시 활용
- name: Cache SPM packages
  uses: actions/cache@v3
  with:
    path: |
      ~/Library/Developer/Xcode/DerivedData
      .build
    key: ${{ runner.os }}-spm-${{ hashFiles('**/Package.resolved') }}

# CocoaPods 캐시
- name: Cache CocoaPods
  uses: actions/cache@v3
  with:
    path: Pods
    key: ${{ runner.os }}-pods-${{ hashFiles('**/Podfile.lock') }}

패키지 매니저 쓰다 보면 진짜 별별 에러가 다 나와 ㅋㅋ 자주 만나는 문제들 정리해봤어!

라이브러리를 쓰는 것도 중요하지만, 직접 만들어서 배포하는 것도 알아두면 좋아! 특히 팀 내 공통 모듈을 패키지로 만들면 재사용성이 엄청 올라가거든 ㅋㅋ

# 새 패키지 생성
mkdir MySwiftPackage
cd MySwiftPackage
swift package init --type library

# 생성되는 구조:
# MySwiftPackage/
# ├── Package.swift
# ├── README.md
# ├── Sources/
# │   └── MySwiftPackage/
# │       └── MySwiftPackage.swift
# └── Tests/
#     └── MySwiftPackageTests/
#         └── MySwiftPackageTests.swift

# 빌드 테스트
swift build

# 테스트 실행
swift test

// Package.swift - 나만의 네트워킹 유틸리티 패키지
import PackageDescription

let package = Package(
    name: "NetworkKit",
    platforms: [
        .iOS(.v15),
        .macOS(.v12),
        .watchOS(.v8),
        .tvOS(.v15)
    ],
    products: [
        // 외부에 노출할 라이브러리
        .library(
            name: "NetworkKit",
            targets: ["NetworkKit"]
        ),
    ],
    dependencies: [
        // 이 패키지가 의존하는 외부 패키지
        .package(
            url: "https://github.com/Alamofire/Alamofire.git",
            .upToNextMajor(from: "5.8.0")
        ),
    ],
    targets: [
        .target(
            name: "NetworkKit",
            dependencies: ["Alamofire"],
            // 리소스 포함 시
            resources: [
                .process("Resources")
            ]
        ),
        .testTarget(
            name: "NetworkKitTests",
            dependencies: ["NetworkKit"]
        ),
    ],
    swiftLanguageVersions: [.v5]
)

마지막으로 앞으로의 방향성을 짚어보자. 개발 생태계는 계속 변하니까 트렌드를 파악하는 게 중요해!

// Swift 5.9 - 매크로(Macro) 패키지 지원
.target(
    name: "MyMacros",
    dependencies: [
        .product(name: "SwiftSyntaxMacros", package: "swift-syntax"),
        .product(name: "SwiftCompilerPlugin", package: "swift-syntax")
    ]
),

// 조건부 의존성 (플랫폼별)
.target(
    name: "MyTarget",
    dependencies: [
        .product(name: "CryptoKit", package: "swift-crypto",
                 condition: .when(platforms: [.linux]))
    ]
)