2026-1 PD_Flutter

Flutter 개발 환경 구축 가이드

Windows 및 macOS 환경에서 Flutter 시작하기

1 Flutter SDK 다운로드 및 설치

Flutter 개발을 위해서는 먼저 공식 SDK를 다운로드하고 시스템 환경 변수에 등록해야 합니다.

  1. Flutter 공식 홈페이지에 접속하여 본인의 운영체제에 맞는 SDK 압축 파일을 다운로드합니다.
  2. 원하는 경로(예: C:\src\flutter 또는 ~/development/flutter)에 압축을 해제합니다.
  3. 운영체제의 환경 변수(Environment Variables) 설정에서 Path에 Flutter의 bin 폴더 경로를 추가합니다.
💡 주의: Windows 환경의 경우 권한 문제가 발생할 수 있으므로 C:\Program Files\ 폴더에는 설치하지 않는 것을 권장합니다.
💡 경로 복사 꿀팁: 환경 변수 설정 시 복잡한 경로를 직접 타이핑할 필요 없이 쉽게 복사합니다.
  • Windows: 폴더를 Shift + 우클릭하여 '경로로 복사(Copy as path)'를 선택하거나, 폴더 창 상단의 주소표시줄을 클릭해 복사(Ctrl+C)하면 됩니다.
  • Mac: 압축 해제한 Flutter 폴더를 터미널이나 텍스트 편집기 창에 드래그 앤 드롭하면 폴더 위치(경로)가 자동으로 텍스트로 입력됩니다.
2 Android Studio 설치 및 설정

Android 앱 빌드 및 에뮬레이터 사용을 위해 Android Studio 설치가 필수적입니다.

  1. Android Studio 공식 사이트에서 다운로드 및 설치를 진행합니다.
  2. 설치 완료 후 실행하여 초기 설정 마법사(Setup Wizard)를 완료합니다. 이때 최신 Android SDK, Android SDK Command-line Tools, Android SDK Build-Tools가 설치되도록 확인합니다.
💡 라이선스 동의: 터미널을 열고 아래 명령어를 입력하여 Android 라이선스에 모두 동의(`y` 입력)해야 합니다.
flutter doctor --android-licenses
3 VS Code 설치 및 확장 프로그램 설정

가볍고 강력한 편집기인 Visual Studio Code를 주력 IDE로 사용하는 것을 추천합니다.

  1. VS Code를 다운로드하고 설치합니다.
  2. VS Code 실행 후 좌측의 확장(Extensions) 아이콘을 클릭합니다.
  3. 검색창에 Flutter를 검색하고 공식 확장 프로그램을 설치합니다. (Dart 확장 프로그램도 자동으로 함께 설치됩니다.)
4 Flutter Doctor로 환경 점검

모든 설치가 끝났다면, Flutter 도구가 환경이 제대로 구축되었는지 점검해 줍니다. 터미널(또는 명령 프롬프트)을 열고 아래 명령어를 실행하세요.

flutter doctor

실행 결과에서 모든 항목에 녹색 체크 표시(✔️)가 뜨면 개발 준비가 완료된 것입니다. 만약 [!] 또는 [X] 표시가 있다면 해당 항목의 안내에 따라 추가 설정을 진행해 주세요.

5 첫 Flutter 프로젝트 생성하기

환경 설정이 완벽하게 끝났습니다! 이제 첫 프로젝트를 생성해 볼 차례입니다. 터미널에서 프로젝트를 생성할 폴더로 이동한 뒤 아래 명령어를 입력합니다.

flutter create my_first_app
cd my_first_app
flutter run

에뮬레이터나 연결된 기기에 기본 카운터 앱이 실행된다면 성공입니다! 🎉