Flutter ios 오류 발생시 해결방안 및 재설치 후 세팅방법 (최후의 방법)

들어가며: Flutter iOS 앱 개발 중 에러는 불가피한 부분입니다. 이런 에러를 해결하는데 많은 시간을 들이다가도 해결되지 않을 때가 있습니다.
(제 경우에는 'Flutter/Flutter.h' file not found 오류가 있었습니다.)
이 포스트에서는 iOS 프로젝트 폴더를 재생성하여 에러를 해결하는 방법을 소개합니다.
삽질에서 벗어나 기존 설정을 복구하고, 스트레스를 덜어보세요. (백업 필수)

본문:

iOS 앱 개발 중에 에러가 발생하는 경우, 원인을 찾는 것은 종종 어려운 일입니다. 이럴 때에는 기존 설정을 삭제하고 새로운 iOS 폴더를 생성하여 문제를 해결할 수 있습니다. 아래는 이 과정을 단계별로 안내하는 방법입니다.

1. 프로젝트 폴더 - ios 폴더 - Runner 폴더 백업:
먼저, 현재 iOS 폴더를 백업합니다. Runner 폴더의 중요 설정을 나중에 복구하기 위해 Xcode에서 TARGETS에 Runner를 탭별로 캡쳐해둘 것을 추천합니다.

2. iOS 폴더 삭제:
터미널을 실행하여 프로젝트 폴더 경로에서 아래 명령어를 입력하여 iOS 폴더를 삭제합니다.

   flutter create .

이 명령어를 실행하면 iOS 폴더를 포함한 여러 플랫폼 폴더가 생성됩니다. 필요한 플랫폼 폴더를 나중에 다시 추가할 수 있습니다.

3. 백업해둔 Runner 폴더를 iOS 폴더에 덮어씌우기:
백업해두었던 Runner 폴더를 iOS 폴더에 덮어씌웁니다. Info.plist, GoogleService-Info.plist 같은 파일은 직접 Xcode를 통해 Runner 폴더 안에 넣어줍니다.

4. 설정 복원 확인:
2번에서 찍었던 캡쳐와 같이 설정이 복원되었는지 확인하고, 복원되지 않았다면 캡쳐/백업 파일과 대조하여 재설정해주세요.

5. 패키지 다시 설치하기:
터미널을 실행하여 프로젝트 폴더 경로에서 아래 명령어를 입력하여 패키지를 다시 설치합니다.

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

이어서 iOS 폴더 경로에서도 패키지를 다시 설치합니다.

   rm -rf Podfile.lock (존재할 경우)
   rm -rf Pods (존재할 경우)
   rm -rf ~/Library/Developer/Xcode/DerivedData/*
   pod deintegrate
   pod cache clean --all
   pod install --repo-update --clean-install
   (안되면) arch -x86_64 pod install --repo-update --clean-install

마지막으로 Xcode에서 [Product] - [Clean Build Folder]도 실행해주세요.

결론:
위와 같은 과정을 따라가면 대부분의 iOS 앱 개발 에러를 해결할 수 있습니다. 물론, 더 간단한 해결 방법이 있을 수도 있지만, 문제가 복잡할 때 이 방법을 사용하는 것을 추천합니다.

마무리:
iOS 앱 개발 중에 발생하는 에러는 매우 까다롭습니다. 그러나 이러한 문제에 직면했을 때 iOS 폴더를 재생성하는 방법을 알고 있다면, 문제를 더 빨리 해결할 수 있을 것입니다. 이 글이 도움이 되기를 바랍니다.

해당 방법 이후 추가 세팅방법을 알고싶으면 https://jakezo.tistory.com/33  를 확인해주세요