Flutter 시작 가이드: 설치 및 환경 설정

1. Flutter란?

Flutter는 Google에서 개발한 오픈 소스 UI 툴킷으로, 하나의 코드베이스로 iOS, Android, 웹, 데스크탑 애플리케이션을 만들 수 있습니다. 직관적인 위젯 시스템과 빠른 개발 환경을 제공하여 초보자부터 전문가까지 모두에게 사랑받고 있습니다.

---

2. Flutter 설치 준비

2.1 요구 사항

• 운영 체제: Windows, macOS, Linux
• 디스크 공간: 최소 2.8GB 이상의 여유 공간 (추가 도구 포함)
• 필수 도구:
  • Git (설치 필요)
  • Android Studio 또는 Visual Studio Code

2.2 설치할 소프트웨어

• Flutter SDK
• IDE (Android Studio 또는 Visual Studio Code)
• Android Emulator 또는 디바이스 연결

---

3. 설치 단계

3.1 Flutter SDK 다운로드 및 설치

1. Flutter 공식 웹사이트(flutter.dev)에 접속하여 운영 체제에 맞는 Flutter SDK를 다운로드합니다.
2. 다운로드한 파일을 원하는 디렉토리에 압축 해제합니다.
   • 예: C:\src\flutter 또는 /Users/yourname/flutter
3. Flutter 디렉토리를 환경 변수에 추가합니다.
   • Windows: 시스템 환경 변수에서 Path에 Flutter 경로 추가.
   • macOS/Linux: .bashrc 또는 .zshrc 파일에 다음 라인 추가:
   • export PATH="$PATH:/path-to-flutter/bin"
4. 명령어를 통해 Flutter가 설치되었는지 확인합니다:
5. flutter doctor

3.2 IDE 설정

Android Studio 설정

1. Android Studio를 다운로드 및 설치합니다.
2. 설치 후, Plugins 탭에서 Flutter 플러그인을 검색 및 설치합니다. 설치 시 Dart 플러그인도 함께 설치됩니다.
3. Android SDK를 설치하고 환경을 설정합니다.

Visual Studio Code 설정

1. VS Code를 다운로드 및 설치합니다.
2. Extensions 메뉴에서 Flutter 및 Dart 확장을 설치합니다.

3.3 Android 디바이스 설정

1. Android Emulator를 사용하려면 Android Studio에서 AVD(Android Virtual Device)를 설정합니다.
2. 실제 기기를 사용하려면 USB 디버깅을 활성화하고 기기를 PC와 연결합니다.

---

4. Flutter 프로젝트 생성

4.1 프로젝트 생성

터미널에서 다음 명령어를 입력하여 새 프로젝트를 생성합니다:

flutter create my_app

my_app은 프로젝트 이름입니다. 원하는 이름으로 변경 가능합니다.

4.2 프로젝트 실행

프로젝트 디렉토리로 이동 후, 다음 명령어를 입력합니다:

cd my_app
flutter run

에뮬레이터 또는 연결된 기기에서 앱이 실행됩니다.

---

5. 문제 해결

5.1 Flutter Doctor 사용

flutter doctor 명령어는 설치 상태를 점검하고 누락된 부분을 안내합니다. 문제를 해결하려면 안내 메시지를 따라 설정을 완료하세요.

5.2 자주 발생하는 문제

1. 환경 변수 설정 누락:
   • 문제: flutter 명령어가 실행되지 않음.
   • 해결 방법: 환경 변수에서 Flutter 경로가 제대로 설정되었는지 확인하세요.
   • 예시:환경 변수에 Flutter 경로를 추가한 뒤 터미널을 다시 실행합니다.
     

'flutter' is not recognized as an internal or external command

'flutter' is not recognized as an internal or external command

1. Android SDK 누락:
   • 문제: flutter doctor에서 Android SDK가 설치되지 않았다고 표시됨.
   • 해결 방법: Android Studio의 SDK Manager를 열어 필요한 SDK 버전을 설치하세요.
   • 예시:Android Studio에서 'Preferences > Appearance & Behavior > System Settings > Android SDK' 경로를 확인 후 수정합니다.

 

1. 에뮬레이터 실행 실패:
   • 문제: AVD가 실행되지 않거나 에뮬레이터가 느리게 동작함.
   • 해결 방법: AVD Manager에서 설정을 확인하고, 가상 디바이스를 다시 생성하거나 실제 기기를 연결하세요.
   • 예시:BIOS 설정에서 하드웨어 가속(HAXM)을 활성화합니다.

emulator: ERROR: x86 emulation currently requires hardware acceleration!

1. Dart 플러그인 누락:
   • 문제: IDE에서 Flutter 프로젝트를 실행할 때 Dart 관련 오류 발생.
   • 해결 방법: IDE에서 Dart 플러그인을 설치하거나 활성화하세요.
   • 예시:Flutter/Dart 플러그인이 제대로 설치되었는지 확인합니다.
   • Error: Dart SDK is not configured

'flutter' is not recognized as an internal or external command

'flutter' is not recognized as an internal or external command

---

6. 결론

Flutter 설치 및 설정은 처음에는 다소 복잡할 수 있지만, 한 번 완료하면 생산성이 크게 향상됩니다. 이제 Flutter로 앱 개발을 시작해보세요!

---

참고 자료

• Flutter 공식 문서: https://docs.flutter.dev
• Git 설치 가이드: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git