플러터 ios 캐시 삭제하기
오늘은 Flutter iOS 앱 개발 중 빌드 오류와 의존성 문제를 해결하기 위해 캐시를 삭제하는 작업을 진행했다. 종종 의존성 충돌이나 빌드 실패 같은 문제가 발생할 때는 캐시가 문제의 원인이 될 수 있다. 캐시를 삭제하면 프로젝트가 처음부터 새롭게 빌드되기 때문에 이러한 문제를 해결하는 데 효과적이다.
1. 언제 캐시를 삭제해야 할까?
이번 작업을 진행하면서 캐시 삭제가 필요한 경우를 다시 한번 정리해봤다. 주로 다음과 같은 상황에서 캐시를 삭제하는 것이 도움이 된다:
- 의존성 충돌: 새로 추가한 패키지가 충돌하거나 버전이 맞지 않을 때.
- 빌드 실패: 갑자기 프로젝트가 빌드되지 않을 때.
- 변경 사항이 반영되지 않을 때: 코드 수정 후에도 빌드 결과에 반영되지 않을 때.
- 의존성 업데이트 후: flutter pub get이나 pod install 후 앱이 제대로 실행되지 않을 때.
2. iOS 빌드 캐시 삭제
2-1. Podfile.lock, Pods 디렉토리 삭제
먼저 iOS 프로젝트의 디렉토리로 이동한 후, CocoaPods에서 관리하는 파일들과 디렉토리를 삭제했다. 이는 iOS 프로젝트가 참조하는 외부 라이브러리를 다시 설치하기 위함이다.
cd ios/
rm Podfile.lock
rm Podfile
rm -rf Pods이 명령어들은 Podfile.lock, Podfile, 그리고 Pods 디렉토리를 삭제해준다. 이를 통해 CocoaPods에서 관리하는 모든 의존성을 초기화했다.
2-2. CocoaPods 캐시 삭제
다음으로 CocoaPods에 저장된 모든 캐시를 삭제했다. 이 작업을 통해 기존의 잘못된 캐시를 제거하고, pod install 시 최신 라이브러리를 다시 설치할 수 있다.
pod cache clean --all이 명령어를 실행한 후, CocoaPods 캐시가 깔끔하게 정리되었다. 이제 최신 상태로 의존성을 다시 설치할 준비가 끝났다.
3. Flutter 캐시 삭제 및 의존성 재설치
3-1. Flutter 캐시 정리
iOS 캐시를 삭제한 후에는 Flutter에서 생성된 캐시도 함께 정리했다. ios 디렉토리 밖으로 나와 Flutter 프로젝트 전체 캐시를 삭제했다.
cd ..
flutter cleanflutter clean 명령어는 Flutter 프로젝트의 빌드 캐시와 임시 파일을 모두 삭제한다. 이를 통해 이전 빌드에 관련된 파일들이 제거되어, 빌드 오류가 해결될 가능성이 높아졌다.
3-2. 의존성 다시 설치
캐시를 삭제한 후, flutter pub get을 실행해 프로젝트에서 필요한 의존성을 다시 가져왔다.
flutter pub get이 명령어는 Flutter에서 사용하는 모든 패키지를 다시 설치해준다. 이렇게 의존성을 새로 설정하면, 빌드 과정에서 발생하는 문제를 최소화할 수 있다.
4. CocoaPods 재설치
4-1. pod install 명령어 실행
캐시 삭제 작업이 끝난 후, iOS 프로젝트로 다시 이동하여 pod install을 실행했다. 이 작업은 Podfile에 정의된 모든 CocoaPods 의존성을 다시 설치하는 과정이다.
cd ios/
pod installpod install이 성공적으로 완료되었으며, 필요한 모든 라이브러리가 업데이트된 상태로 다시 설치되었다. 이제 iOS 빌드에서 사용할 수 있는 최신 라이브러리들이 준비되었다.
5. IDE 재시작
캐시 삭제 및 재설치 작업이 끝난 후, Xcode를 재시작했다. 캐시 삭제 후 IDE를 재시작하는 것은 IDE가 새롭게 설치된 의존성을 제대로 인식하고, 모든 설정이 다시 로드되도록 하는 중요한 단계다.
6. 마무리
캐시를 정리하고 의존성을 재설치한 후, 프로젝트를 다시 빌드했다. 빌드 오류가 사라지고, 정상적으로 앱이 실행되었다. 이번 과정을 통해 캐시 삭제가 Flutter iOS 개발에서 발생하는 다양한 빌드 문제를 해결하는 데 얼마나 중요한지 다시 한번 느낄 수 있었다. 캐시를 정리하는 작업은 복잡한 문제를 해결하는 데 매우 효과적인 방법이므로, 앞으로도 빌드 오류가 발생할 때는 우선적으로 시도해야 할 해결 방법 중 하나로 활용할 예정이다.