플러터 빌드 에러 시 해결법

앱 빌드 에러 시 제일 먼저 해봐야 하는 것

 

안녕하세요, 앱개발지식나눔입니다.

오늘은 플러터 코드 작성 시 코드 에러가 아닌 컴파일하는 과정 중에 에러가 발생하면 제일 먼저 해봐야 하는 조치를 알려드리겠습니다.

(맥북 기준입니다)

 

빌드 에러가 발생하는 상황은 아래와 같은 상황에서 자주 발생합니다.

 

• XCode에서 Runner/AppDelegate에서 'No such module 'Flutter'
• 플러터 SDK 다운그레이드 혹은 업그레이드
• Pubspec.yaml 추가 삭제 후 바로 빌드

 

이 문제를 해결하기 위한 가장 빠른 방법은

 

1. lib폴더가 있는 위치로 이동합니다.(pubspec.yaml과 같은 위치)

2. 안드로이드 스튜디오 혹은 VS Code 터미널에 

 

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

 

를 입력합니다. (한꺼번에 복사해서 입력해도 순서대로 잘 작동합니다.)

 

3. ios 폴더로 이동합니다. (cd ios)

4. 아래 코드를 붙여 넣습니다.

 

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을 입력해보세요)

 

5. XCode를 열어 Product -> Clean Build Folder를 클릭합니다.

 

이 과정을 거친 후 다시 빌드하시면 이전 캐시가 모두 사라진 상태에서 새롭게 빌드를 진행할 수 있습니다.