Unity iOS 빌드 오류 해결 - Ruby 버전 문제 및 CocoaPods 설치 실패

Unity iOS 빌드 오류 해결 - Ruby 버전 문제 및 CocoaPods 설치 실패

 

 

1. 문제 개요

Unity에서 iOS 빌드를 진행하는 과정에서 External Dependency Manager > iOS Resolver를 통해 CocoaPods을 설치하려 했으나, 설치가 정상적으로 이루어지지 않았다.

발생한 주요 오류

• pod install 실행 시 CocoaPods 설치 실패
• Unity에서 "Unsupported Ruby version 2.6.10" 오류 발생
• 터미널에서 ruby --version을 확인하면 최신 버전(3.4.2)이 출력되지만, Unity는 여전히 macOS 기본 Ruby(2.6.10)를 참조
• Unity Hub를 통해 실행하면 환경변수가 반영되지 않음

결과적으로, Unity가 실행될 때 사용하는 Ruby 버전이 터미널과 다르게 설정되어 발생하는 문제였다.

---

2. 원인 분석

• macOS 기본 Ruby는 2.6.x이며, 최신 CocoaPods은 이를 지원하지 않음
• Homebrew를 통해 최신 Ruby(3.4.2)를 설치했지만, Unity 실행 환경에서는 반영되지 않음
• Unity Hub를 통해 실행하면 macOS의 기본 환경변수(/usr/bin/ruby)를 사용하여 CocoaPods이 설치되지 않음

따라서, Unity가 실행될 때 최신 Ruby 경로를 올바르게 참조하도록 설정해야 한다.

---

3. 해결 방법

1️⃣ CocoaPods 실행 경로 확인 및 PATH 설정

터미널에서 CocoaPods의 설치 경로를 확인한다.

which pod

 

예제 출력:

/opt/homebrew/lib/ruby/gems/3.4.0/bin/pod

 

위 경로를 환경변수에 추가한다.

(zsh 사용자)

echo 'export PATH="/opt/homebrew/lib/ruby/gems/3.4.0/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

(bash 사용자)

echo 'export PATH="/opt/homebrew/lib/ruby/gems/3.4.0/bin:$PATH"' >> ~/.bash_profile
source ~/.bash_profile

---

2️⃣ Unity 실행 파일의 정확한 경로 확인

Unity가 설치된 경로를 찾는다.

find /Applications -name "Unity.app"

예제 출력:

/Applications/Unity/Hub/Editor/6000.0.26f1/Unity.app

---

3️⃣ Unity를 직접 실행하여 환경변수 적용

Unity Hub를 통해 실행하면 환경변수가 반영되지 않으므로, 터미널에서 Unity를 직접 실행한다.

open /Applications/Unity/Hub/Editor/6000.0.26f1/Unity.app

또는, Unity의 실행 파일을 직접 실행할 수도 있다.

/Applications/Unity/Hub/Editor/6000.0.26f1/Unity.app/Contents/MacOS/Unity

이제 CocoaPods 설치 및 iOS 빌드를 다시 시도한다.

---

4️⃣ Unity 실행을 간소화하기 위한 심볼릭 링크 생성

매번 긴 명령어를 입력하는 것이 불편할 경우, 심볼릭 링크를 생성하여 unity 명령어로 실행할 수 있도록 한다.

sudo ln -s /Applications/Unity/Hub/Editor/6000.0.26f1/Unity.app/Contents/MacOS/Unity /usr/local/bin/unity

이후 터미널에서 다음 명령어만 입력하면 Unity가 실행된다.

unity

---

4. 마무리 및 정리

핵심 정리

✅ Ruby 3.x가 설치되어 있어도, Unity는 기본적으로 macOS의 Ruby 2.6.x를 참조한다.
✅ Unity Hub를 사용하면 환경변수가 반영되지 않으므로, 터미널에서 Unity를 직접 실행해야 한다.
✅ CocoaPods 설치가 실패할 경우, Ruby 경로를 직접 설정해야 한다.
✅ 심볼릭 링크를 생성하면 Unity 실행을 편리하게 할 수 있다.

이제 동일한 문제를 겪고 있는 경우 위 과정을 차례로 적용하면 해결할 수 있다.

 

https://ssscool.tistory.com/795

맥북에서 Unity iOS 빌드 시 CocoaPods 설치 오류 해결 방법