Flutter Doctor 실행시 발생할 수 있는 오류 모음

Flutter를 개발하기 전에 반드시 flutter doctor 명령어를 실행하여 개발환경이 올바르게 구성되었는지 확인해야 합니다. 아래는 flutter doctor 실행 시 발생할 수 있는 오류와 그에 대한 처리 방법입니다.

 

1. 오류: "Android toolchain - Unable to locate Android SDK"

해결 방법: Android Studio를 설치하고 안드로이드 SDK를 설치한 후 ANDROID_HOME 환경 변수를 설정해야합니다. 이를 위해 다음 절차를 수행합니다.
- Android Studio를 설치합니다.
- Android Studio에서 SDK Manager를 엽니다.
- Android SDK Platform과 Android SDK Build-Tools를 최소한 하나 이상 설치합니다.
- SDK Manager의 Android SDK Location 경로를 복사합니다.
- 환경 변수를 설정합니다.
        - macOS, Linux: $ export ANDROID_HOME=/path/to/android/sdk
        - Windows: set ANDROID_HOME=C:\Users\YOUR_USERNAME\AppData\Local\Android\Sdk
- 변경 사항을 적용하기 위해 터미널을 재시작합니다.

---

2. 오류: "Android licenses have not been accepted."

해결 방법: Android SDK를 설치한 후 flutter doctor --android-licenses 명령어를 실행하여 라이선스에 동의해야 합니다.
동의하기 위해서는 "y"를 입력하고 엔터키를 누르면 됩니다.

flutter doctor --android-licenses

---

3. 오류: "Unable to find bundled Java version."

해결 방법: Java 개발 도구(JDK)를 설치해야합니다. OpenJDK를 설치하려면 다음 명령어를 터미널에서 실행합니다.
macOS: brew install --cask adoptopenjdk/openjdk/adoptopenjdk8
Windows: Oracle JDK 또는 OpenJDK를 설치합니다.

---

4. 오류: "Flutter requires a minimum SDK version of 16."

해결 방법: 안드로이드 SDK 버전이 너무 낮아 Flutter가 지원하지 않습니다.
Android Studio에서 SDK Manager를 열고 최소한 API 16 이상의 SDK 버전을 설치합니다.

---

5. 오류: "Unable to locate git"

해결 방법: Git을 설치해야합니다. 다음 명령어를 실행하여 Git을 설치합니다.
macOS: brew install git
Windows: Git for Windows 를 다운로드하고 설치합니다.

---

6. 오류: "Unable to find Chrome executable."

해결 방법: Chrome 브라우저가 설치되어 있지 않은 경우 발생합니다.
Chrome 브라우저를 설치하거나 다른 브라우저를 사용합니다.
또는 flutter doctor --web 명령어를 사용하여 웹 개발에 필요한 모든 요구사항이 충족되었는지 확인합니다.

 

이상으로 flutter doctor 실행 시 발생할 수 있는 일부 오류와 그에 대한 처리 방법을 설명해보았습니다.