바닐라 코드/flutter

Flutter 설치 방법 (Windows 기준)

크리쯔 2024. 12. 18. 13:04

 

1. Flutter 공식 사이트에서 가이드 확인 및 설치

2. Git 설치

  • Git 다운로드 링크: https://git-scm.com/
  • 설치 시 기본 설정 사용.
  • 단, 아래 옵션만 수정:
    • Adjusting your PATH environment 항목에서:
      • Use Git and optional Unix tools from the Command Prompt 선택.

3. Flutter SDK 다운로드 및 PATH 설정

3.1 SDK 다운로드

  1. Flutter SDK 다운로드: https://flutter.dev
  2. 적절한 폴더에 압축 해제. (예: C:\src\flutter)

3.2 PATH 환경 변수 업데이트

  1. 환경 변수 편집:
    • Windows 검색창에 env 입력 → "계정의 환경 변수 편집" 실행.
  2. 사용자 변수에서 Path 선택 → "편집".
  3. "새로 만들기"를 클릭 후, Flutter bin 폴더 경로 추가:
    예: C:\src\flutter\bin.
  4. 설정 완료 후 "확인"을 클릭하여 저장.

4. Flutter Doctor로 설치 확인

  1. 명령 프롬프트(cmd) 또는 PowerShell 실행.
  2. flutter doctor 명령 실행: 
    flutter doctor
  3. flutter doctor 출력 결과를 확인하여 설치 상태를 점검.
    • 에러 발생 시 PATH 설정 또는 의존성 확인.
    • [X] 표시가 있는 경우, 해당 항목 아래 설명을 따라 해결.

5. Android Studio 설치

  1. 다운로드 링크: https://developer.android.com/studio
  2. 기본 설정으로 설치: 특별한 경우가 아니라면 기본 설치 폴더 사용.
  3. 필수 항목 포함:
    • Android Virtual Device 선택.
  4. 설치 완료 후 실행:
    • 처음 실행 시, 구성 마법사(Configuration Wizard) 실행.
    • "Do not import settings" 선택.
  5. 설정 세부사항:
    • Custom 옵션 선택.
    • 테마 설정 (권장: Dark).
    • 필수 SDK 구성 요소 선택:
      • Android SDK, Android SDK Platform, Performance, Android Virtual Device.
    • 저장 위치 선택 후 라이선스에 동의 → 설치 완료.

6. Android Studio 설정 추가

6.1 SDK Manager 설정

  1. Android Studio 실행 → "Welcome to Android Studio" 화면에서 More Actions 클릭.
  2. SDK Manager 선택.
  3. 필수 구성 요소 선택:
    • Android SDK Build-Tools.
    • Android SDK Command-line Tools.
    • Android Emulator.
    • Android Emulator Hypervisor Driver.
    • Android SDK Platform-Tools.
  4. 라이선스에 동의하고 설치 완료.

6.2 Android Emulator 설정

  1. Android Studio 실행 → 우측 상단 점 세 개 메뉴 → Virtual Device Manager 클릭.
  2. Create Device 클릭:
    • 사용하려는 기기를 선택 → "Next".
    • 설치할 Android 버전 선택 → "Next".
    • Emulated Performance에서 가능하면 Hardware 선택 → "Finish".
  3. 생성된 장치 리스트에서 "Play" 버튼을 클릭하여 가상 디바이스 실행 확인.

7. 설치 확인: Flutter Doctor 다시 실행

  1. 명령 프롬프트(cmd) 또는 PowerShell에서: 
    flutter doctor
  2. [✓] 표시가 나오면 모든 항목이 정상적으로 설치된 상태.

 

8. 가상장치 관리자 설정 (Android Virtual Device 설정)

Flutter 앱 개발 시 사용할 가상 휴대폰(에뮬레이터)을 설정하려면 다음 단계를 따릅니다.

  1. Android Studio 실행 → 우측 상단 점 세 개 메뉴 또는 More Actions 클릭.
  2. Virtual Device Manager 선택.
  3. Create Device 클릭:
    • 사용하려는 기기(예: Pixel 5 등)를 선택 → "Next".
  4. Android 버전 선택:
    • 원하는 Android 버전을 선택 후 다운로드 → "Next".
  5. Emulated Performance:
    • 가능한 경우 Hardware 옵션을 선택하여 성능을 최적화 → "Finish".
  6. 생성된 가상 장치 리스트에서 Play 버튼(화살표) 클릭:
    • 가상 장치가 정상적으로 실행되는지 확인.

참고: 가상 장치 실행 시 유의사항

1. Hypervisor Driver 설치 확인

  • 설치 방법:
    1. Android Studio 실행 → SDK Manager 열기.
    2. SDK Tools 탭 클릭.
    3. Android Emulator Hypervisor Driver for AMD Processors 또는 Intel x86 Emulator Accelerator (HAXM Installer) 체크 → "Apply" 클릭.
    4. 설치가 완료되면 가상 장치를 다시 실행.
  • 설치 후에도 작동하지 않을 경우:
    • Intel CPU 사용 시: HAXM이 설치되어야 합니다.
      • HAXM이 설치되지 않았다면, 명령 프롬프트에서 아래 명령 실행: 
      • cd {Android SDK 경로}\extras\intel\Hardware_Accelerated_Execution_Manager intelhaxm-setup.exe
    • AMD CPU 사용 시: Android Emulator Hypervisor Driver for AMD Processors 설치.

2. BIOS에서 가상화(VT-x/AMD-V) 활성화BIOS 설정 방법:

  1. PC를 재부팅 → BIOS 설정 화면 진입.
    • BIOS 진입 키는 제조사에 따라 다릅니다. 일반적으로 F2, F10, Del 키를 사용.
  2. Advanced Settings 또는 CPU Configuration 메뉴로 이동.
  3. Intel VT-x 또는 AMD-V 항목 활성화.
    • 해당 옵션이 Enabled로 설정되어야 함.
  4. 설정 저장 후 PC를 재부팅.

3. 하드웨어 가속 확인

  • 확인 및 설정 방법:
    1. Android Studio에서 가상 장치를 설정할 때, Emulated Performance에서 Hardware 선택.
    2. 가상 장치 설정에서 Graphics 옵션을 Hardware로 설정.

4. Flutter Doctor의 [X] 항목 해결예시:

[X] Android toolchain - develop for Android devices
    ✗ Unable to locate Android SDK.

해결 방법:

  1. 오류 메시지 아래 나오는 해결 지침을 따라 누락된 구성 요소를 설치합니다.
    • 예: Android SDK 경로를 설정하거나, Android Studio에서 필요한 SDK 도구를 추가 설치.
  2. PATH 환경 변수 확인:
    • Flutter 및 Android SDK 경로가 올바르게 설정되어 있는지 확인.

5. Virtual Device 실행 문제 해결

  • 문제 발생 시 점검 사항:
    1. Hypervisor Driver가 설치되어 있는지 확인.
    2. BIOS에서 가상화가 활성화되어 있는지 점검.
    3. Android Studio에서 Virtual Device 설정을 확인:
      • Android 버전이 호환되는지.
      • Emulated Performance가 Hardware로 설정되어 있는지.
  • 재설치 및 초기화:
    • 문제가 지속될 경우:
      1. Android Emulator를 제거하고 재설치.
      2. 가상 장치를 삭제 후 새로 생성.