[Flutter] How to solve build errors

빌드 에러가 발생하는 상황

빌드 에러는 여러 상황에서 발생할 수 있다:

• 디버깅 모드로 빌드시
• Xcode에서 Runner/AppDelegate 파일에서 'No such module 'Flutter' 에러 발생
• Flutter SDK를 다운그레이드 또는 업그레이드한 경우
• pubspec.yaml 파일을 수정한 후 바로 빌드할 때

해결 방법

1. 프로젝트 루트 디렉터리에서:

   • lib 폴더와 pubspec.yaml 파일이 있는 위치로 이동

   • 터미널에 다음 명령어를 입력:

     rm -rf pubspec.lock
     flutter pub cache clean
     flutter clean
     flutter pub get

2. iOS 폴더에서:

   • cd ios 명령어로 이동

   • 다음 명령어를 실행:

     rm -rf Podfile.lock
     rm -rf Pods
     rm -rf ~/Library/Developer/Xcode/DerivedData/*
     pod deintegrate
     pod install
     pod cache clean --all
     pod install --repo-update --clean-install

     인텔 맥북을 사용하는 경우, 문제가 발생하면 arch -x86_64 pod deintegrate와 arch -x86_64 pod install 명령어를 시도해볼 수 있다.

3. Xcode에서:

   • Product -> Clean Build Folder를 선택하여 빌드 폴더를 정리한 후 다시 빌드

이 과정을 통해 빌드 캐시를 모두 삭제하고 새롭게 빌드를 진행할 수 있다.

추가 팁

• 위 과정은 Mac 환경을 기준으로 한다.
• 동일한 문제가 반복될 경우, Flutter와 Xcode의 최신 버전으로 업데이트하는 것도 고려해볼 수 있다.
• 문제가 지속되면 구체적인 에러 메시지를 참고하여 추가적인 검색과 해결을 시도하라.