[Flutter] 플러터 윈도우 VSCode 개발환경 설정하기 (Flutter SDK 설치, Flutter Doctor 이슈 해결 방법)

 

[목차]

1. VSCode 설치하기
2. VSCode에서 Flutter 설치하기
3. Flutter SDK 설치하기
4. Flutter SDK 시스템 환경 변수 설정
5. Android Studio Flutter 설치
6. Flutter Doctor 실행하기
7. Flutter Doctor 이슈 해결 방법
8. Flutter 설치 완료

 

---

📎 VSCode 설치하기

Visual Studio Code - Code Editing. Redefined

Visual Studio Code는 위 링크에서 다운로드할 수 있습니다.

---

📎 VSCode에서 Flutter 설치하기

• VS Code Extensions 버튼 클릭 후 Flutter 검색
• Install 클릭하여 설치

 

Flutter를 설치하면 Flutter 개발에 필요한 프로그래밍 언어인 Dart도 같이 설치됩니다.

---

📎 Flutter SDK 설치하기

Start building Flutter Android apps on Windows

위 링크에 접속하여 아래와 같이 SDK를 다운로드 합니다.

 

다운로드가 완료되면 C:\에 압축을 풉니다.

 

---

📎 Flutter SDK 시스템 환경 변수 설정

• 윈도우 키 > '시스템 환경 변수 편집' 검색 후 클릭

 

• 환경 변수 클릭

 

• 사용자 변수의 Path 클릭 > 편집 버튼 클릭

 

• 찾아보기 버튼 클릭

 

• 압축 푼 폴더 경로를 찾아서 flutter 폴더 안의 bin 폴더 클릭 후 확인

 

확인을 누르면 환경 변수 설정이 완료됩니다.

---

📎 Android Studio Flutter 설치

Android Studio 안드로이드 스튜디오 설치 방법 (2023.08)

안드로이드 개발을 위해서는 Android Studio 설치가 필요합니다.

설치방법은 위 링크의 이전 포스팅을 참고해 주세요.

 

• Android Studio 실행
• Plugins 클릭
• Flutter 검색 후 설치

---

📎 Flutter Doctor 실행하기

• VSCode에서 Ctrl+Shift+P 입력 후 Flutter 검색
• Flutter: Run Flutter Doctor 실행

 

Flutter Doctor 실행하면 위와 같이 SDK 에러가 나타납니다.

SDK 설치가 정상적으로 되었어도, SDK 경로를 지정해줘야 하기 때문입니다.

• Locate SDK 클릭

 

• C:\flutter\bin 저장 경로 선택

---

📎 Flutter Doctor 이슈 해결 방법

SDK 연결 후 다시 Flutter Doctor를 실행하면,

이렇게 OUTPUT 출력창에 Flutter Doctor가 검사한 내용을 알려줍니다.

• [v] : 정상적으로 설치되었다는 의미
• [!] : 정상설치되지 않았으므로 해결해야 한다는 의미

 

1. "Android SDK Command-line Tool" 설치 없음 & Android license 확인 불가

[!] Android toolchain - develop for Android devices (Android SDK version 34.0.0)

    • Android SDK at C:\Users\kyjun\AppData\Local\Android\sdk

    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/to/windows-android-setup for more details.

 

• "Android SDK Command-line Tool" 설치 방법

• Android Studio 실행
• Settings > Languages & Frameworks > Android SDK
• SDK Tools에서 Android SDK Command-line Tools (latest) 클릭 후 Apply 적용

 

 

• Android license 확인 방법

• VSCode Terminal로 가서
• > flutter doctor --android-licenses 입력
• Accept? (y/N) 묻는 질문에 전부 y로 입력
• All SDK package licenses accepted 문구 확인되면 완료

 

2. Visual Studio "Desktop development with C++" 설치 없음

[!] Visual Studio - develop Windows apps (Visual Studio Community 2019 16.11.39)

    • Visual Studio at C:\Program Files (x86)\Microsoft Visual Studio\2019\Community

    • Visual Studio Community 2019 version 16.11.35130.168

    • Windows 10 SDK version 10.0.26100.0

    X Visual Studio is missing necessary components. Please re-run the Visual Studio installer for the "Desktop development with C++" workload, and include these components:

        MSVC v142 - VS 2019 C++ x64/x86 build tools

         - If there are multiple build tool versions available, install the latest

        C++ CMake tools for Windows

        Windows 10 SDK

 

• Visual Studio "Desktop development with C++" 설치 방법

• Visual Studio Installer 실행
• C++을 사용한 데스크톱 개발 설치

---

📎 Flutter 설치 완료

[flutter] flutter doctor -v

[√] Flutter (Channel stable, 3.24.4, on Microsoft Windows [Version 10.0.22631.4317], locale ko-KR)

    • Flutter version 3.24.4 on channel stable at C:\flutter

    • Upstream repository https://github.com/flutter/flutter.git

    • Framework revision 603104015d (14 hours ago), 2024-10-24 08:01:25 -0700

    • Engine revision db49896cf2

    • Dart version 3.5.4

    • DevTools version 2.37.3

[√] Windows Version (Installed version of Windows is version 10 or higher)

[√] Android toolchain - develop for Android devices (Android SDK version 34.0.0)

    • Android SDK at C:\Users\kyjun\AppData\Local\Android\sdk

    • Platform android-34, build-tools 34.0.0

    • Java binary at: C:\Program Files\Android\Android Studio\jbr\bin\java

    • Java version OpenJDK Runtime Environment (build 17.0.6+0-b2043.56-10027231)

    • All Android licenses accepted.

[√] Chrome - develop for the web

    • Chrome at C:\Program Files\Google\Chrome\Application\chrome.exe

[√] Visual Studio - develop Windows apps (Visual Studio Community 2019 16.11.39)

    • Visual Studio at C:\Program Files (x86)\Microsoft Visual Studio\2019\Community

    • Visual Studio Community 2019 version 16.11.35130.168

    • Windows 10 SDK version 10.0.26100.0

[√] Android Studio (version 2022.3)

    • Android Studio at C:\Program Files\Android\Android Studio

    • Flutter plugin can be installed from:

       https://plugins.jetbrains.com/plugin/9212-flutter

    • Dart plugin can be installed from:

       https://plugins.jetbrains.com/plugin/6351-dart

    • Java version OpenJDK Runtime Environment (build 17.0.6+0-b2043.56-10027231)

[√] VS Code (version 1.94.2)

    • VS Code at C:\Users\kyjun\AppData\Local\Programs\Microsoft VS Code

    • Flutter extension version 3.98.0

[√] Connected device (3 available)

    • Windows (desktop) • windows • windows-x64    • Microsoft Windows [Version 10.0.22631.4317]

    • Chrome (web)      • chrome  • web-javascript • Google Chrome 130.0.6723.70

    • Edge (web)        • edge    • web-javascript • Microsoft Edge 130.0.2849.46

[√] Network resources

    • All expected network resources are available.

• No issues found!

exit code 0

 

모든 메시지가 [v]되어 있고,

No issues found!

라는 메시지를 보면 설정 완료!