(Flutter) iOS 빌드 시 Cocoapods 설치 오류 해결하기

Jan 17, 2025

by 설화
서재 수첩 공방

Flutter 프로젝트를 빌드하는 과정에서 CocoaPods를 사용하는 iOS 프로젝트의 의존성을 최신 상태로 유지하려면 CocoaPods가 제대로 설치되어 있어야 합니다. 하지만, 때때로 설치 과정에서 오류가 발생할 수 있습니다. 최근 제가 경험한 CocoaPods 설치 오류를 해결하는 방법을 공유하려 합니다.

문제 상황

Flutter 프로젝트를 빌드하는 과정에서 pod repo update 명령어를 실행했으나 오류가 발생했습니다. 이를 해결하기 위해 flutter doctor 명령어를 실행한 결과, Xcode에서 CocoaPods가 설치되지 않았다는 메시지가 출력되었습니다. 이미 gem을 통해 CocoaPods를 설치한 상태였지만, 설치가 실패하여 이를 해결하려고 여러 가지 방법을 시도했습니다. 결국 Ruby 환경 문제로 인해 CocoaPods 설치에 실패했다는 사실을 알게 되었고, Homebrew와 rbenv를 사용해 문제를 해결할 수 있었습니다.

해결 방법

1. rbenv 설치

CocoaPods 설치 실패의 주요 원인은 Ruby 환경 문제였습니다. 이를 해결하기 위해 먼저 rbenv를 설치합니다.

rbenv는 Ruby 버전을 관리하는 도구로, 이를 통해 Ruby 버전을 관리할 수 있습니다.

brew update
brew install rbenv ruby-buildshell

rbenv가 제대로 설치되었는지 확인하려면 아래 명령어로 설치된 Ruby 버전을 확인합니다.

rbenv versionsshell

2. Ruby 설치

설치할 수 있는 Ruby 버전을 확인하려면 아래 명령어를 실행합니다.

rbenv install -lshell

원하는 Ruby 버전을 설치합니다. 예를 들어 3.2.0 버전을 설치할 수 있습니다.

rbenv install 3.2.0shell

설치 후에는 rbenv로 현재 사용 중인 Ruby 버전을 확인합니다.

rbenv versionsshell

3. Ruby 환경 설정

rbenv를 사용해 전역 Ruby 버전을 설정합니다.

rbenv global 3.2.0shell

그리고 zsh 환경에서 rbenv를 제대로 사용할 수 있도록 .zshrc 파일을 엽니다.

code ~/.zshrcshell

아래의 코드를 추가합니다.

[[ -d ~/.rbenv  ]] && \
  export PATH=${HOME}/.rbenv/bin:${PATH} && \
  eval "$(rbenv init -)"shell

4. CocoaPods 설치

이제 sudo gem install cocoapods 명령어를 실행하여 CocoaPods를 설치할 수 있습니다.

sudo gem install cocoapodsshell

5. flutter doctor 실행

설치가 완료되면 flutter doctor 명령어를 실행하여 Flutter 개발 환경이 정상적으로 설정되었는지 확인합니다.

flutter doctorshell

이제 오류 없이 정상적으로 iOS 빌드가 가능해졌습니다.

마무리

이번 CocoaPods 설치 오류를 해결하는 과정에서 rbenv를 활용해 Ruby 환경을 재설정하고, CocoaPods을 정상적으로 설치할 수 있었습니다. CocoaPods와 같은 의존성 관리 도구는 Flutter iOS 프로젝트를 빌드하는 데 중요한 역할을 하므로 환경을 제대로 설정하는 것이 필수적입니다.

Flutter 개발을 진행하는 동안 CocoaPods 관련 문제를 자주 만나게 될 수 있습니다. 이를 해결하기 위해서는 주기적으로 Ruby 환경을 점검하고, CocoaPods의 버전을 최신 상태로 유지하는 것이 좋습니다. 또한, pod install 또는 pod update 명령어를 사용하여 의존성을 관리하는 것도 중요한 팁입니다.

이 글이 Flutter 개발에 도움이 되었기를 바랍니다.