[CocoaPods] 사용 방법 정리 (feat. M1 에서 설치 안되는 에러 해결하기)

목차)
1. CocoaPods 설치

2. 현재 CocoaPods 버전 확인 및 설치 확인

3. 프로젝트에 CocoaPods 초기화 하기 

4. 라이브러리 설치하기

feat.) pod 라이브러리 설치 진행시 M1에서 발생하는 에러 해결 방법

 

 

CoCoaPods 란?

iOS 및 macOS 앱 개발 생태계에서 널리 사용되는 라이브러리 관리 도구
Objective-C 와 Swift 언어를 모두 지원

 

 

참고)

모든 명령어는 터미널에서 실행한다.
$ 표시는 명령어 입력을 할 수 있는 프롬프트(prompt)임을 나타내는 것이다. 
명령어를 가져다 쓸 땐 $ 표시를 제외하고 가져다 쓰면 된다.

1. CocoaPods 설치

$ sudo gem install cocoapods

2. 현재 CocoaPods 버전 확인 및 설치 확인

$ pod --version

 

아래와 같이 현재 설치된 CocoaPods 버전이 나오면, 설치가 되었다는 뜻이다.

 

3.  프로젝트에 CocoaPods 초기화 하기

1.  프로젝트 디렉토리에서 터미널 열기 

터미널여는 방법

프로젝트 폴더에서
우클릭 → 서비스 → 터미널 or iTerm 열기 

2.  프로젝트에서 CocoaPods 초기화(세팅) 하기

$ pod init

 

pod init 을 명령하면 프로젝트 폴더에 Podfile 이 생성된 것을 볼 수 있다.

 

pod init 후 Podfile 생성

 

Podfile 에 들어가보면 아래와 같은 코드가 세팅되어 있을 것이다.

CocoaPods는 Ruby 라는 언어로 작동하여, Ruby로 작성된 파일이 열릴 것이다. 

 

 

Podfile

4. 라이브러리 설치하기

Popup 을 쉽게 개발 할 수 있도록 도와주는 라이브러리를 설치해보려고 한다.

 

exyte/PopupView GitHub

GitHub - exyte/PopupView: Toasts and popups library written with SwiftUI

 

위의 링크를 들어가면 CocoaPods로 설치 할 수 있는 코드를 하나 알려준다.

 

 

Popfile을 열어서 아래와 같이 코드를 추가하고 저장한 후에,

 

Podfile 라이브러리 추가

 

프로젝트 디렉토리에서 터미널을 열어 아래 명령어를 입력한다.

$ pod install

 

pod install 을 성공하면 폴더구조가 아래와 같이 구성되게 되는데,

 

 

라이브러리가 설치된 버전과 종속성을 기록한 Podfile.lock 이 생성되고,

xcode project(xcodeproj) 의 workspace(xcworkspace)가 생성된 것을 볼 수 있다.

 

주의)

지금 부터 모든 개발은 .xcworkspace 에서 진행되어야 한다.

그래야 프로젝트 빌드가 된다.

feat.)  pod 라이브러리 설치 진행 시 M1에서 발생하는 에러 해결 방법

CocoaPods 은 Third-party 라이브러리 관리 도구 인 만큼 여러가지 라이브러리들이 올라와 있다.

 

또한 오랫동안 운영된 만큼 안정성이 잡혀 추가 업데이트 주기가 긴 라이브러리들도 있다.

 

이로인해 발생할 수 있는 상황으로

개발자가 올린 라이브러리가 Intel 아키텍처에 맞게 빌드하여 업로드 한 것이고,
해당 라이브러리를 M1 에서 설치하려고 할 때 에러가 발생한다.

 

이를 해결하기 위해 M1 에서 설치 진행 시 문제가 발생하는 라이브러리를 인텔 아키텍쳐에서 다운받도록 하는 명령을 해주어야 한다.

 

$ arch -x86_64 pod install

 

arch 는 아키텍처 이며 x86_64 는 64비트 인텔 아키텍처를 의미한다.

 

M1은 Rosetta를 사용하여 M1 칩에서 x86_64 아키텍처로 실행하는것을 지원한다.

 

정리하면, 위의 명령어는 pod install 을 x86_64 아키텍처로 진행하라는 것이다.