VS Code로 Flutter 안드로이드 앱 만들기 — 개요

Flutter SDK 설치

#flutter #sdk #설치 #환경설정

@devpc | 2026-04-01 23:22:52 |

Context:

Flow v1 → Node v1

# Flutter SDK 설치

## 공식 다운로드

Flutter SDK는 공식 사이트에서 다운로드합니다.

👉 https://docs.flutter.dev/get-started/install

운영체제에 맞는 탭(Windows / macOS / Linux)을 선택하세요.

## Windows 설치

### 1. SDK 다운로드 및 압축 해제

1. 위 링크에서 최신 Flutter SDK `.zip` 파일 다운로드
2. `C:\src\flutter` 경로에 압축 해제
   - **주의:** `C:\Program Files\` 처럼 관리자 권한이 필요한 경로는 피하세요

### 2. 환경변수 PATH 추가

1. 시작 메뉴 → "환경 변수" 검색 → "시스템 환경 변수 편집" 클릭
2. "환경 변수" 버튼 → 사용자 변수의 `Path` 선택 → "편집"
3. "새로 만들기" → `C:\src\flutter\bin` 입력 → 확인

### 3. 설치 확인

새 터미널(PowerShell 또는 명령 프롬프트)을 열고 실행:

```bash
flutter --version
```

버전 정보가 출력되면 성공입니다.

## macOS 설치

### 1. Homebrew로 설치 (권장)

```bash
brew install --cask flutter
```

### 2. 수동 설치

1. 공식 사이트에서 `.zip` 다운로드
2. `~/development/flutter` 경로에 압축 해제
3. `~/.zshrc` 또는 `~/.bash_profile`에 추가:

```bash
export PATH="$HOME/development/flutter/bin:$PATH"
```

4. 터미널 재시작 후 확인:

```bash
flutter --version
```

## flutter doctor 실행

설치 후 반드시 아래 명령을 실행해 누락된 항목을 확인하세요.

```bash
flutter doctor
```

출력 예시:
```
[✓] Flutter (Channel stable)
[✓] Android toolchain
[✗] Xcode - iOS 개발 도구 (macOS만 해당)
[✓] VS Code
[✓] Connected device
```

`[✗]` 항목은 이후 단계에서 순서대로 해결합니다. 안드로이드 앱만 개발한다면 Xcode 항목은 무시해도 됩니다.

Flutter SDK 설치