[013] 플러터 (Flutter) Tip - cocoapods-downloader requires Ruby version >= 2.7.4 (ruby 버전 문제) 해결 방법

안녕하세요~ totally 개발자입니다.

 

패키지 등을 업데이트하여 빌드하려고 할 때 아래와 같은 에러를 마주하는 경우가 있습니다. sudo gem install cocoapods를 진행할 때 나올 수 있는 오류인데요. 여러 가지 방법을 시도해본 결과 다음의 방법으로 해결하였으니 참고하시면 좋을 것 같습니다.

 

There are no versions of cocoapods-downloader (>= 2.0) compatible with your Ruby & RubyGems. Maybe try installing an older version of the gem you're looking for?
        cocoapods-downloader requires Ruby version >= 2.7.4. The current ruby version is 2.6.10.210.

 

Step 1: 터미널에서 brew install rbenv 명령어를 입력하여 rbenv를 설치합니다. 

 

Step 2: rbenv init 명령어를 입력해주시고 which ruby 명령어를 입력해서 현재 경로가 어떻게 되는지 살펴봅니다. 만약 /usr/bin/ruby라면 eval "$(rbenv init - zsh)" 명령어를 입력하시면 됩니다. 그리고 다시 which ruby 명령어를 입력하여 경로를 재확인해줍니다.

/Users/사용자명/.rbenv/shims/ruby라고 나오면 됩니다.

 

Step 3: rbenv install -l 명령어를 터미널에 입력하여 어떤 버전을 설치할 것인지 확인해주시면 됩니다.

 

Step 4: 저는 3.2.2 버전으로 진행하겠습니다. rbenv install 3.2.2 명령어를 입력하여 설치합니다.

 

 

Step 5: rbenv global 3.2.2를 입력하여 ruby 버전을 변경해주고 ruby -v를 입력하여 버전을 체크해줍니다. 만약 ruby -v하였을 때 기존 버전이 그대로 나온다고 한다면 설치가 제대로 되지 않았거나 위의 경로가 제대로 세팅되지 않은 문제이기 때문에 Step 2부분을 다시 확인해주셔야 합니다.

잘 변경된 것을 알 수 있습니다.

 

 

Step 6: 그 후 sudo gem install cocoapods를 입력하시면 오류 없이 잘 실행되는 것을 확인하실 수 있습니다.

 

Step 7: 프로젝트 경로의 ios에 들어가셔서 pod install 진행하시고 빌드하시면 됩니다. 여기에서 만약에 에러가 나시면 pod update를 할 패키지가 있는 경우가 많습니다. (예를 들어 오류 부분에 Firebase/RemoteConfig 내용이 나온다면 pod update Firebase/RemoteConfig 명령어처럼 해당 패키지를 입력하여 업데이트 해야 합니다)

 

Step 8: 터미널에서 flutter run --debug lib/main.dart를 입력하여 실행해봅니다. 가끔 F5 디버그 모드는 오류가 나는 경우가 있어 F5 디버그 모드로 실행하는 것보다 처음에는 이 터미널 명령어로 실행하는 것이 좋습니다. 

 

잘 빌드된 것을 확인해볼 수 있습니다. 개발에 참고하시기 바랍니다. 감사합니다.