Flutter 개발 환경 세팅, VS Code부터 AVD까지 한 번에 끝내기

BahnSeo 2025. 8. 21. 09:27

안녕하세요! VS Code와 Gemini CLI를 연동하셨다면 이제 Flutter로 프로그램을 개발할 차례입니다.

이번 포스팅에서는 VS Code에서 Flutter 개발 환경을 설정하고, Android Studio를 활용해 AVD(Android Virtual Device)를 테스트하는 방법을 단계별로 상세하게 알려드릴게요.

가장 먼저 Flutter SDK를 다운로드하고 환경 변수를 설정해야 합니다.

1. Flutter SDK 설정

1) 폴더 준비: C 드라이브에 src 폴더를 만드세요. (예: C:\src)

2) Flutter SDK 다운로드: Flutter 공식 웹사이트(https://flutter.dev/)에서 최신 버전의 Flutter SDK를 다운로드합니다.

3) 다운로드한 SDK 압축 파일의 압축을 해제하고 flutter 폴더를 C:\src로 옮깁니다. 이제 C:\src\flutter 구조가 되었는지 확인하세요.

4) 이제 환경변수 PATH에 등록을 하겠습니다.

아래를 참고하여 경로를 추가합니다.
Windows 검색 → “시스템 환경 변수 편집” → “환경 변수(N)…”
(사용자 변수 또는 시스템 변수) Path 편집 → 새로 만들기 → C:\src\flutter\bin 추가 → 확인

5) 설치 확인: 새로운 터미널(PowerShell 또는 명령 프롬프트)을 열고 아래 명령어를 입력하여 Flutter가 제대로 설치되었는지 확인합니다.

flutter --version

6) 개발 환경 진단: 아래 명령어로 Flutter 개발 환경이 제대로 설정되었는지 확인하세요.

flutter doctor -v

*Android toolchain 경고가 나타나는 건 정상입니다. 아직 Android Studio와 SDK를 설치하지 않았기 때문입니다. 이 부분은 다음 단계에서 해결할 거예요.

2. VS Code에서 Flutter 및 Dart 확장 설치

VS Code를 열고 왼쪽 사이드바의 '확장(Extensions)' 아이콘을 클릭합니다.

검색창에 'flutter'를 입력하고 Flutter 확장을 선택한 후 'Install' 버튼을 누르세요.

Flutter 확장을 설치하면 Dart 확장도 자동으로 설치됩니다.

Flutter 앱을 실행하고 테스트하려면 Android Studio와 AVD 설정이 필수입니다.

1. Android Studio 설치

1) 설치: Android Studio 공식 웹사이트(https://developer.android.com/studio?hl=ko)에서 최신 버전을 다운로드하여 설치합니다.

2) 구성 요소 선택: 설치 과정에서 Android Virtual Device를 포함한 모든 권장 구성 요소를 선택하세요.

2. Android SDK 및 플랫폼 툴 설치

Android Studio를 실행하고 SDK Manager로 이동하세요.

Android SDK, Android SDK Platform-Tools, Android SDK Build-Tools를 설치합니다.
Android SDK Command-line Tools도 추가로 설치해야 합니다.

3. AVD 생성 및 실행

1) AVD 생성: Android Studio에서 Device Manager 또는 AVD Manager를 열고 'Create Device' 버튼을 클릭해 새 가상 기기를 만듭니다.

2) AVD 실행: Device Manager 목록에서 새로 생성된 디바이스를 확인(flutter emulator)하고, 오른쪽에 있는 시작 아이콘을 클릭해 AVD가 잘 실행되는지 확인합니다.

3) Android 라이선스 설정: 이제 윈도우에서 터미널을 열고 다음 명령어를 실행하여 Android 라이선스를 설정합니다.

flutter doctor --android-licenses

명령어를 실행하고 모두 y 를 입력합니다.

Visual Studio 를 제외한 모든 항목이 녹색으로 나와야 정상입니다.

4. VS Code에서 AVD 확인

모든 설정이 완료되었다면 AVD를 실행한 후 VS Code 터미널에서 아래 명령어를 실행하여 AVD가 제대로 인식되는지 확인합니다.

flutter devices

안드로이드 디바이스가 목록에 보이면 성공입니다.

sdk gphone64 x86 64 (mobile) • emulator-5554 • android-x64 • Android 16 (API 36) (emulator)

이제 VS Code에서 Flutter 개발을 시작하고, AVD로 앱을 테스트할 수 있는 완벽한 환경이 갖춰졌습니다.

고생하셨습니다!

이제 본격적으로 Flutter 개발을 시작해 보세요. Gemini CLI도 개발 과정에서 유용하게 활용할 수 있을 거예요.