이 오류는 Ruby에서 xcodeproj 라이브러리를 찾을 수 없을 때 발생합니다. 주된 원인은 다음과 같습니다.
xcodeprojgem이 설치되지 않았거나 손상됨- Ruby 환경 (
rbenv)이 올바르게 설정되지 않음 - Bundler를 사용해야 하는 환경에서 직접 실행
- 시스템 Ruby와
rbenvRuby 간의 충돌
아래 단계별로 문제를 해결합니다.
1. xcodeproj gem 설치 여부 확인
터미널에서 다음 명령어를 실행하여 xcodeproj gem이 설치되어 있는지 확인합니다.
gem list xcodeproj
출력에 xcodeproj가 포함되어 있지 않다면, 다음 명령어로 설치합니다.
gem install xcodeproj
설치 후, 다시 실행하여 문제가 해결되었는지 확인합니다.
2. rbenv 설정 확인
Ruby가 rbenv를 통해 올바르게 설정되었는지 확인합니다.
rbenv versions
현재 사용 중인 Ruby 버전이 2.7.5인지 확인하고, 아니라면 다음 명령어로 설정합니다.
rbenv global 2.7.5
rbenv rehash
또한, 올바른 Ruby 실행 파일이 사용되고 있는지 확인합니다.
which ruby
출력이 /Users/apple/.rbenv/shims/ruby와 같은 rbenv 관련 경로여야 합니다. 만약 /usr/bin/ruby와 같은 시스템 경로라면 rbenv가 제대로 적용되지 않은 것입니다. 이를 적용하려면 터미널에서 다음 명령어를 실행합니다.
eval "$(rbenv init -)"
이후 터미널을 재시작하고 다시 실행을 시도합니다.
3. Bundler 사용 (Gemfile이 있는 경우)
프로젝트 폴더에 Gemfile이 있는 경우, Bundler를 통해 종속성을 관리해야 합니다. 먼저, bundle install을 실행하여 필요한 gem을 설치합니다.
bundle install
그리고 명령어 실행 시 bundle exec을 사용해야 합니다.
bundle exec pod install
Bundler를 사용하지 않고 pod install을 실행하면 xcodeproj를 찾지 못할 가능성이 있습니다.
4. GEM_HOME 및 GEM_PATH 설정 확인
gem env를 실행하여 gem이 설치된 경로를 확인합니다.
gem env
출력된 GEM PATHS가 현재 사용 중인 Ruby 버전과 일치하는지 확인합니다. 만약 올바른 경로가 아니라면 다음 환경 변수를 설정합니다.
export GEM_HOME=$(gem env gemdir)
export PATH="$GEM_HOME/bin:$PATH"
이후, 다시 실행하여 문제가 해결되었는지 확인합니다.
5. 시스템 Ruby 충돌 확인
Mac에는 기본적으로 시스템 Ruby가 설치되어 있으며, rbenv를 사용하지 않을 경우 시스템 Ruby를 사용할 가능성이 있습니다. 이를 확인하려면 다음 명령어를 실행합니다.
which ruby
which gem
출력이 /usr/bin/ruby와 같은 시스템 경로라면 rbenv가 적용되지 않은 상태입니다. 이를 해결하려면 rbenv를 다시 초기화하고 적용합니다.
rbenv rehash
eval "$(rbenv init -)"
이후 터미널을 재시작하고 실행을 다시 시도합니다.
6. Cocoapods 관련 문제 해결 (pod install 사용 시)
만약 xcodeproj가 Cocoapods와 관련된 경우라면 Cocoapods를 재설치합니다.
gem uninstall cocoapods
gem install cocoapods
그리고 pod install을 실행할 때도 bundle exec을 사용하는 것이 좋습니다.
bundle exec pod install
결론
위 단계를 차례대로 진행하면서 xcodeproj gem이 정상적으로 로드되는지 확인합니다.
여전히 문제가 발생한다면, 사용 중인 Ruby 및 gem 환경 정보를 제공하면 추가로 진단할 수 있습니다.