2026년 5월 6일 수요일

Flutter 개발환경 세팅 방법 (초보도 10분 만에 앱 실행까지 완료)

 

Flutter 개발, 왜 시작했을까?

앱개발을 처음 시작하면 가장 먼저 막히는 게 바로 개발환경 세팅입니다.
저 역시 처음 Flutter를 설치하면서 수많은 오류를 겪었고, 생각보다 많은 시간을 소비했습니다.

이 글에서는 초보 기준으로 실제 막혔던 부분까지 포함해서 Flutter 개발환경 세팅 방법을 정리했습니다.

“그냥 따라하면 실행까지 되는” 걸 목표로 작성했습니다.


1. Flutter 설치

먼저 Flutter SDK를 설치해야 합니다.

  1. Flutter 공식 사이트 접속
  2. Windows 기준 SDK 다운로드
  3. 원하는 폴더에 압축 해제

⏩추천 경로 - C:\flutter

경로에 한글/공백이 있으면 오류 발생할 수 있습니다.

※저는 D드라이브가 용량이 넉넉해서 거기에 따로 개발용 폴더 만들어서 거기로 했다가 엄청 해맸었습니다. 그냥.. 세부 폴더없이 대표 드라이브에 설치를 권장합니다 😂


 2. 환경 변수 설정 (여기서 많이 막힘)

  1. 시스템 환경 변수 → Path 추가
  2. 경로 입력 - C:\flutter\bin

설정 후 반드시 확인: flutter doctor (명령프롬포트에서 하심됩니다.)

정상이라면 체크 표시가 뜹니다.


※※※※ 위 설명만으로도 하시는분들도 계시지만 제가 헷갈린 부분 풀어 적어놓습니다.

윈도우 화면 하단 검색창 -> 입력 : 시스템 환경변수 편집 -> 시스템 창 작은거 뜨면 <고급>탭

에서 하단 <환경변수> 클릭 -> 사용자변수 -> 새로만들기 -> 경로입력

※사용자 변수 또는 시스템 변수 어느곳에서도 인식된다고하나 간혹 둘 중 한군데서만 인식되는 경우가 발생, 사용자에서 해보고 안되면 사용자에 등록된 거 삭제 후 시스템에서 해보세요.


3. VS Code 설치 및 설정

  1. VS Code 설치
  2. 확장 프로그램 설치:
    • Flutter
    • Dart

설치 후 VS Code 재시작


4. Flutter 프로젝트 생성

터미널에서 실행:

flutter create my_app
cd my_app
flutter run

여기까지 되면 이미 앱 실행 성공!!!


🎲초보가 가장 많이 겪는 오류

1. flutter 명령어 안됨

환경 변수 설정 문제

2. 에뮬레이터 실행 안됨

Android Studio 또는 디바이스 연결 필요

3. 라이선스 오류

flutter doctor --android-licenses

🎯 결과: 진짜 중요한 포인트

  • 설치보다 환경 변수 설정이 핵심
  • 오류는 대부분 “경로 문제”
  • 한 번 성공하면 이후는 매우 쉬움

feat.주저리) 💬 

처음엔 단순 설치라고 생각했는데,

막상 해보니 초보 입장에서 꽤 큰 장벽이었습니다.

(설치 시작해서 제대로 된 실행까지 4시간...;;)

그래서 이 글을 최대한 삽질 줄이는 방향으로 정리했습니다.

중간 중간 설명이 필요한 부분이 있는데 그건 차후 글로 풀어 올리겠습니다.



🎯개념이 부족하다면

→ IT 용어 정리 먼저 보기



🎯다음 단계

→ Flutter 첫 앱 만들기

댓글 없음:

댓글 쓰기

[웹개발 기초] 웹·앱 개발할 때 나오는 용어들, 역할이랑 관계까지 한 번에 정리해봤습니다

 안녕하세요! 오늘은 웹이나 앱 개발을 공부하다 보면 쏟아지는 용어들 정리해보려고 합니다. 처음에 개발 공부 시작하면 진짜 이게 제일 힘들어요. 개념 하나 찾으면 모르는 단어가 또 나오고, 그거 찾으면 또 모르는 게 나오는 그 무한루프... 저도 ...