모바일, 웹, 데스크톱 애플리케이션을 단일 코드로 개발할 수 있는 Flutter는 크로스 플랫폼 개발의 핵심 도구로 자리매김했습니다. 2025년 현재, Flutter의 설치 및 개발 환경 설정은 이전 버전에 비해 더욱 간편해졌지만, 여전히 운영체제(Windows, macOS)별 필수 단계를 정확히 따르는 것이 중요합니다. 이 가이드에서는 2025년 최신 정보를 반영하여 Flutter SDK 설치부터 Android Studio 및 Visual Studio Code(VS Code) 환경 설정까지 완벽하게 안내해 드립니다.
📚 함께 읽으면 좋은 글
특히 2024년에는 안정화된 버전의 기능들이 개발자들에게 큰 호응을 얻었으며, 2025년에는 더욱 발전된 성능과 생태계를 기반으로 최신 설치 방법을 숙지하고 개발 환경을 구축하는 것이 효율적인 개발 시작의 첫걸음입니다.
Flutter 설치 시작 개발 환경 구축 전 준비사항 확인하기
Flutter 설치를 시작하기 전에 시스템 요구 사항을 충족하는지 확인하는 것이 중요합니다. Flutter SDK를 다운로드하고 올바르게 작동시키기 위해서는 최소한의 디스크 공간과 운영체제 버전이 필요합니다.
운영체제별 시스템 요구사항 및 필수 도구 보기
Windows 또는 macOS 사용자 모두에게 공통적으로 필요한 몇 가지 필수 도구가 있습니다. 기본적으로 Git 설치는 Flutter SDK 업데이트 및 관리를 위해 필수적이며, 개발 IDE로는 Android Studio 또는 VS Code 중 하나를 선택해야 합니다. Android Studio는 Android 개발 환경을 통합적으로 지원하며, VS Code는 가볍고 빠른 편집 환경을 제공합니다.
특히 Windows 사용자의 경우, Flutter SDK를 다운로드하여 압축을 풀고 환경 변수를 설정하는 과정이 핵심입니다. macOS 사용자는 Terminal을 사용하여 설치 경로를 설정하고 flutter doctor 명령어를 실행하여 설치 상태를 확인하는 것이 일반적입니다.
개발자는 자신이 선호하는 운영체제와 IDE를 선택할 수 있지만, Flutter 개발의 핵심인 Dart 언어 및 위젯 시스템을 원활하게 사용하기 위해서는 가장 최신 버전의 안정화된 SDK를 설치하는 것이 가장 중요합니다.
Flutter SDK 다운로드 및 환경 변수 설정 상세 더보기
Flutter 개발을 위한 첫 단계는 Flutter SDK를 다운로드하고 시스템 환경 변수를 설정하는 것입니다. 이 과정은 운영체제에 따라 세부적인 절차가 다르므로, 사용자의 환경에 맞는 단계를 정확히 따라야 합니다.
Windows 환경에서 Flutter SDK 설치 및 Path 설정 확인하기
Windows에서는 Flutter SDK 파일을 원하는 위치(예: C:\src\flutter)에 압축 해제한 후, 해당 폴더 내의 bin 디렉토리를 시스템 환경 변수의 ‘Path’에 추가해야 합니다. 이 작업은 명령 프롬프트나 PowerShell에서 Flutter 명령어를 전역적으로 실행할 수 있게 해줍니다. Path 설정이 완료된 후에는, 새로운 명령 프롬프트 창을 열고 flutter doctor 명령어를 실행하여 설치 상태를 진단할 수 있습니다.
macOS 환경에서 Flutter SDK 설치 및 Path 설정 보기
macOS 사용자는 터미널을 사용하여 SDK를 다운로드하거나 Git을 통해 클론(Clone)하는 방식을 선호합니다. SDK 파일을 다운로드했다면, 역시 적절한 위치에 압축을 풀고 ~/.zshrc 또는 ~/.bash_profile 파일에 Flutter bin 폴더의 경로를 추가하여 환경 변수를 설정해야 합니다. Mac에서는 추가적으로 Homebrew와 같은 패키지 관리자를 사용하여 필수 도구를 설치하는 것이 편리할 수 있습니다.
Android Studio를 이용한 Flutter 개발 환경 설정 확인하기
Android Studio는 Flutter 개발을 위한 가장 강력한 IDE 중 하나입니다. Flutter 및 Dart 플러그인을 설치하면 코드 자동 완성, 디버깅, 에뮬레이터 실행 등 다양한 개발 편의 기능을 사용할 수 있습니다.
Android Studio 설치 및 플러그인 설치 상세 더보기
Android Studio를 설치한 후, ‘Settings(설정)’ 메뉴로 이동하여 ‘Plugins(플러그인)’ 섹션에서 **’Flutter’**와 ‘Dart’ 플러그인을 검색하여 설치해야 합니다. Flutter 플러그인을 설치하면 Dart 플러그인은 자동으로 함께 설치되는 경우가 많습니다. 플러그인 설치 후에는 IDE를 재시작해야 변경 사항이 적용됩니다.
Android SDK 및 에뮬레이터 설정 보기
Flutter 앱을 Android 기기나 에뮬레이터에서 실행하기 위해서는 Android SDK와 SDK Command-line Tools가 필요합니다. 이들은 Android Studio 설치 시 대부분 포함되지만, flutter doctor 실행 시 누락된 항목이 있다면 Android Studio의 SDK Manager를 통해 추가 설치해야 합니다. 또한, AVD Manager를 사용하여 Android 가상 장치(에뮬레이터)를 생성하여 앱 테스트 환경을 구축해야 합니다.
Visual Studio Code VS Code 환경에서 Flutter 설정 확인하기
Android Studio보다 가벼운 개발 환경을 선호하는 개발자들은 VS Code를 많이 사용합니다. VS Code에서도 Flutter 개발에 필요한 모든 기능을 플러그인을 통해 사용할 수 있습니다.
VS Code 설치 및 필수 확장 설치 상세 더보기
VS Code를 설치하고 실행한 후, 좌측의 확장(Extensions) 마켓플레이스에서 ‘Flutter’ 확장을 검색하여 설치합니다. 이 확장 역시 Dart 언어 지원을 포함하고 있습니다. VS Code는 Android Studio에 비해 설정이 간단한 편이며, 터미널에서 flutter run 명령어를 사용하여 앱을 실행하거나 디버깅할 수 있습니다.
VS Code 환경에서 개발할 경우, ‘Flutter’ 확장과 ‘Dart’ 확장 외에도 개발 생산성을 높여주는 다양한 유틸리티 확장을 함께 설치하는 것을 추천합니다.
Flutter Doctor 명령어 실행 및 개발 환경 최종 점검 보기
Flutter 설치 과정의 마지막 단계이자 가장 중요한 단계는 flutter doctor 명령어를 실행하여 개발 환경을 진단하는 것입니다. 이 명령어는 Flutter SDK, Android Toolchain, Android Studio, VS Code, 연결된 장치 등 모든 필수 구성 요소의 상태를 체크하고 누락되거나 문제가 있는 부분을 알려줍니다.
flutter doctor 진단 결과 해석 및 해결 방법 확인하기
flutter doctor 명령어 실행 후 모든 항목이 ‘✅’ 체크 표시로 나오면 개발 환경 설정이 성공적으로 완료된 것입니다. 만약 ‘❌’ 또는 ‘!’ 경고 표시가 있다면, 해당 메시지를 읽고 안내된 해결책(예: Android 라이선스 동의, 누락된 SDK 컴포넌트 설치 등)을 따라 문제를 해결해야 합니다. 예를 들어, ‘Android toolchain’ 문제의 경우, flutter doctor --android-licenses 명령어를 실행하여 라이선스에 동의해야 해결되는 경우가 많습니다.
새로운 Flutter 프로젝트 생성 및 실행 확인하기
개발 환경 설정이 완료되었다면, 새로운 Flutter 프로젝트를 생성하고 성공적으로 실행되는지 확인하는 것으로 모든 준비를 마칩니다.
IDE를 이용한 프로젝트 생성 및 실행 상세 더보기
Android Studio 또는 VS Code에서 ‘New Flutter Project’ 옵션을 선택하여 프로젝트를 생성합니다. 생성된 프로젝트에서 기본적으로 제공되는 카운터 앱(main.dart)을 Android 에뮬레이터, 실제 디바이스, 또는 웹 브라우저에서 실행하여 Flutter 개발 환경이 완벽하게 작동하는지 최종적으로 확인합니다. 이 단계에서 앱이 성공적으로 빌드되고 실행된다면, 이제 본격적인 Flutter 개발을 시작할 준비가 된 것입니다.
📌 추가로 참고할 만한 글
자주 묻는 질문 FAQ
Flutter SDK 설치 후 Path 설정을 해야 하는 이유는 무엇인가요?
Path 설정은 운영체제에게 Flutter 실행 파일(flutter.bat 또는 flutter)이 어디에 있는지 알려주는 역할을 합니다. Path 설정을 하지 않으면, 사용자는 Flutter 명령어를 실행할 때마다 SDK가 설치된 디렉토리로 이동하거나 전체 경로를 입력해야 하는 불편함이 있습니다. Path에 등록하면 어떤 디렉토리에서든 flutter 명령어를 입력하여 SDK 기능을 사용할 수 있게 됩니다.
Android Studio와 VS Code 중 어떤 IDE를 사용하는 것이 좋나요?
Android Studio는 Google에서 공식적으로 지원하는 IDE로, Android 에뮬레이터 관리, 디버깅 도구 등 통합적인 Android 개발 환경에 강점을 가집니다. VS Code는 가볍고 빠르며, 다양한 언어를 지원하는 범용 에디터로, 특히 개발 속도와 확장성이 뛰어납니다. 초보자는 통합된 환경을 제공하는 Android Studio를, 경험자는 빠르고 유연한 VS Code를 선호하는 경향이 있습니다. 개인의 선호도와 프로젝트 요구사항에 따라 선택하는 것이 좋습니다.
2025년 기준, Flutter 설치 시 2024년 버전과 달라진 주요 사항이 있나요?
2024년은 Flutter의 안정화와 기능 개선이 주를 이루었고, 2025년 최신 버전에서는 특히 웹 및 데스크톱 플랫폼 지원의 안정성과 성능이 더욱 향상되었습니다. 설치 과정 자체는 크게 달라지지 않았지만, 새로운 버전의 Dart 언어와 종속성(Dependencies) 업데이트에 대한 명확한 요구사항이 생길 수 있습니다. 항상 공식 문서에서 권장하는 최신 안정화 버전을 설치하는 것이 중요합니다.
flutter doctor 실행 시 ‘Android license status unknown’ 오류가 발생했어요. 어떻게 해결해야 하나요?
이 오류는 Android SDK 라이선스에 동의하지 않았을 때 발생합니다. 이 문제를 해결하려면 명령 프롬프트나 터미널에서 다음 명령어를 실행하면 됩니다: flutter doctor --android-licenses. 이 명령어를 실행하면 약관에 동의할지 묻는 메시지가 여러 번 나타나는데, 모두 ‘y’를 입력하여 동의하면 문제가 해결됩니다.
Flutter 프로젝트 생성 후 앱이 에뮬레이터에서 실행되지 않아요. 무엇을 확인해야 하나요?
앱이 실행되지 않는 일반적인 원인은 다음과 같습니다:
- 에뮬레이터(또는 실제 장치)가 연결되지 않았거나 인식되지 않은 경우 (
flutter devices명령어로 확인) - Android SDK 또는 Toolchain에 문제가 있는 경우 (
flutter doctor명령어로 확인) - IDE에서 올바른 디바이스를 선택하지 않은 경우
- VT-x 또는 HAXM과 같은 가상화 기술이 활성화되지 않은 경우
flutter doctor의 출력 결과를 가장 먼저 확인하고, 에뮬레이터 또는 장치 연결 상태를 점검하는 것이 우선입니다.