이 글은 윈도우를 사용하는 컴퓨터에 플러터를 설치하는 방법에 대해 정리하였다.
현재 필자가 글을 작성하고 있는 시점은 2024년 05월 28일이다. 이후 플러터가 업데이트 됨에 따라 글과 달라질 수 있다는 점을 참고하자.
먼저 현재 필자의 윈도우 버전은 다음과 같다.
Edition | Windows 11 Pro
Version | 23H2
OS Build | 22631.3593
필자의 하드웨어 사양은 다음과 같다.
CPU | AMD Ryzen 7 3700X 8-Core Processor 3.59 GHz
RAM | 32.0GB
본격적으로 설치를 진행해보자.
플러터 SDK 설치
먼저 플러터 SDK를 설치해야 한다. 다른 방법도 있지만, 플러터 홈페이지에서 안내하는 방법을 기준으로 설명할 것이다.
플러터 SDK 시스템 요구사항
플러터에서 요구하는 하드웨어 및 OS버전, 소프트웨어는 다음과 같다.
안드로이드 스튜디오는 뒤에서 같이 설치하도록 하고, Git이 없다면 아래 링크를 통해 이동해서 Git 설치를 먼저 하자.
https://git-scm.com/download/win
Git - Downloading Package
Download for Windows Click here to download the latest (2.45.1) 32-bit version of Git for Windows. This is the most recent maintained build. It was released 13 days ago, on 2024-05-14. Other Git for Windows downloads Standalone Installer 32-bit Git for Win
git-scm.com
플러터 SDK 다운로드
플러터 SDK는 아래 링크에서 받을 수 있다.
https://docs.flutter.dev/get-started/install/windows/mobile?tab=download
Start building Flutter Android apps on Windows
Configure your system to develop Flutter mobile apps on Windows.
docs.flutter.dev
flutter_windows_3.22.1-stable.zip
버튼을 눌러서 플러터 SDK를 다운받으면 된다. 대략 1GB 정도의 용량의 파일이다. 최신 버전은 설치를 진행하는 시점에 따라 달라질 수 있으므로 별도의 파일은 블로그에서 제공하지 않는다. 사이트로 이동해서 최신 버전을 다운받아주면 된다.
혹시나 다른 버전의 파일이 필요하다면, 아래 링크에서 필요한 버전의 플러터 SDK를 다운받을 수 있다.
https://docs.flutter.dev/release/archive?tab=windows
Flutter SDK archive
All current Flutter SDK releases: stable, beta, and master.
docs.flutter.dev
플러터 SDK 압축파일 다운이 완료되었으면, 적당한 위치에 압축해제를 진행하면 된다. 단! 주의할 점은 위치 경로에 한글이 포함되지 않아야 하며, C:\Program Files
와 같이 경로에 띄어쓰기가 포함되면 안된다.
적당히 C 드라이브 바로 아래나 한글 이름이 포함되지 않았다면 C:\Users\{username}
경로에 압축을 해제하자. 필자는 C:\Users\Luna\flutter
경로로 지정하였다.
환경변수 설정
압축해제가 완료되면 시스템 환경 변수를 설정해야 한다. 시스템 환경 변수 편집으로 들어가서 환경 변수, 사용자 변수의 Path로 이동하여 경로를 추가하면 된다.
환경 변수 편집으로 이동했다면, 앞에서 압축 해제한 플러터 SDK 폴더 내에 bin 폴더 경로를 추가하면 된다. 필자의 경우 C:\Users\Luna\flutter\bin
경로를 추가하였다.
추가 후 모두 저장하면 된다.
플러터 SDK 설치 확인
정상적으로 플러터 SDK가 설치되었는지 확인하기 위해서는 flutter doctor
명령어를 이용하면 된다. PowerShell을 열고 flutter doctor
명령어를 입력하여 정상적으로 설치되었는지, 다른 이슈는 없는지 확인한다.
flutter doctor
(명령어가 실행되지 않는다면, 앞선 설치 과정에서 문제가 있는 것이다. 컴퓨터를 다시 시작한 후 재시도 해보거나 앞선 과정을 다시 한 번 천천히 진행해보면 된다.)
잠시 시간이 지나고 검사가 완료되면 아래와 같은 검사 결과를 확인할 수 있다.
Android toolchain 이슈와 Visual Studio 이슈, Android Studio 이슈가 있는 것을 확인할 수 있다.
Android toolchain 이슈는 Android SDK가 없기 때문에 발생하는 문제이므로 Android Studio 설치를 진행하면 자연스럽게 해결될 것이며, Visual Studio 관련 이슈는 윈도우용 프로그램을 개발할 때 필요한 것이기 때문에 이번 글에서는 다루지 않을 예정이다. 혹시나 필요하다면 Visual Studio 프로그램을 설치하면 된다.
우선 플러터 SDK는 정상적으로 설치되었으니 플러터 SDK 설치는 여기서 마무리하고 안드로이드 스튜디오 설치로 넘어가자.
안드로이드 스튜디오 설치
예전엔 안드로이드 SDK만 설치해도 됐지만, 현재는 안드로이드 SDK를 설치하기 위해서는 안드로이드 스튜디오 설치를 진행해야 한다.
안드로이드 스튜디오 시스템 요구사항
안드로이드 스튜디오 시스템 요구사항은 다음과 같다.
안드로이드 스튜디오 설치
아래 링크로 이동해서 안드로이드 스튜디오 설치 파일을 받는다.
https://developer.android.com/studio?hl=ko#get-android-studio
Android 스튜디오 및 앱 도구 다운로드 - Android 개발자 | Android Studio | Android Developers
Android Studio provides app builders with an integrated development environment (IDE) optimized for Android apps. Download Android Studio today.
developer.android.com
Android 스튜디오 Jellyfish 다운로드 버튼을 눌러서 설치 파일을 받으면 된다. 현 시점에서 최신 버전은 2023.3.1 Jellyfish 버전이다. (설치 파일은 대략 1GB 정도의 용량을 가지고 있다.)
다운로드가 완료되었으면, 실행해서 설치를 진행한다. 특별한 것은 없으니 우선 Next
를 눌러 계속 진행하면 된다.
설치가 완료되면 Start Android Studio
에 체크하고 설치를 종료한다.
안드로이드 스튜디오 Setup
안드로이드 스튜디오 설치가 완료되면, 안드로이드 스튜디오가 실행된다. (자동으로 실행되지 않으면 앞선 과정에서 Start Android Studio
에 체크를 하지 않은 것이니 안드로이드 스튜디오를 수동으로 실행해주면 된다.)
이 과정에서는 안드로이드 스튜디오를 사용하기 위한 기본 Setup이 진행된다. 계속 Next
를 눌러 넘어가다가 아래와 같이 License Agreement 창이 뜨면 우측 하단에 Accept
로 바꾸고, 활성화되는 Finish
버튼을 누른다.
그럼 아래와 같이 필요한 파일의 설치가 진행된다.
설치가 완료되면 Finish
버튼을 눌러 마무리한다.
설치가 완료되었다면, PowerShell을 열고 flutter doctor
명령어를 실행하여 설치 현황을 살펴보자.
flutter doctor
Android Studio 이슈는 해결이 되었지만, Android toolchain 이슈는 아직 해결되지 않은 부분이 남아있다. 이제 이 부분을 해결해보도록 하자.
Android toolchain 이슈 해결
cmdline-tools component 이슈 해결
먼저 cmdline-tools component is missing
이슈를 해결해보자.
안드로이드 스튜디오를 실행하여 SDK Manager로 찾아 들어간다. ver.2023.3.1
(Jellyfish)에서는 More Actions를 누르면 찾을 수 있다. (버전에 따라 위치가 달라질 수 있다.)
SDK Manager로 들어오면, 아래와 같이 SDK Tools로 이동한 후, Android SDK Command-line Tools에 체크한다. (여기서 추가로 필요한 도구가 있으면 설치한다. 필자는 Android Emulator hypervisor driver와 Google USB Driver를 추가로 체크하여 설치했다.)
체크한 후, OK 버튼을 누르면 체크한 SDK Tools 설치가 진행된다. 설치가 완료될 때까지 기다린다.
설치가 완료된 후 다시 PowerShell에서 flutter doctor
명령어를 실행하여 확인하면 해당 문제는 해결된 것을 확인할 수 있다.
Android license status 이슈 해결
다음은 Android license status
이슈를 해결할 차례이다. 해결 방법은 간단하다.
PowerShell에서 아래 명령어를 실행한 후, y
를 입력해주면 된다.
flutter doctor --android-licenses
그리고 뜨는 모든 창에서 y
로 라이선스에 동의한다.
마지막까지 모두 동의하면, 아래와 같이 모든 라이선스에 동의했다고 뜨며 완료된다.
완료된 후, 다시 PowerShell에서 flutter doctor
명령어를 실행하면 모든 문제가 해결된 것을 확인할 수 있다. (Visual Studio는 윈도우 앱을 개발할 때 필요하기 때문에 이 글에서는 해결방법을 따로 다루지는 않는다. 해결하고 싶은 분들은 Visual Studio를 설치하면 해결할 수 있다.
이렇게 플러터 설치를 완료했다! 즐거운 플러터 개발이 되길 바란다. 끝!
'Development > Flutter' 카테고리의 다른 글
플러터 | Your project requires a newer version of the Kotlin Gradle plugin 문제 해결 (with. geolocator) (0) | 2024.06.11 |
---|---|
플러터 | 완성된 프로젝트 안드로이드 apk 파일로 빌드하기 (0) | 2024.06.11 |
플러터 | Please enable Developer Mode in your system settings (0) | 2024.06.06 |