[Flutter] 프로젝트 수정 후 꼭 실행해야 할 명령어 정리 (iOS/Android 구분)

Flutter로 앱을 개발하다 보면, 패키지를 추가하거나 프로젝트 설정을 변경한 후 앱이 실행되지 않거나 에러가 발생하는 경우가 있다.
이럴 때 필요한 기본적인 명령어들이 있으며, 특히 iOS와 Android에서는 약간씩 처리 방법이 다르기 때문에 구분해서 관리해야 한다.

이번 글에서는 flutter clean, flutter pub get, pod install 등의 명령어를 언제, 왜 실행해야 하는지 쉽게 정리한다.

1. 패키지 추가, 수정, 삭제 후 기본적으로 해야 할 작업

패키지를 추가하거나 삭제, 수정한 경우에는 Flutter 프로젝트를 깨끗하게 초기화하고 새로 의존성을 받아야 한다.
이 작업은 iOS와 Android 모두 공통적으로 필요하다.

flutter clean
flutter pub get

• flutter clean : 이전 빌드 파일, 캐시 파일 등을 모두 삭제하여 프로젝트를 깔끔하게 초기화한다.
• flutter pub get : pubspec.yaml 파일에 명시된 패키지 의존성 목록을 다시 받아온다.

2. iOS 빌드를 위한 추가 작업

Flutter에서 기본적인 작업을 했더라도, iOS 빌드에서는 별도로 CocoaPods를 통해 네이티브 라이브러리 의존성을 설치해야 한다.

iOS 추가 명령어 실행 순서

cd ios
pod install​

• cd ios : iOS 디렉토리로 이동한다.
• pod install : iOS 네이티브 라이브러리(CocoaPods 의존성)를 설치. 프로젝트 경로/ios/Podfile 이 생성되면 완료.

만약 iOS 빌드 중에도 에러가 발생하는 경우, 다음 명령어를 추가로 사용해야 할 수 있음.

pod repo update
pod deintegrate
pod install

• pod repo update : CocoaPods 저장소를 최신 상태로 업데이트한다.
• pod deintegrate : 기존에 설치된 Pods를 제거한다.
• pod install : 다시 네이티브 라이브러리를 설치한다.

특히 새로운 패키지를 추가했는데도 빌드 오류가 난다면 pod install로 해결되는 경우가 많다. 그래도 문제가 계속된다면 pod repo update나 pod deintegrate를 시도해볼 필요가 있다.

3. Android 빌드를 위한 추가 작업

Android는 Flutter 기본 명령어만으로 대부분 문제가 해결된다. 별도로 추가적인 명령어를 실행할 필요는 거의 없다.

Android 기본 명령어 실행 순서

flutter clean
flutter pub get

 

Android 빌드 중 에러가 발생한다면, Android Studio 내 기능인 Invalidate Caches & Restart를 사용해 캐시를 초기화할 수 있다.

또는 필요한 경우 android/build.gradle, gradle.properties 등을 수정한 후 다시 빌드하면 된다.

4. 명령어 요약 정리

상황명령어 순서추가 설명

패키지 추가/변경	flutter clean → flutter pub get	iOS, Android 공통
iOS 빌드	cd ios → pod install	iOS 전용 작업
iOS 빌드 에러 발생 시	pod repo update 또는 pod deintegrate 후 pod install	필요 시 추가 작업
Android 빌드 에러 발생 시	Android Studio > Invalidate Caches & Restart	캐시 문제 해결

5. 추가로 알아두면 좋은 명령어

• flutter pub upgrade : 모든 패키지를 최신 버전으로 업그레이드할 때 사용한다.
• flutter pub outdated : 업데이트할 수 있는 패키지 목록을 확인할 때 사용한다.
• flutter doctor : 현재 개발 환경 상태를 점검하고 필요한 수정사항을 확인할 수 있다.

Flutter 프로젝트를 수정한 후 제대로 동작시키기 위해서는 반드시 몇 가지 기본 명령어를 실행해야 한다.
특히 iOS의 경우 pod install 작업이 추가로 필요하다는 점을 꼭 기억해야 한다.

처음에는 번거롭게 느껴질 수 있지만, 몇 번 해보면 자연스럽게 손에 익는다.
항상 깔끔한 빌드를 위해 습관적으로 위 명령어들을 실행하는 습관을 들이자.