[iOS] CocoaPods 알아보기

안녕하세요! 피피아노입니다 🎵

 

이번 포스팅에서는 iOS 개발에서 정말 자주 쓰이는 CocoaPods에 대해서 알아보겠습니다.

 

그럼 바로 시작하겠습니다!

 

CocoaPods이란?

 

CocoaPods이 뭔지 알아보기 위해 CocoaPods 공식 홈페이지로 들어가보겠습니다.

 

https://cocoapods.org/

CocoaPods.org

 

페이지에 들어가면 WHAT IS COCOAPODS 라고 쓰여있는 글씨 아래 내용을 살펴보면 이렇게 쓰여 있습니다.

CocoaPods is a dependency manager for Swift and Objective-C Cocoa projects. It has over 101 thousand libraries and is used in over 3 million apps. CocoaPods can help you scale your projects elegantly.

 

해석을 해보자면

 

"CocoaPods은 Swift 및 Objective-C Cocoa 프로젝트의 종속성 관리자입니다. CocoaPods은 101,000개 이상의 라이브러리를 가지고 있으며 300만 개 이상의 앱에서 사용됩니다. CocoaPods은 프로젝트를 우아하게 확장하는 데 도움을 줄 수 있습니다."

 

라고 해석할 수 있습니다.

 

즉, 쉽게 말해서 CocoaPods은 Swift 및 Objective-C로 개발을 할 때, 외부 라이브러리를 관리하기 쉽도록 도와주는 의존성 관리 도구라고 생각하시면 됩니다!

 

CocoaPods 설치 방법

CocoaPods의 설치 방법은 간단합니다. 

 

공식 홈페이지에 나와 있는 설명을 보자면 

 

CocoaPods is built with Ruby and is installable with the default Ruby available on macOS. We recommend you use the default ruby.

Using the default Ruby install can require you to use sudo when installing gems. Further installation instructions are in the guides.

sudo gem install cocoapods

 

해석해보면

 

"CocoaPods는 Ruby로 만들어졌으며 macOS에서 사용할 수 있는 기본 Ruby로 설치할 수 있습니다. 기본 루비를 사용하는 것이 좋습니다. 기본 루비 설치를 사용하면 젬을 설치할 때 sudo를 사용해야 할 수 있습니다. 추가 설치 지침은 가이드에 있습니다."

 

라고 해석할 수 있습니다.

 

그냥 CocoaPods은 루비라는 언어로 제작이 되었고 'sudo gem install cocoapods' 라는 명령어를 터미널에 입력해서 설치하면 되겠구나! 정도만 알고 지나가면 될 것 같습니다!

 

해당 명령어를 입력하고 엔터를 누르면 Password를 입력하라고 나오는데 본인 맥의 암호를 입력해주고 조금 기다리면...(아무런 반응이 없어도 설치가 되고 있는 것이니 기다리시면 됩니다!)

 

*만약에 루비 버전 업데이트에 관한 에러 메세지가 나온다면 

rbenv를 사용하는 경우에는 

# rbenv 설치 후
rbenv install 3.1.0
rbenv global 3.1.0

 

이 명령어를 입력하시고

 

RVM을 사용하시는 경우에는 

# RVM 설치 후
rvm install 3.1.0
rvm use 3.1.0 --default

 

이 명령어를 입력하신 다음 다시 sudo gem install cocoapods 명령어를 입력하시면 됩니다.

 

설치 확인

CocoaPods이 제대로 설치 되었는지 확인하기 위해 아래 명령어를 입력합니다.

pod --version

설치가 완료되면 CocoaPods의 버전이 출력됩니다.

 

CocoaPods 초기 설정

프로젝트 디렉토리 이동

CocoaPods를 적용할 프로젝트 파일에 접근해서 우클릭으로 터미널을 열어줍니다.

 

터미널에서 cd 명령어로 이동하셔도 됩니다!

//cd 명령어로 경로 진입 시
cd /path/to/your/project

 

Podfile 생성

 아래 명령어를 입력해서 프로젝트 디렉토리에 Podfile을 생성합니다.

pod init

Podfile은 CocoaPods이 의존성을 관리할 방법을 정의하는 파일입니다.

 

Podfile 수정

생성된 Podfile을 텍스트 편집기로 열고, 필요한 라이브러리를 추가합니다. 예를 들어, Alamofire와 SnapKit 라이브러리를 추가하려면 다음과 같이 수정합니다.

# Podfile

platform :ios, '12.0'
use_frameworks!

target 'YourProjectTargetName' do
  pod 'Alamofire', '~> 5.4'
  pod 'SnapKit', '~> 5.0'
end

• platform :ios, '12.0'은 iOS 12.0 이상을 지원하는 라이브러리만 포함하도록 설정합니다.
• use_frameworks!는 라이브러리를 프레임워크로 사용할 것을 의미합니다.
• target 'YourProjectTargetName'에서 'YourProjectTargetName'을 실제 Xcode 프로젝트의 타겟 이름으로 바꿔야 합니다.

Pod 설치

그리고 아래 명령어를 입력해서 수정한 Podfile을 기반으로 라이브러리를 설치합니다.

pod install

이 명령어는 Pods라는 새로운 디렉토리를 생성하고, Podfile.lock 파일과 YourProject.xcworkspace 파일을 생성합니다.

 

Xcode 프로젝트 열기

CocoaPods를 설치한 후에는 .xcworkspace 파일을 열어야 합니다. .xcworkspace 파일은 Xcode에서 CocoaPods가 관리하는 모든 라이브러리를 포함한 워크스페이스입니다.

 

이제 Xcode에서 .xcodeproj 파일이 아니라 .xcworkspace 파일을 사용해야 합니다.

 

CocoaPods 업데이트 및 유지 관리

Pod 업데이트

설치된 라이브러리를 최신 버전으로 업데이트하려면 다음 명령어를 사용합니다.

pod update

 

Pod 제거

더 이상 필요 없는 라이브러리를 제거하려면 Podfile에서 해당 라이브러리를 삭제하고, 다음 명령어를 실행합니다.

pod install

 

 

에러 발생 시

만약 pod install 실행 중 문제가 발생한다면, 아래 명령어로 CocoaPods의 로컬 저장소를 업데이트 해보시면 됩니다.

pod repo update

 

 

오늘은 여기까지 :)

---

감사합니다.

 

잘못된 내용이 있거나 더 좋은 내용 피드백은 언제나 환영합니다!

궁금하신 부분은 댓글로 질문 부탁드립니다!