[Flutter/xcode] `CocoaPods not installed or not in valid State` 오류

송상민·2022년 11월 7일
0

Flutter

목록 보기
10/13
post-thumbnail

입사하고 앱을 유지보수 하는 도중 아래 오류를 만나게 되었다
해결하는 과정을 정리해보자!

Warning: CocoaPods is installed but broken. Skipping pod install.
  You appear to have CocoaPods installed but it is not working.
  This can happen if the version of Ruby that CocoaPods was installed with is different from the one being used to invoke it.
  This can usually be fixed by re-installing CocoaPods. For more info, see https://github.com/flutter/flutter/issues/14293.
To re-install:
  sudo gem install cocoapods

문제 종류💡

처음에는 Flutter를 통해 Xcode가 켜지지도 않았다.
빌드와 실행은 당연히 안되었다..

그래서 찾아보았는데 너무 잘 정리해주신 블로그가 있었다.

-> CocoaPod 에러 참고 링크

이 곳에선 총 세가지로 문제를 분류한다.

  1. CocoaPods 미설치

  2. CocoaPods 설치는 되어 있지만 설치가 꼬였음

  3. 안드로이드 스튜디오가 이상


1. CocoaPods 미설치

flutter doctor -v를 실행하여서 CocoaPods의 설치와 연결이 잘 되어있는지 확인해 본다.

[✓] Xcode - develop for iOS and macOS (Xcode 13.4)
    • Xcode at /Applications/Xcode.app/Contents/Developer
    • CocoaPods version 1.11.3

설치가 제대로 되어있고 연결이 잘 되어 있다면 위와 같이 CocoaPods의 버전이 정상적으로 출력됩니다. 출력되지 않을 경우
CocoaPods 설치 가이드를 참고하여 설치 하면 된다. 또 다른 방법으로는 brew를 통해 설치 할 수 있는데 brew 설치 가이드를 참고하여 brew 설치 후

brew install cocoapods

를 통해 Cocoapods를 설치 할 수 있습니다.

2. Cocoapods 설치가 꼬인 경우

OS 업데이트를 진행했을 경우, 커맨드 라인 도구들이 엉망이 되었을 가능성이 높다.

sudo gem uninstall cocoapods

명령어를 실행하여 설치된 CocoaPods를 완전히 제거한 후 CocoaPods를 다시 설치하면 문제를 해결할 수 있다.

3. 안드로이드 스튜디오가 이상해진 경우

CocoaPods를 재설치해도 문제가 해결되지 않고, flutter doctor에서도 Cocoapods를 정상적으로 인식하고 있을 때

안드로이드 스튜디오 메뉴에서 File > Invalidate Caches/Restart 를 실행하면 문제를 해결할 수 있었다.


나는 처음에는 2번이 문제였지만 나중에는 3번까지 연결되어서 잘 해결하였다.

플러터는 참 여러가지 오류들이 나서 이런 오류를 정리해주는 분들이 늘어났으면 좋겠다!

profile
실력있는 Flutter 개발자가 되어보자

0개의 댓글