윈도우에서 설치

시스템 요구 사항

Flutter를 설치하고 실행하기 위해서는 개발 환경이 다음과 같은 최소 요구 사항을 충족해야 합니다:

  • 운영 체제: 윈도우7 SP1 이상 (64-bit)
  • 저장 공간: 400 MB (IDE나 개발 도구 용량은 별도).
  • 도구: Flutter는 윈도우 환경에서 아래 도구가 필요합니다.
    • 윈도우 파워셸 5.0 또는 그 이상 버전 (윈도우10에 내장되어 있음)
    • Git for Windows 2.x, 설치하실 때, Use Git from the Windows Command Prompt 옵션을 설정해주세요.

      윈도우용 Git이 이미 설치되어 있다면, git 명령을 명령 프롬프트나 파워셸에서 실행되는지 확인하세요.

Flutter SDK 다운로드

  1. 다음 설치 번들을 다운로드하여 Flutter SDK의 최신 stable 릴리즈를 받으세요:

    (loading…)

    다른 릴리즈 채널이나 이전 빌드를 받으려면 SDK 아카이브 페이지를 확인하세요.

  2. zip 파일의 압축을 풀고 flutter를 원하는 설치 위치에 놓으세요. (예시. C:\src\flutter) (C:\Program Files\와 같은 권한이 필요한 위치에 설치하지 마세요.)

이제 Flutter 콘솔에서 Flutter 명령을 실행할 수 있습니다.

Path 추가

일반 윈도우 콘솔에서 Flutter 명령을 실행하고 싶다면, 아래 단계를 수행해여 Path 환경 변수에 Flutter를 추가하세요.

  • From the Start search bar, enter ‘env’ and select Edit environment variables for your account.
  • Under User variables check if there is an entry called Path:
    • If the entry exists, append the full path to flutter\bin using ; as a separator from existing values.
    • If the entry doesn’t exist, create a new user variable named Path with the full path to flutter\bin as its value.

이러한 변경 내용을 적용하려면 기존 콘솔 창을 닫았다가 다시 열어야 합니다.

Flutter doctor 실행

콘솔에서 Flutter 디렉토리(상단에서 확인)로 이동한 후 설정을 완료하는 데 필요한 플랫폼 의존성이 있는지 확인하기 위해 아래 명령을 실행하세요:

C:\src\flutter>flutter doctor

이 명령은 당신의 환경을 체크하고 Flutter 설치 상태에 대한 보고서를 보여줍니다. 출력된 내용을 꼼꼼히 보고 설치해야 할 다른 소프트웨어가 있는지 또는 수행해야 할 추가 작업이 있는지(굵은 글씨로 표시됨) 확인하세요.

예시:

[-] Android toolchain - develop for Android devices
    • Android SDK at D:\Android\sdk
    ✗ Android SDK is missing command line tools; download from https://goo.gl/XxQghQ
    • Try re-installing or updating your Android SDK,
      visit https://flutter-kr.io/setup/#android-setup for detailed instructions.

다음 섹션에서는 이러한 작업을 수행하고 설치 과정을 완수하는 방법을 설명합니다. 누락된 디펜던시를 설치한 후에, flutter doctor 명령을 다시 실행하여 모든 설정이 올바른지 확인할 수 있습니다.

Android 설정

Android 스튜디오 설치

  1. Android 스튜디오 다운드로 및 설치.
  2. Android 스튜디오를 시작하고 ‘Android 스튜디오 설치 마법사’를 실행합니다. 설치 마법사는 Flutter로 Android를 개발할 때 필요한 최신 Android SDK, Android SDK 플랫폼 도구, Android SDK 빌드 도구를 설치합니다.

Android 기기 설정

Android 기기에서 Flutter 앱을 실행하고 테스트하기 위해서, Android 4.1 (API 16) 이상에서 동작하는 Android 기기가 필요합니다.

  1. 기기에서 개발자 옵션USB 디버깅을 활성화 해야합니다. 자세한 사항은 Android 문서에서 확인하실 수 있습니다.
  2. 윈도우인 경우: 구글 USB 드라이버를 설치하세요.
  3. USB케이블을 이용하여 기기를 컴퓨터에 연결하세요. 장치에 관한 메시지가 나타나면, 컴퓨터가 장치에 접근할 수 있도록 권한을 부여하세요.
  4. Flutter에 안드로이기 기기가 연결됐는지 확인하기 위해 터미널에서 flutter devices 명령을 실행하세요. 기본적으로, Flutter는 adb 도구에 연결된 버전의 Android SDK를 사용합니다. 다른 곳에 설치된 Android SDK를 사용하고 싶다면, ANDROID_HOME 환경 변수를 해당 디렉토리로 변경해야 합니다.

Android 에뮬레이터 설정

Android 에뮬레이터에서 Flutter 앱을 실행하고 테스트하기 위해, 아래 단계를 수행하세요:

  1. 기기에서 VM 가속화를 활성화하세요.
  2. Android Studio > Tools > Android > AVD Manager를 실행하고 Create Virtual Device를 선택하세요. (Android 하위 메뉴는 Android 프로젝트 내부에 있을 때만 나타납니다.)
  3. 기기 해상도를 선택하고 Next를 누르세요.
  4. 가상화하려는 Android 버전에 맞게 1개 이상의 시스템 이미지를 선택하고 Next를 누르세요. x86 또는 x86_64 를 권장합니다.
  5. 에뮬레이터 성능에서, 하드웨어 가속화를 위해 Hardware - GLES 2.0를 선택하세요.
  6. AVD 구성이 올바른지 확인하고 Finish를 선택하세요.

    위 단계에 대한 자세한 내용은 AVD 관리를 참고하세요.

  7. Android 가상 기기 관리자에 있는 툴바에서 Run을 클릭하세요. 에뮬레이터가 시작되고 선택한 OS 버전과 기기의 기본 캔버스가 표시됩니다.

Web setup

To prepare to run and test your Flutter app on the web, you must install Chrome, if you haven’t already.

다음 단계

적합한 에디터를 설정하세요.