Flutter 기본 및 설치 가이드

1️⃣ Flutter 설치 준비

✅ 시스템 요구사항

🟣 macOS

• 운영체제: macOS (Intel 또는 Apple Silicon)
• 디스크 공간: 2.8 GB (IDE 및 기타 도구 제외)
• 도구: Git, Xcode (iOS 개발 시)

🔵 Windows

• 운영체제: Windows 10 이상 (64-bit)
• 디스크 공간: 1.64 GB (IDE 및 기타 도구 제외)
• 도구: PowerShell 5.0 이상, Git

---

2️⃣ Flutter SDK 설치

Windows

# 1. Flutter SDK 다운로드
https://flutter.dev/docs/get-started/install/windows

# 2. 압축 해제
C:\src\flutter

# 3. 환경변수 설정
setx PATH "%PATH%;C:\src\flutter\bin"

# 4. 설치 확인
flutter doctor

macOS

1. Flutter SDK 다운로드 및 설치

• Flutter 공식 SDK 다운로드

수동 설치 방법:

# 1. Flutter SDK 다운로드
https://docs.flutter.dev/get-started/install/macos

# 2. 압축 해제 및 이동
unzip ~/Downloads/flutter_macos_*.zip -d ~/development

# 3. PATH 설정
echo 'export PATH="$PATH:\$HOME/development/flutter/bin"' >> ~/.zshrc
source ~/.zshrc

# 4. 설치 확인
flutter doctor

2. Homebrew 설치

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

⚠️ Apple Silicon Mac에서 Homebrew 인식 오류 해결

• 설치 후에도 brew 명령어가 동작하지 않는 경우:

echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

3. Flutter SDK 설치 (Homebrew 사용)

brew install --cask flutter

3. CocoaPods 설치 (iOS 빌드 시 필요)

sudo gem install cocoapods

⚠️ CocoaPods 설치 오류 해결

• 설치 중 오류가 발생할 경우:

sudo arch -x86_64 gem install ffi
pod install --repo-update

4. PATH 설정

echo 'export PATH="$PATH:\$HOME/flutter/bin"' >> ~/.zshrc
source ~/.zshrc

5. 설치 확인

flutter doctor

---

3️⃣ 개발 환경 설정

✅ macOS 환경변수 설정 파일

• 파일 위치: ~/.zshrc (기본 쉘이 Zsh인 경우)
• 숨김 파일 보기 단축키: Command + Shift + .

✅ VSCode로 숨김 파일 수정하기

code ~/.zshrc

✅ Android 개발 환경

• Android Studio 설치 (다운로드)
• Android SDK 설치 및 환경변수 설정
• Android Emulator 또는 실제 디바이스 연결

✅ iOS 개발 환경 (macOS)

• Xcode 설치 (Mac App Store)
• Xcode Command Line Tools 설치
• iOS 시뮬레이터 또는 실제 디바이스 연결

✅ 에디터(IDE)

• Visual Studio Code + Flutter/Dart 확장 프로그램 설치
• Android Studio + Flutter 플러그인 설치

---

4️⃣ Flutter Doctor 실행 및 문제 해결

flutter doctor 명령어를 사용해 Flutter 개발 환경이 올바르게 설정되었는지 확인합니다.

flutter doctor

출력 결과를 확인하고, 필요 시 추가 설치 및 설정을 진행합니다.

---

5️⃣ 첫 번째 Flutter 앱 실행

✅ 프로젝트 생성

flutter create my_first_app
cd my_first_app

✅ 앱 실행

# Android 에뮬레이터 또는 연결된 디바이스에서 실행
flutter run

✅ 코드 수정 및 핫리로드(Hot Reload)

• lib/main.dart 파일을 수정하고 Hot Reload로 즉시 결과 확인
• Ctrl + S 또는 r 키로 빠른 반영 가능

---

6️⃣ 자주 발생하는 설치 이슈 및 해결 방법

❗ ANDROID_HOME 오류

• 문제: Android SDK 경로를 찾을 수 없음
• 해결:

  export ANDROID_HOME=\$HOME/Library/Android/sdk
  export PATH=\$PATH:\$ANDROID_HOME/tools
  export PATH=\$PATH:\$ANDROID_HOME/platform-tools

❗ 디바이스 연결 안 됨

• 문제: 연결된 디바이스를 인식하지 못함
• 해결:

  flutter devices
  adb devices

❗ iOS 빌드 실패

• 문제: macOS에서 iOS 빌드가 실패함
• 해결:

  sudo xcode-select --install
  sudo xcodebuild -license

---

7️⃣ 마무리

🔗 참고 자료

• Flutter 공식 문서
• Dart 언어 공식 사이트

Flutter 시작! 🚀