[flutter] 공식문서에도 알려주지 않는 플러터 초기 세팅의 비법 (fvm)

개요

Flutter 프레임워크를 처음 도입하는 과정에서 개발자는 SDK 설치와 관련된 여러 불편함을 경험하게 된다. 공식 문서에서 안내하는 절차에 따르면 압축 파일을 내려받고 특정 경로에 압축을 해제한 뒤 시스템 환경 변수에 PATH를 등록해야 한다. 그러나 이러한 방식은 버전 간 전환이 빈번히 요구되는 실무 환경에서 비효율적이다.

참조하는 튜토리얼이 Flutter 3.10을 기준으로 작성되어 있으나 본인의 환경에는 3.22가 설치되어 있는 경우, 혹은 협업 중인 팀원의 프로젝트가 자신의 환경에서 정상적으로 빌드되지 않는 경우가 대표적인 예시이다.

Node.js 생태계의 nvm(Node Version Manager)과 유사하게 커맨드라인 인터페이스를 통해 Flutter SDK 버전을 관리할 수 있다면 이러한 문제를 효과적으로 해결할 수 있다. fvm(Flutter Version Management)은 바로 이러한 목적으로 개발된 도구이다.

FVM 설치

Installation – FVM

macOS 환경


brew tap leoafarias/fvm
brew install fvm

Windows 환경


choco install fvm

Windows 환경에서는 FVM이 심볼릭 링크를 생성하는 과정에서 시스템 권한이 요구되므로, 터미널을 반드시 관리자 권한으로 실행하여야 한다.

FVM 기본 사용법

Flutter SDK 설치


fvm releases          # 설치 가능한 버전 목록 조회
fvm install stable    # stable 채널 설치
fvm install 3.19.6    # 특정 버전 설치

프로젝트별 버전 지정


cd my_flutter_project
fvm use stable

이 과정에서 주의할 점은 flutter doctor 명령을 실행하기 이전에 반드시 fvm use를 먼저 수행해야 한다는 것이다. 그렇지 않을 경우 전역에 설치된 Flutter SDK를 기준으로 환경 검사가 수행될 수 있다.

Flutter 명령 실행

FVM 도입 이후에는 flutter 명령 대신 fvm flutter 형식을 사용한다.


fvm flutter doctor
fvm flutter pub get
fvm flutter run

프로젝트 생성


mkdir my_app
cd my_app
fvm use stable
fvm flutter create .

주요 명령어 정리

명령어	기능
`fvm list`	설치된 SDK 버전 목록 조회
`fvm releases`	설치 가능한 버전 목록 조회
`fvm install <version>`	지정한 버전의 SDK 설치
`fvm use <version>`	현재 프로젝트에 버전 지정
`fvm remove <version>`	설치된 SDK 삭제

결론

Flutter 개발 환경 구축에 있어 핵심은 SDK를 단순히 설치하는 것이 아니라 체계적으로 관리하는 것이다. 프로젝트 생성 이전에 FVM을 먼저 구성함으로써 버전 불일치로 인한 문제를 사전에 방지할 수 있다.