Windows에서 Flutter 개발환경 구축하기

✅ Windows에서 Flutter 개발환경 구축하기

(2025.05)

Flutter로 Android 앱을 개발하려면 몇 가지 환경 설정이 필요합니다.
이 글에서는 Windows 환경을 기준으로 Flutter 개발 환경을 쉽고 빠르게 구축하는 방법을 단계별로 안내드립니다. 😊

---

🖥️ 1. 시스템 요구 사항 확인

먼저 PC가 Flutter를 실행할 수 있는 최소 요건을 만족하는지 확인해주세요.

• 운영 체제: Windows 10 이상 (64비트)
• 필수 도구:
  • Git for Windows 2.27 이상 → 다운로드 바로가기
  • Android Studio 2024.1.1 (Koala) 이상 → 다운로드 바로가기

---

🔧 2. 필수 개발 도구 설치

📌 Git 설치

1. 위 링크를 통해 설치 파일을 다운로드합니다.
2. 설치 중 설정은 기본값 그대로 진행해도 무방합니다. 

📌 Android Studio 설치

1. 공식 웹사이트에서 최신 버전을 설치합니다.
2. 모든 기본 구성 요소를 함께 설치해야 합니다 (예: SDK, Emulator 등).

안드로이드 앱 만들 안내 : https://docs.flutter.dev/get-started/install/windows/mobile

Windows에 Android 스튜디오 설치 : https://developer.android.com/studio?hl=ko

Flutter 번들을 직접 다운로드 : https://docs.flutter.dev/get-started/install/windows/mobile

Flutter는 Android Studio의 전체 버전이 필요하니, 설치 시 모든 기본 구성 요소를 포함하세요.

 

최신 버전으로 설치했습니다.

 

 

NEXT 계속 클릭

 

 

기다리기...

---

📦 3. Flutter SDK 설치 방법

Flutter SDK 설치는 두 가지 방식 중 하나를 선택할 수 있습니다.

🚀 방법 1: VS Code를 이용한 설치

• VS Code 설치
  • VS Code 다운로드 후 실행
  • "Flutter" 확장 프로그램도 함께 설치

    

• 명령 팔레트 열기
  Ctrl + Shift + P 입력 → "Flutter: New Project" 선택 

  

• Flutter SDK 설치 또는 경로 지정
  • 이미 있다면 Locate SDK
  • 없다면 Download SDK 

    

• 설치 경로 선택
  예: C:\dev (공백, 특수문자 ❌) 

  

플러터 SDK 다운로드 위치

1. Flutter SDK 폴더 선택 대화 상자가 표시 되면 Flutter를 설치할 위치를 선택합니다.%USERPROFILE%또는 C:\dev. 을 고려하세요 .

   다음 조건 중 하나 또는 둘 다를 충족하는 디렉토리나 경로에 Flutter를 설치하지 마세요.

   • 경로에 특수 문자나 공백이 포함되어 있습니다.
   • 해당 경로에는 높은 권한이 필요합니다.

   예를 들어, C:\Program Files두 조건 모두 충족되지 않습니다.

2. VS Code는 사용자 프로필에서 시작합니다. 다른 위치를 선택하세요.

5. 환경 변수(PATH) 설정
   "Add SDK to PATH"를 선택하여 자동 추가

 

 

6. 프로젝트 생성

 

---

🛠️ 방법 2: 수동 설치

1. Flutter SDK 다운로드
   • Flutter 공식 문서 바로가기
2. 압축 해제
   예: C:\dev\flutter 경로에 압축 해제
3. 환경 변수 추가
   • Windows 검색창에 "환경 변수 편집" 입력
   • Path에 C:\dev\flutter\bin 추가

---

📱 4. Android 개발 환경 설정

Android Studio에서 다음 설정을 완료해야 Android 앱을 정상 빌드할 수 있습니다.

🧰 Android Toolchain 구성

1. Android Studio 실행
2. Projects > SDK Manager 클릭 

   

3. 아래 항목들이 설치되어 있는지 확인 (없으면 체크 후 설치)
   • Android SDK Platform (API 35.0.2)

     

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

     

     Apply -> OK

Finish- > OK

📲 에뮬레이터 설정

1. Projects > Device Manager로 이동

   

2. "Create Device" 클릭 → 예: Pixel 6 선택

   

   

   next 클릭

3. Android 14 (x86 이미지) 다운로드

   

   

   시스템 이미지에서 필요한 항목의 다운로드 모양 클릭

   

   다운로드 아이콘이 사라져 있습니다.

   

4. "Graphics"를 Hardware - GLES 2.0으로 설정

   

   Finish 클릭
   
   

1. AVD 생성 후 실행하여 동작 확인

   

   ▷ 클릭해서 실행하기
   
   

정상 실행 확인.

 

 

---

📄 5. Android 라이선스 동의

1. 관리자 권한으로 CMD 또는 PowerShell 실행
2. 다음 명령어 입력: flutter doctor --android-licenses

   

3. 각 항목마다 y 입력하여 동의

---

🔍 6. 개발 환경 확인

1. PowerShell 실행
2. 진단 명령어 실행: flutter doctor

   

3. 문제 항목이 있다면 안내에 따라 해결
   더 자세한 정보는 flutter doctor -v 명령어 사용

✅ 예시 출력

[✓] Flutter (Channel stable, ...)
[✓] Windows Version (...)
[✓] Android toolchain - develop for Android devices (...)
[✓] Android Studio (...)
[✓] VS Code (...)

 

진단 완료

---

🚀 7. Flutter 앱 개발 시작!

이제 개발 준비 완료입니다! 🎉

• VS Code나 Android Studio에서 "Flutter: New Project"를 실행하여 첫 앱을 만들어보세요.
• 웹 또는 Windows 데스크톱 앱을 함께 개발하고 싶다면 Flutter 공식 문서에서 추가 설정을 확인할 수 있습니다.

---

✨ 마무리

여기까지 따라오셨다면, Flutter 개발 환경이 정상적으로 구축된 상태입니다.
문제가 생기면 언제든지 flutter doctor 명령어로 원인을 진단해보세요.