Flutter 시작하기 - SDK 다운로드 및 환경 설정 가이드

Flutter는 Google에서 개발한 오픈소스 UI 프레임워크로, 단일 코드베이스로 iOS, Android, Web, Desktop 앱까지 개발할 수 있습니다.
이번 글에서는 Flutter를 처음 시작하는 분들을 위해 SDK 다운로드부터 환경 설정, 에뮬레이터 실행까지 단계별로 정리했습니다.

---

1. Flutter SDK 다운로드

Flutter 공식 홈페이지에서 운영체제에 맞는 SDK를 다운로드합니다.

• Flutter 공식 사이트: https://docs.flutter.dev/get-started/install
• Flutter SDK : https://docs.flutter.dev/install/archive

운영체제별 다운로드 링크:

• MacOS (Intel & Apple Silicon 지원) → https://docs.flutter.dev/get-started/install/macos
• Windows →https://docs.flutter.dev/get-started/install/windows
• Linux → https://docs.flutter.dev/get-started/install/linux

---

2. Flutter SDK 설치 경로 설정

(1) MacOS 기준

1. 다운로드한 SDK 압축 해제
   예시:
    
   unzip ~/Downloads/flutter_macos_arm64_*.zip
2. Flutter SDK를 원하는 경로로 이동
    
   mv flutter ~/development/flutter
3. 환경 변수 설정 
   ~/.zshrc 또는 ~/.bashrc 파일에 아래 내용을 추가:
    
   export PATH="$PATH:$HOME/development/flutter/bin"
4. 설정 적용
    
   source ~/.zshrc
5. Flutter 버전 확인
    
   flutter --version

---

(2) Windows 기준

1. 다운로드한 ZIP 파일을 압축 해제
2. Flutter SDK를 원하는 경로로 이동
   예: C:\src\flutter
3. 환경 변수 설정
   • 시작 → 환경 변수 편집 → 시스템 환경 변수 → Path 편집
   • C:\src\flutter\bin 경로 추가
4. 명령 프롬프트에서 버전 확인:
    
   flutter --version

---

3. Flutter Doctor 실행

설치 후, Flutter 환경 구성을 확인하기 위해 아래 명령어를 실행합니다:

 

flutter doctor

실행 시, 다음 항목들을 자동으로 검사합니다:

• Flutter SDK 설치 상태
• Android Studio, Xcode 등 개발 환경
• 에뮬레이터 설정 여부
• 필요한 라이브러리 및 플러그인

예시 출력

Doctor summary (to see all details, run flutter doctor -v): [✓] Flutter (Channel stable, 3.24.0, on macOS 14.5) [✓] Android toolchain - develop for Android devices [✓] Xcode - develop for iOS and macOS [✓] Chrome - develop for the web [✓] VS Code (version 1.91.0)

만약 [✗] 표시가 나온다면 Flutter가 자동으로 해결 방법을 안내해 주므로, 메시지에 따라 설정하면 됩니다.

---

4. Android Studio & Xcode 설정

Flutter 앱을 실행하려면 플랫폼별 개발 도구 설치가 필요합니다.

(1) Android Studio 설치

• 다운로드 링크: https://developer.android.com/studio
• 설치 후 Android SDK 및 Android Emulator 설정 필수

(2) Xcode 설치 (MacOS)

• Mac App Store에서 설치
• 설치 후 아래 명령어 실행:
   
  sudo xcode-select --switch /Applications/Xcode.app
  sudo xcodebuild -runFirstLaunch

---

5. Flutter 프로젝트 생성 및 실행

설정이 완료되면 Flutter 프로젝트를 생성하고 실행해봅니다.

 

flutter create my_app

cd my_app

flutter run

• 에뮬레이터 또는 실기기에서 앱이 정상적으로 실행되는지 확인합니다.

---

6. 마무리

여기까지 Flutter SDK 설치부터 환경 설정, 프로젝트 실행까지 완료했습니다.
다음 단계에서는 Flutter 패키지 사용법, GoRouter 적용, Riverpod 상태관리 등 실제 앱 개발에 필요한 내용을 다룰 예정입니다.