플러터 개발 환경 설정 오류 해결 가이드: "Error running 'main.dart': Dart SDK is not configured" 문제 해결

 

플러터 개발 환경을 설정하는 과정에서 "Error running 'main.dart': Dart SDK is not configured"라는 오류 메시지를 만나셨나요?

걱정하지 마세요! 이 오류는 대부분 Flutter SDK 경로가 제대로 설정되지 않아 발생하는 간단한 문제입니다.

다음 단계별 가이드를 통해 쉽게 해결할 수 있습니다.

 

1. 문제 상황

 

플러터를 설치 및 설정하는 과정에서 "Error running 'main.dart': Dart SDK is not configured"라는 오류 메시지가 나타난다면, 대부분 Flutter SDK 경로가 올바르게 설정되지 않은 것이 원인입니다.

 

2. 해결 방법

 

1단계: 안드로이드 스튜디오에서 Flutter SDK 경로 설정

1. 안드로이드 스튜디오를 실행합니다.
2. 상단 메뉴에서 File > Settings를 선택합니다.
3. 왼쪽 메뉴에서 Language & Framework를 선택합니다.
4. Flutter 탭을 선택합니다.
5. Flutter SDK path 항목에 Flutter SDK가 설치된 경로를 정확하게 입력합니다.
6. OK 버튼을 클릭하여 변경 사항을 저장합니다.

Flutter SDK 경로 확인 방법

• Windows
  • 기본 설치 경로: C:\Program Files\flutter
  • 환경 변수 FLUTTER_HOME에 설정된 경로를 사용할 수도 있습니다.
• macOS
  • 기본 설치 경로: /Users/<사용자 이름>/Library/Flutter
  • 환경 변수 FLUTTER_HOME에 설정된 경로를 사용할 수도 있습니다.
• Linux
  • 기본 설치 경로: /home/<사용자 이름>/flutter
  • 환경 변수 FLUTTER_HOME에 설정된 경로를 사용할 수도 있습니다.

2단계: 명령줄을 통한 Flutter SDK 경로 설정

 

명령줄을 사용하여 Flutter SDK 경로를 설정하는 방법도 있습니다.

• Windows

  setx FLUTTER_HOME "<플러터 SDK 설치 경로>"
  

• macOS

  export FLUTTER_HOME="<플러터 SDK 설치 경로>"
  

• Linux

  export FLUTTER_HOME="<플러터 SDK 설치 경로>"
  

위 명령어를 실행한 후 터미널을 다시 시작해야 합니다.

 

3단계: Flutter Doctor 실행

 

위 단계들을 모두 완료한 후, 다음 명령어를 사용하여 Flutter Doctor를 실행하여 설정이 올바르게 적용되었는지 확인합니다.

flutter doctor

출력 결과에서 Flutter SDK path: 항목이 설정한 경로로 정확하게 표시되어야 합니다.

 

4. 추가 정보

• Flutter 공식 문서: https://flutter.dev/docs/get-started/install
• Flutter SDK 설치 방법
• Flutter Doctor 사용법

5. 마무리

 

위 단계들을 따라 Flutter SDK 경로를 설정하면 "Error running 'main.dart': Dart SDK is not configured" 오류를 해결할 수 있을 것입니다.

만약 여전히 문제가 해결되지 않는다면, Flutter 공식 커뮤니티 포럼 (https://flutter.dev/community) 에서 도움을 요청하거나, 관련 블로그 및 문서를 참고하시기 바랍니다.

 

도움이 되었기를 바랍니다!