📦 [iOS] CocoaPods를 활용한 iOS 라이브러리 설치 가이드

개요

안녕하세요 이서입니다🥳, 오늘은 코코아팟(CocoaPods)🥥에 대해 알아보려해요.

코코아팟은 iOS 및 macOS 프로젝트에서 외부 라이브러리 및 종속성을 관리하기 위한 오픈 소스 패키지 매니저에요. 코코아팟을 사용하면 아래와 같은 이점을 얻을 수 있어요.

1. 종속성 관리: 코코아팟을 사용하면 다른 개발자가 개발한 라이브러리나 프레임워크를 프로젝트에 쉽게 추가할 수 있어요. 이를 통해 개발자는 자신의 애플리케이션에서 기존 라이브러리를 사용하거나 프로젝트 간에 코드를 공유할 수 있어요.
2. 버전 관리: 다양한 라이브러리 및 프레임워크의 빌드 설정을 자동으로 처리할 수 있어요. 개발자는 복잡한 설정 파일을 직접 관리할 필요 없고, 코코아팟이 프로젝트 설정을 업데이트하고 라이브러리를 빌드해요.
3. 설정 및 빌드 자동화: 코코아팟은 빌드 설정을 자동으로 처리해요.
4. Swift 및 Objective-C 지원: Swift와 Objective-C를 모두 지원하며, 혼합하여 사용할 수도 있어요. 따라서 기존 Objective-C 프로젝트를 Swift로 마이그레이션하는 경우에도 원활하게 라이브러리를 관리할 수 있어요.

시작하기

gem 설치 확인

코코아팟을 사용하기 위해서는 우선 우리의 맥 컴퓨터에 gem이 설치되어 있어야해요. gem은 Ruby 프로그래밍 언어를 사용하여 RubyGem이라 불리는 패키지 또는 라이브러리를 관리하는 도구에요. 터미널에서 아래의 명령어를 통해 gem이 설치되어 있는지 확인하고, 정상적으로 버전이 표출되는지 확인해요.

gem -v

설치

정상적으로 버전이 표출되었다면 이제 코코아팟을 설치하고 업데이트해요.

sudo gem install cocoapods

sudo gem udpate cocoapods

🚨 만약 ERROR: While executing gem ... (Gem::FilePermissionError)와 같은 에러가 발생된다면, 아래의 링크 주소를 통해 해결해보세요!

Mac에서 Gem::FilePermissionError 에러 발생시 해결 방법

프로젝트 초기화

이제 터미널에서 우리의 프로젝트로 이동한 다음, 아래의 명령을 통해 코코아팟 프로젝트를 설정해요. 아래의 명령어를 실행하면 Podfile이라는 파일이 생성돼요. 해당 파일을 텍스트 에디터나, xcode에서 열어 필요한 라이브러리를 추가해요.

pod init

🚨 만약 Gem::GemNotFoundException와 같은 에러가 발생된다면 아래의 명령어를 입력 후 다시 시도해보세요!

sudo gem install -n /usr/local/bin cocoapods

라이브러리 추가

이제 Profile 파일이 정상적으로 생성되었다면, Alamofire라는 네트워킹 라이브러리를 추가해볼게요. (아래의 텍스트에서 target ‘MyApp’ do는 우리의 프로젝트 이름을 뜻해요. 따라서 정상적으로 여러분의 프로젝트 이름이 반영되어있는지 확인해보세요.)

# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'

target 'MyApp' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!

  # Pods for MyApp
	pod 'Alamofire'

end

라이브러리 적용

마지막으로 Podfile을 수정을 완료했으면, 라이브러리를 다운로드하고 프로젝트에 아래의 명령어를 통해 연결해요.

pod install

아래의 안내 문구가 나타났다면 xcworkspace를 통해 프로젝트를 열어야만 설치한 라이브러리를 사용할 수 있다는 뜻이에요. 현재 실행 중인 Xcode를 종료해요.

[!] Please close any current Xcode sessions and use `MyApp.xcworkspace` for this project from now on.

🚨 만약 [!] Couldn't determine repo type for URL: https://cdn.cocoapods.org/: Permission bits for '/Users/사용자명/.netrc' should be 0600, but are 644와 같은 문구가 나타났다면 아래의 명령어를 실행해주고 다시 위의 명령어를 실행해주세요.

chmod 600 ~/.netrc

이제 우리의 프로젝트를 아래의 명령어를 통해 Xcode를 실행합니다.

open MyApp.xcworkspace

끝!