[Flutter] 플러터 개발 환경 구축 for macOS

Android Studio

---

❶ Android Studio 설치 (JetBrains ToolBox로도 설치 가능)

brew install android-studio

 

❷ Android Studio 실행 - Setup Wizard - Install Type에서 Standard 선택 후 설치. Standard 선택 시 안드로이드 개발에 필요한 SDK, 빌드 툴, 에뮬레이터가 자동으로 설치된다. Setup Wizard는 Android Studio를 처음 실행했을 때 나온다.

Setup Wizard는 Android Studio를 처음 실행했을 때 나온다

❸ Settings(⌘ ,) - Android SDK 메뉴 - SDK Tools 탭 - Android SDK Command-line Tools 체크.

안드로이드도 개발한다면 위 5개 항목에 모두 체크해서 설치한다

❹ Flutter, Dart 플러그인 설치

Flutter, Dart 플러그인을 각각 검색해서 설치한다

 

Flutter / Dart SDK

---

💡 Flutter SDK를 설치하면 Dart SDK도 같이 설치된다.

brew install flutter

 

• Flutter SDK 설치 경로 : /opt/homebrew/Caskroom/flutter/<버전>/flutter
• Dart SDK 설치 경로 : <Flutter SDK 설치 경로>/bin/cache/dart-sdk
• flutter doctor -v 명령어를 입력하면 Flutter SDK 설치 경로를 확인할 수 있다.

 

 

개발 구성

---

iOS

❶ CocoaPods 설치 (iOS 프로젝트 의존성 관리 도구)

brew install cocoapods

 

❷ xCode 설치 (앱스토어 xCode 검색 후 직접 설치할 수도 있다)

# 맥 앱스토어 CLI 도구 mas 설치
brew install mas

# mas를 이용해서 xCode 설치
# 497... 숫자는 앱스토어 애플리케이션 ID
mas install 497799835

 

❸ xCode 명령줄 도구(command-line tools) 구성

sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'

 

❹ xCode 라이선스 동의

sudo xcodebuild -license

 

❺ (설치되어 있지 않다면) iOS 시뮬레이터 설치

xcodebuild -downloadPlatform iOS

 

❻ (애플 실리콘 맥 사용자가 인텔 기반 앱 개발 시) Rosetta 2 설치

sudo softwareupdate --install-rosetta --agree-to-license

 

Android

안드로이드 개발엔 아래 컴포넌트가 필요하다. 안드로이드 스튜디오를 실행하고 Setup Wizard에서 Standard를 선택했다면 자동으로 설치된다.

 

• Android SDK Platform, API
• Android SDK Command-line Tools
• Android SDK Build-Tools
• Android SDK Platform-Tools
• Android Emulator

 

만약 설치하지 않은 항목이 있다면 안드로이드 스튜디오 Settings(⌘ ,) - Android SDK 메뉴에서 필요한 항목을 체크한 뒤 저장하면 자동으로 설치된다.

SDK Platforms 탭

SDK Tools 탭

 

기타 설정

---

❶ 안드로이드 라이선스 동의

flutter doctor --android-licenses
# 약관 나오면 y 입력해서 동의(여러번 나옴)

 

❷ Dart, Flutter 애널리틱스 리포트(Telemetry) 비활성

flutter --disable-analytics
dart --disable-analytics

 

❸ Flutter 개발 환경 설정 잘됐는지 확인

flutter doctor

# Doctor summary (to see all details, run flutter doctor -v):
# [✓] Flutter (Channel stable, 3.24.1, on macOS 14.6.1 23G93 darwin-arm64, locale ko-KR)
# [✓] Android toolchain - develop for Android devices (Android SDK version 35.0.0)
# [✓] Xcode - develop for iOS and macOS (Xcode 15.4)
# [✓] Chrome - develop for the web
# [✓] Android Studio (version 2024.1)
# [✓] VS Code (version 1.92.2)
# [✓] Connected device (3 available)
# [✓] Network resources

 

 

에뮬레이터 기기 추가

---

Android

❶ Android Studio 실행 - 우측 상단 세로 ... 버튼 클릭 - Virtual Device Manager 클릭

 

❷ 좌측 상단 + Create Virtual Device 버튼 클릭. (기존 추가한 기기의 ▶︎ 버튼을 클릭하면 AVD가 시작된다)

 

❸ 하드웨어 선택 - 시스템 이미지 선택 - AVD name 지정후 생성

AVD name 지정 화면

❹ 빌드 및 실행

Android Studio 우측 메뉴바 - Device Manager 클릭 - ▶︎ 버튼 클릭 - (AVD 실행) - Run main.dart 버튼을 클릭하면 IDE 우측에 기기 미리 보기가 표시된다. Flutter의 모바일 개발은 Hot Reload를 지원하므로 변경 사항을 바로 확인할 수 있다.

 

❺ CLI 명령어

# 추가한 AVD 리스트 확인
~/Library/Android/sdk/emulator/emulator -list-avds

# 입력한 AVD Name 실행
~/Library/Android/sdk/emulator/emulator -avd <avd-name>

 

emulator 경로를 모두 입력하기 번거로우면 아래 Path를 ~/.zshrc 파일에 추가한다.

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator

# 추가 후 아래 명령어로 실행 가능
emulator -list-avds
emulator -avd <avd-name>

 

iOS

❶ Simulator.app 앱을 실행하면 이전에 선택했던 기기로 자동 실행된다. 기기를 변경하고 싶으면 왼쪽 상단 메뉴바 File - Open Simulator 클릭 후 원하는 기기를 선택한다.

 

❷ iOS 버전을 바꾸고 싶으면 xCode 실행 - Preference(⌘ ,) - Platforms 탭 - 좌측 하단 + 버튼 클릭 - iOS 선택 후 원하는 버전을 설치할 수 있다.

 

❸ 빌드 및 실행

Android Studio 우측 상단 기기 선택 버튼 - Open iOS Simulator 클릭 - (iOS 시뮬레이터 실행) - Run main.dart 버튼을 클릭하면 iOS 시뮬레이터에서 애플리케이션이 빌드되고 실행된다. 코드 변경 사항은 시뮬레이터를 통해서 즉시 확인할 수 있다.

 

❹ CLI 명령어

# 시뮬레이터에 설치된 모든 기기 리스트 확인
xcrun simctl list devices

# 특정 시뮬레이터 실행
xcrun simctl boot <device-udid>

# 시뮬레이터 앱 실행
open -a Simulator

# 실행중인 모든 시뮬레이터 종료
xcrun simctl shutdown all

 

 

DartPad

---

DartPad 사이트에서 직접 플러터 코드를 작성하고 실행해 볼 수 있다. 상단 Samples 메뉴를 클릭한 뒤 미리 정의되어 있는 플러터 템플릿을 선택할 수 있다.

 

---

글 수정사항은 노션 페이지에 가장 빠르게 반영됩니다. 링크를 참고해 주세요