[Flutter 트랙] 앱개발 종합반 1-4 - Window 환경설정

플러터(Flutter) 개발 환경 설정 – Windows & MacOS 설치 가이드

플러터로 앱 개발을 시작하기 위해서는 개발 환경을 올바르게 설정하는 과정이 필수적이다. 특히 Windows와 MacOS에서의 설정 방식이 다르므로, 본 포스팅에서는 윈도우 환경에서 플러터 개발 환경을 세팅하는 방법을 상세히 다룬다.

개발 환경을 올바르게 설정하지 않으면 SDK 오류, 경로 문제, 에뮬레이터 실행 오류 등 다양한 문제가 발생할 수 있으므로 주의가 필요하다.

---

1. Windows에서 플러터 개발 환경 세팅 – 단계별 가이드

플러터 개발 환경을 구축하려면 아래의 순서대로 진행하면 된다.

✅ Git 설치
✅ Flutter SDK 다운로드 및 환경 변수 설정
✅ Android Studio 설치 및 설정
✅ VS Code 설치 및 설정
✅ Flutter Doctor로 최종 점검
✅ Android Emulator 실행 및 프로젝트 테스트

---

📌 1) Git 설치

플러터를 설치하기 전에 먼저 Git을 설치해야 한다.

1. Git 공식 사이트에 접속
2. "Download for Windows" 버튼 클릭 후 다운로드
3. 실행 후 "Next" 버튼만 클릭하며 설치 진행
4. 설치가 완료되면 바탕화면에서 마우스 우클릭 → Git Bash 확인
5. "Git Bash" 또는 "Git GUI"가 보이면 정상 설치 완료

---

📌 2) Flutter SDK 다운로드 및 환경 변수 설정

Flutter SDK 다운로드

1. Flutter 공식 사이트 접속
2. Windows 버전 다운로드
3. 다운로드된 ZIP 파일 압축 해제 후 C:\SDK 폴더에 이동

⚠ 주의: SDK 설치 경로에 한글이 포함되지 않도록 해야 한다.
(예: C:\Users\홍길동\flutter ❌ → C:\SDK\flutter ⭕)

환경 변수 설정

1. C:\SDK\flutter\bin 경로 복사
2. 내 PC → 마우스 우클릭 → 속성 → 고급 시스템 설정 이동
3. 환경 변수 → 시스템 변수에서 "Path" 편집 → 새로 만들기
4. 복사한 경로(C:\SDK\flutter\bin)를 입력하고 저장

⚡ 확인 방법:
"Git Bash" 또는 "CMD(명령 프롬프트)" 실행 후 flutter --version 입력
→ 정상적으로 버전 정보가 나오면 설치 성공

---

📌 3) Android Studio 설치 및 SDK 설정

Android Studio 설치 방법

1. Android Studio 공식 사이트 접속
2. 다운로드 후 설치 진행
3. 실행 후 Next → Standard 선택 후 설치

Android SDK 경로 설정

1. Android SDK 설치 시 "경로에 한글이 포함되지 않도록" 설정
2. C:\SDK\Android 폴더를 새로 생성 후 경로 지정
3. 설치 완료 후 환경 변수에 SDK 경로 추가

---

📌 4) VS Code 설치 및 플러그인 설정

1. VS Code 공식 사이트에서 다운로드
2. 설치 후 실행 → "Extensions" (확장 기능) 메뉴 이동
3. Flutter & Dart 플러그인 설치

---

📌 5) Flutter Doctor로 최종 점검

설치한 모든 프로그램이 정상적으로 작동하는지 확인하기 위해 Flutter Doctor를 실행한다.

명령어 실행:

bash

CopyEdit

flutter doctor

→ 만약 오류가 발생하면 경고 메시지를 보고 수정해야 한다.

주요 오류 해결법:
✅ Android SDK 관련 오류 발생 시 → flutter config --android-sdk C:\SDK\Android 명령어 입력
✅ Flutter 라이센스 오류 시 → flutter doctor --android-licenses 입력 후 모든 질문에 Y 입력

---

2. 안드로이드 에뮬레이터 설정 및 실행

개발한 앱을 실행하기 위해서는 안드로이드 에뮬레이터가 필요하다.

📌 1) Android Emulator 설치

1. Android Studio 실행 → More Actions → AVD Manager(가상 디바이스 매니저) 이동
2. "Create Virtual Device" (새로운 가상 기기 생성) 클릭
3. Pixel 7 또는 원하는 모델 선택 후 "Next"
4. API 35 버전 선택 후 설치 진행
5. 생성된 가상 기기에서 "Play" 버튼 클릭하여 실행

---

📌 2) 에뮬레이터 오류 해결 – 사용자 이름 한글 문제

⚠ 문제:
Windows 사용자의 PC 계정명이 한글로 되어 있다면, AVD 실행 시 오류가 발생할 수 있다.

✅ 해결 방법:

1. C:\SDK\.android 폴더를 생성
2. 환경 변수에서 "ANDROID_HOME"과 "ANDROID_SDK_HOME"을 C:\SDK.android로 변경
3. PC 재부팅 후 AVD 실행

---

📌 3) 플러터 프로젝트 실행 테스트

1. VS Code 실행 → 플러터 프로젝트 생성
2. Android Emulator 실행 후 "Run" 버튼 클릭
3. 앱이 정상적으로 실행되는지 확인

🔥 설정이 완료되면 이제 본격적으로 플러터 앱 개발을 시작할 준비가 끝났다!

---

3. 결론 – 올바른 환경 세팅이 개발의 시작!

✔ SDK 설치 경로에 한글이 포함되지 않도록 주의해야 함
✔ Flutter, Android Studio, VS Code를 올바르게 설치하고 환경 변수 설정 필수
✔ 에뮬레이터 실행 오류 발생 시 환경 변수를 수정하고 재부팅하면 해결 가능

💡 플러터 개발을 시작하려면 환경 설정이 매우 중요하다.
설정이 잘못되면 개발 진행이 어려워질 수 있으므로, 위 가이드를 참고하여 완벽하게 세팅을 마친 후 앱 개발을 시작하자! 🚀