software

[iOS] CocoaPods 치트시트

발행: (2026년 2월 6일 오전 11:37 GMT+9)
2 분 소요
원문: Dev.to

Source: Dev.to

소개

CocoaPods는 iOS 프로젝트용 의존성 관리 도구입니다.

설치

brew install ruby
sudo gem install cocoapods

설치 확인:

pod --version

Podfile 초기화

.xcodeproj가 있는 폴더로 이동하여 실행합니다:

pod init

생성된 Podfile(Ruby DSL)을 편집하여 플랫폼, 타깃 및 원하는 pod를 지정합니다:

platform :ios, '15.0'

target 'YourAppTarget' do
  use_frameworks!

  pod 'Alamofire'
  pod 'SnapKit'
end

Pod 설치

pod install

🚨 이제부터는 .xcodeproj가 아니라 .xcworkspace 파일을 열어야 합니다.

사용 예시

import Alamofire

AF.request("https://example.com").response { response in
    print(response)
}

코드가 컴파일되면 준비가 완료된 것입니다.

일반적인 CocoaPods 명령

CommandDescription
pod installPodfile에 나열된 의존성을 설치합니다.
pod update설치된 의존성을 최신 호환 버전으로 업데이트합니다.
pod repo update로컬 스펙 저장소를 새로 고칩니다.
pod deintegrate프로젝트에서 CocoaPods를 완전히 제거합니다.
pod search NAME이름으로 pod를 검색합니다.

문제 해결

  • “No such module” 또는 Build settings 충돌

    pod deintegrate
pod install

  • 설치가 느릴 때

    pod install --repo-update

CocoaPods를 사용해야 할 때

  • 이미 CocoaPods에 의존하고 있는 레거시 프로젝트.
  • 아직 Swift Package Manager(SPM)를 지원하지 않는 라이브러리.

최신 프로젝트의 경우 대신 Swift Package Manager 사용을 고려하세요.

Back to Blog

관련 글

더 보기 »