Unity에서 CocoaPods를 인식하지 못하는 문제 해결: macOS 기본 Ruby 문제 해결 방법

Unity에서 CocoaPods를 인식하지 못하는 문제 해결: macOS 기본 Ruby 문제 해결 방법

📌 블로그 포스팅 내용:

1. 문제 발생

Unity에서 iOS 빌드를 시도할 때, CocoaPods가 이미 설치되어 있음에도 불구하고 아래와 같은 오류 메시지가 발생함.

'gem install cocoapods --user-install' succeeded but the pod tool cannot be found.
It will not be possible to install CocoaPods in the generated Xcode project which will result in link errors when building your application.

2. 원인 분석

• Unity가 macOS 기본 Ruby(/usr/bin/ruby)를 사용하고 있었음.
• CocoaPods은 Homebrew로 설치한 최신 Ruby 환경에서 실행되도록 설정됨.
• Unity가 CocoaPods 실행 경로를 인식하지 못해 CocoaPods를 찾을 수 없다고 판단함.

3. 해결 방법

🔹 해결 방법 1: Unity 실행 전에 CocoaPods 경로 등록 (가장 쉬운 방법)

Unity 실행 전에 CocoaPods 실행 경로를 $PATH에 추가하고 Unity Hub를 실행하면 해결됨.

export PATH="/opt/homebrew/lib/ruby/gems/3.4.0/bin:$PATH"
open -a "Unity Hub"

✅ Unity 실행 후 다시 iOS 빌드하면 오류 해결됨.

---

🔹 해결 방법 2: Unity iOS Resolver에서 CocoaPods 실행 경로 직접 지정

Unity에서 CocoaPods 실행 경로를 직접 입력하면 해결됨.

1. Unity 실행 후 Edit → Preferences → External Tools 이동
2. iOS Resolver 섹션 찾기
3. CocoaPods 실행 경로를 /opt/homebrew/lib/ruby/gems/3.4.0/bin/pod 로 변경
4. Unity 재시작 후 빌드 실행

✅ Unity가 CocoaPods 실행 파일을 올바르게 찾을 수 있음.

---

🔹 해결 방법 3: CocoaPods을 시스템 전역(/usr/local/bin)에 설치

위 방법으로도 해결되지 않는다면, CocoaPods을 macOS 기본 Ruby 환경에 강제로 설치하면 됨.

 

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

which pod

출력 결과가 /usr/local/bin/pod이면 정상적으로 설치된 것.

✅ Unity가 macOS 기본 Ruby를 사용하더라도 CocoaPods 실행 가능!

---

 

4. 결론

• Unity가 macOS 기본 Ruby(/usr/bin/ruby)를 사용하여 CocoaPods 실행 파일을 찾지 못한 것이 원인.
• Unity 실행 전에 Homebrew Ruby 경로를 $PATH에 추가하거나,
• Unity의 iOS Resolver에서 CocoaPods 실행 경로를 수동으로 지정하면 해결됨.
• 최후의 방법으로 CocoaPods을 시스템 전역(/usr/local/bin)에 설치하면 100% 해결됨.
• 이후 Unity에서 iOS 빌드를 실행하면 정상적으로 진행됨! 🎉