Chocolatey를 이용한 Flutter 설치 방법

윈도우 환경에서 Chocolatey를 이용해서 Flutter를 설치하고 안드로이드 기기와 연결하는 방법에 대해 알아보겠습니다.

Chocolatey 설치

이전 글 Chocolatey 설치를 참고해서 Chocolatey를 먼저 설치를 합니다.

Flutter 설치

관리자 권한으로 PowerShell을 열고 다음 명령어를 실행하여 설치를 합니다.

choco install flutter

설치가 완료되면 flutter 명령어를 실행하였을 때 다음과 같이 메시지가 나옵니다.

C:\Windows\system32> flutter
Common commands:

  flutter create <output directory>
    Create a new Flutter project in the specified directory.

  flutter run [options]
    Run your Flutter application on an attached device or in an emulator.

...

Run "flutter help <command>" for more information about a command.
Run "flutter help -v" for verbose help output, including less commonly used options.

안드로이드 연결

안드로이드 앱을 개발하려고 한다면 Android setup 사이트에 접속해서 가이드대로 Android 에뮬레이터를 설치하고 연결하면 됩니다.

설치 방법은 아래 기술하였습니다.

Android Studio 설치

https://developer.android.com/studio 사이트에 접속해서 Android Studio를 다운로드합니다. 다운로드가 완료되면 설치를 진행합니다.

Android SDK 빌드 도구 설치

Android Studio 를 시작하고 'Android Studio Setup Wizard'를 진행합니다. 이렇게 하면 Android 용으로 개발할 때 Flutter에 필요한 최신 Android SDK, Android SDK Command-line Tools 및 Android SDK Build-Tools가 설치됩니다.

PowerShell 에서 flutter doctor 명령어를 실행해서 Flutter 가 설치된 Android Studio를 찾았는지 확인합니다.

C:\WINDOWS\system32> flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel master, 3.10.0-4.0.pre, on Microsoft Windows [Version 10.0.22621.1555], locale ko-KR)
[√] Windows Version (Installed version of Windows is version 10 or higher)
[!] Android toolchain - develop for Android devices (Android SDK version 33.0.2)
    X cmdline-tools component is missing
      Run `path/to/sdkmanager --install "cmdline-tools;latest"`
      See https://developer.android.com/studio/command-line for more details.
    X Android license status unknown.
      Run `flutter doctor --android-licenses` to accept the SDK licenses.
      See https://flutter.dev/docs/get-started/install/windows#android-setup for more details.
[√] Chrome - develop for the web
[√] Visual Studio - develop for Windows (Visual Studio Professional 2019 16.11.25)
[√] Android Studio (version 2022.2)
[√] VS Code (version 1.77.1)
[√] Connected device (3 available)
[√] Network resources

Android 에뮬레이터 설정

Android 에뮬레이터에서 Flutter 앱을 실행하고 테스트할 준비를 하려면 다음 단계를 진행합니다.

1. Machine에서 VM acceleration 를 활성화합니다.
2. Android Studio를 실행하고 Tools > Device Manager 메뉴를 클릭하거나 Device Manager 아이콘을 클릭한 다음 Virtual 탭 에서 Create Device를 선택합니다.
   • 이전 버전의 Android Studio에서는 대신 Android Studio > Tools > Android > AVD Manager를 실행하고 Create Virtual Device를 선택해야 합니다. (Android 하위 메뉴는 Android 프로젝트 내부에만 있습니다.)
   • 열려 있는 프로젝트가 없으면 점 3개 Menu / More Actions > Virtual Device Manager 메뉴를 클릭한 다음 Create Device를 선택할 수 있습니다.
3. Visual Device Configuration 창에서 장치를 선택하고 Next 버튼을 클릭합니다. (저는 Pixel 3 XL 모델을 선택했습니다.)
4. 에뮬레이션 하려는 Android 버전의 시스템 이미지를 하나 이상 선택하고 Next 버튼을 클릭합니다. x86 또는 x86_64 이미지를 권장합니다.
5. Verify Configuration에서 하단에 Emulated Performance에서 Graphics를 Hardware-GLES 2.0 으로 선택 후 Finish 버튼을 클릭하여 하드웨어 가속을 활성화합니다.
6. Android Virtual Device Manager의 도구 모음에서 실행(▶)을 클릭합니다. 에뮬레이터가 시작되고 선택한 OS 버전 및 장치에 대한 기본 캔버스를 표시합니다.

Android 라이선스에 동의

Flutter 를 사용하려면 먼저 Android SDK 플랫폼의 라이선스에 동의해야 합니다. 이 단계는 위에 나열된 도구를 설치한 후에 수행해야 합니다.

• 자바 8 버전 이상이 설치되어 있고 JDK의 폴더가 환경 변수 설정되어 있는지 확인합니다.

PowerShell 또는 명령 프롬프트에서 다 명령어를 실행하여 라이언스 서명을 시작합니다.

flutter doctor --android-licenses

에러 발생 해결 방법

C:\WINDOWS\system32> flutter doctor --android-licenses
Android sdkmanager not found. Update to the latest Android SDK and ensure that the cmdline-tools are installed to
resolve this.

만약 cmdline-tools 가 없으므로 설치하라는 빨간 메시지가 출력된다면 아래의 절차를 진행합니다.

1. Android Studio 에서 SDK Manager를 실행합니다.
2. 좌측의 System Settings에서 Android SDK를 선택하고 우측 화면에서 SDK Tools 탭을 선택합니다.
3. Android SDK Command-line Tools(latest)를 체크한 후 OK 버튼을 클릭해 설치를 진행합니다.
4. 설치가 완료되었다면 Finish를 클릭하고 flutter doctor --android-licenses 명령어를 다시 실행합니다. 이때 동의에 대해 묻는데 y 입력해 주시면 됩니다.
5. All SDK package licenses accepted 메시지가 출력 되면 라이선스 동의가 끝났습니다.

C:\WINDOWS\system32> flutter doctor --android-licenses
...
Accept? (y/N): y
All SDK package licenses accepted

확인

라이선스 동의가 완료되면 flutter doctor 명령어를 다시 실하여 Flutter 를 사용할 준비가 되었는지 확인합니다.

C:\WINDOWS\system32> flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel master, 3.10.0-4.0.pre, on Microsoft Windows [Version 10.0.22621.1555], locale ko-KR)
[√] Windows Version (Installed version of Windows is version 10 or higher)
[√] Android toolchain - develop for Android devices (Android SDK version 33.0.2)
[√] Chrome - develop for the web
[√] Visual Studio - develop for Windows (Visual Studio Professional 2019 16.11.25)
[√] Android Studio (version 2022.2)
[√] VS Code (version 1.77.1)
[√] Connected device (4 available)
[√] Network resources

에러 발생 해결 방법

flutter doctor 명령어를 실하였을 때 Windows 10 SDK 이 없다고 하는 메시지가 출력될 경우 해결 방법입니다.

1. https://visualstudio.microsoft.com/ko/downloads/ 사이트에서 Visual Studio 2022 버전의 무료 다운로드를 클릭하여 다운로드하고 설치해줍니다.
2. Visual Studio Installer 창이 열리면 데스크톱 및 모바일에서 C++를 이용한 데스크톱 개발을 선택 후 설치합니다.

결론

Chocolatey를 사용해서 Flutter를 설치하면 zip 파일을 다운로드하고, 열어서 설치하고, path 설정하고, 여러 가지 설정하는 것보다 훨씬 쉬운 방법입니다.