Mac Silicon - Flutter 설치 및 설정, flutter doctor 오류 해결

1. Android Studio 와 Xcode 설치

💡 Android Studio 설치 : https://developer.android.com/studio?hl=ko
💡 Xcode 설치 : https://developer.apple.com/xcode/

Android 스튜디오 및 앱 도구 다운로드 - Android 개발자  |  Android Developers

Xcode 15 - Apple Developer

 

Android SDK 설치

 

2. Flutter SDK 설치

💡 https://docs.flutter.dev/get-started/install/macos

macOS install

 

Flutter SDK 다운로드.

 

다운로드 및 해당 위치에 SDK 압축 해제.

# 해당 경로에 해당 디렉터리명으로 압축 해제
/Users/사용자명/Dev/flutter_sdk/flutter_3.13.6_arm

환경변수 등록 (.zshrc 파일 등록)

# ~/.zshrc 파일에 Flutter SDK 경로 등록
export PATH="$PATH:/Users/사용자명/Dev/flutter_sdk/flutter_3.13.6_arm/bin"

설치 확인

# 터미널 실행
flutter doctor

# 또는 (상세 확인)
flutter doctor -v

반응형

3. 각 오류들에 대한 해결

오류 1 : cmdline-tools component is missing

[!] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
    ✗ cmdline-tools component is missing

해결 1

1. Settings... - Languages & Frameworks - Android SDK 이동
2. SDK Tools 탭 선택
3. Android SDK Command-line Tools (latest) 체크 후 Apply 및 OK 설치

 

 

 

오류 2 : ! Some Android licenses not accepted.

[!] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
    ! Some Android licenses not accepted. To resolve this, run: flutter doctor --android-licenses

해결 2

# 터미널 실행
flutter doctor --android-licenses

 

오류 3 : Xcode installation is incomplete

[✗] Xcode - develop for iOS and macOS
	✗ Xcode installation is incomplete; a full installation is necessary for iOS and macOS development.
		Download at: https://developer.apple.com/xcode/download/
		Or install Xcode via the App Store.
		Once installed, run:
		sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
		sudo xcodebuild -runFirstLaunch

해결 3

# 터미널 실행
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch

 

오류 4 : CocoaPods not installed.

[!] Xcode - develop for iOS and macOS (Xcode 15.0.1)
	✗ CocoaPods not installed.
		CocoaPods is used to retrieve the iOS and macOS platform side's plugin code that responds to your plugin usage on
		the Dart side.
		Without CocoaPods, plugins will not work on iOS or macOS.
		For more info, see https://flutter.dev/platform-plugins
	To install see https://guides.cocoapods.org/using/getting-started.html#installation for instructions.

해결 4

# 터미널 실행
sudo gem install cocoapods

# 위 코드 실행 안될 경우
# brew로 cocoapods를 설치
brew install cocoapods

 

결과

 

4. Android Studio Plugins 설치

Settings... - Plugins 에서 Flutter 검색 후 Install
(Flutter SDK 와 Dart가 함께 설치됨)

 

 

 

5. Android 에뮬레이터 새창으로 띄우기 (Standalone Application)

 

해결

Settings... - Tools - Emulator 이동
Launch in a tool window 체크 해제
Apply 적용.

(기존 Emulator 는 종료 후 재실행)