스파르타코딩 클럽/기초

Swift | CocoaPods 설치하기

UDDT 2025. 4. 26. 18:05

 CocoaPods 설치의 여정...

    CocodPods을 설치하면서 몇가지 오류를 겪어, 이를 정리해보고자 한다.

    CocodPods을 설치하는 방법은 여러가지가 있겠지만, 쉽게 접할 수 있는 방법은 2가지 인거 같다.

 

    1. brew를 사용해서 설치하는 법

    2. ruby를 사용해서 설치하는 법

 

    2번을 설치하다가 다음의 에러를 만나는데, 

ERROR:  Error installing cocoapods:

The last version of securerandom (>= 0.3) to support your Ruby & RubyGems was 0.3.2. Try installing it with `gem install securerandom -v 0.3.2` and then running the current command again

securerandom requires Ruby version >= 3.1.0. The current ruby version is 2.6.10.210.

 

    이는 cocoapods을 설치하려면, ruby version을 3.1.0 이상을 사용해야 하는데, 현재 버전이 낮아서 안된다는 에러이다.

   ruby를 업데이트 해주거나, brew를 사용하면 되는데 먼저 brew를 사용하여 설치하는 방법부터 보자.

 

 CocoaPods 설치: brew 사용하는 방법

    1. brew 설치하기

      https://brew.sh/ko/

 

Homebrew

The Missing Package Manager for macOS (or Linux).

brew.sh

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

 

    2. brew에서 cocoaPods 설치하기

brew install cocoapods

 

 

 CocoaPods 설치: ruby 사용하는 방법

    1. ruby에서 cocoaPods 설치하기

gem install cocoapods

 

  * 만약 버전 오류로 설치가 안된다면?

 

    2. ruby version 확인하기

ruby -v

 

   만약 여기서 3.2.0 버전 이상이 아니라면, ruby 업데이트를 해주도록 하자

 

     3. ruby 업데이트하기

brew install rbenv
rbenv install 3.2.2
rbenv global 3.2.2
ruby -v

 

     * ruby -v 했는데, 버전 업데이트가 안되어 있으면 3번의 과정도 하면 된다.

    4. ruby 업데이트가 반영이 안됐을때 조치사항

echo 'eval "$(rbenv init -)"' >> ~/.zshrc
source ~/.zshrc

 

    5. ruby 버전 rehash하기

rbenv global 3.2.2
rbenv rehash
ruby -v

 

    6. 다시 cocoaPods 설치하기

gem install cocoapods