봄
다시봄
초보자 완전 설치 가이드

처음이세요? 걱정 마세요! 🙌
처음부터 차근차근 알려드릴게요

터미널이 뭔지 몰라도 괜찮아요. 뭘 설치해야 하는지, 어디서 실행하는지 모두 알려드립니다. 각 단계를 완료하면 체크 버튼을 눌러 진행 상황을 확인하세요.

내 컴퓨터 운영체제를 선택하세요

터미널이 뭔가요?

터미널은 컴퓨터에게 글자로 명령을 내리는 프로그램입니다. 마우스 클릭 대신 키보드로 명령어를 입력해서 프로그램을 설치하거나 실행할 수 있어요. 개발자들이 가장 많이 사용하는 도구입니다.

Mac에서 여는 법
  1. ① Spotlight 열기: ⌘ + Space
  2. ② "터미널" 입력 후 Enter
  3. ③ 검은 창이 뜨면 성공!
Windows에서 여는 법
  1. ① 시작 버튼 옆 검색창 클릭
  2. ② "PowerShell" 입력 후 Enter
  3. ③ 파란 창이 뜨면 성공!

📦 설치해야 할 것들 (총 5가지)

1
Flutter SDK
앱 개발 도구
2
Node.js
Firebase CLI용
3
Firebase CLI
Firebase 연결
4
FlutterFire CLI
자동 설정 도구
5
VS Code
코드 편집기
Flutter 공식 사이트에서 다운로드
https://flutter.dev/docs/get-started/install →
  1. 1
    위 링크 접속 → macOS 선택
    Apple Silicon(M1/M2/M3)이면 'Apple Silicon' 버튼, 인텔 맥이면 'Intel' 버튼 클릭
  2. 2
    zip 파일 다운로드 후 압축 해제
    다운로드된 flutter_macos_xxx.zip 파일을 더블클릭하면 flutter 폴더가 생깁니다
  3. 3
    flutter 폴더를 홈 폴더로 이동
    Finder에서 flutter 폴더를 사용자 홈 폴더(집 모양 아이콘)로 드래그
  4. 4
    터미널 열고 PATH 등록
    아래 명령어를 터미널에 붙여넣고 Enter
터미널에 아래 명령어를 그대로 복사해서 붙여넣고 Enter를 누르세요
echo 'export PATH="$PATH:$HOME/flutter/bin"' >> ~/.zshrc && source ~/.zshrc
설치 확인 — 터미널에서 아래 명령어 실행
이 명령어를 실행했을 때 버전 정보가 나오면 성공!
flutter --version
flutter doctor 명령어를 실행하면 추가로 설치가 필요한 항목을 자동으로 알려줍니다.
flutter doctor
🎉
모든 설치 완료!

5가지를 모두 설치했다면 이제 다시봄 앱을 실행할 준비가 됐습니다.
아래 명령어로 앱을 실행해 보세요!

① 프로젝트 폴더로 이동
cd dacibom
② 패키지 설치
flutter pub get
③ 앱 실행!
flutter run

❓ 자주 묻는 질문

Q. 명령어를 입력했는데 '명령을 찾을 수 없습니다' 라고 나와요
A. 터미널을 완전히 닫고 다시 열어보세요. 그래도 안 되면 PATH 등록이 안 된 것입니다. STEP 1 또는 STEP 4의 PATH 등록 과정을 다시 진행하세요.
Q. flutter doctor를 실행했는데 빨간 X 표시가 나와요
A. X 표시 옆에 나오는 안내 메시지를 따라 추가 설치를 진행하세요. Android Studio 설치가 필요한 경우가 많습니다.
Q. flutterfire configure를 실행했는데 프로젝트가 안 보여요
A. firebase login이 제대로 됐는지 확인하세요. 로그인한 Google 계정과 Firebase 프로젝트를 만든 계정이 같아야 합니다.
Q. 어느 폴더에서 명령어를 실행해야 하나요?
A. flutterfire configure, flutter pub get, flutter run 명령어는 반드시 dacibom 폴더 안(pubspec.yaml이 있는 곳)에서 실행해야 합니다.