Ubuntu 24.04 환경에서 Flutter 개발 프레임워크 설정하기

Ubuntu 24.04 LTS(Noble Numbat) 운영체제에서 모바일 및 데스크톱 애플리케이션 개발을 위한 Flutter 환경을 구성하는 방법을 단계별로 설명합니다.

1. Flutter SDK 설치 및 경로 설정

먼저 SDK를 관리할 디렉토리를 생성하고 최신 안정 버전의 Flutter를 다운로드합니다. 이 가이드에서는 ~/development 디렉토리를 사용합니다.

# 작업 디렉토리 생성 및 이동
mkdir -p ~/development
cd ~/development

# Flutter SDK 다운로드 (버전은 릴리즈 시점에 따라 다를 수 있음)
wget https://storage.googleapis.com/flutter_infra_release/releases/stable/linux/flutter_linux_3.24.5-stable.tar.xz

# 압축 해제
tar -xf flutter_linux_3.24.5-stable.tar.xz

시스템에서 Flutter 명령어를 인식할 수 있도록 쉘 설정 파일(.zshrc 또는 .bashrc)에 환경 변수를 추가합니다.

# 환경 변수 등록
echo 'export FLUTTER_HOME="$HOME/development/flutter"' >> ~/.zshrc
echo 'export PATH="$PATH:$FLUTTER_HOME/bin"' >> ~/.zshrc

# 네트워크 환경에 따른 미러 서버 설정 (필요 시)
echo 'export PUB_HOSTED_URL="https://mirrors.tuna.tsinghua.edu.cn/dart-pub"' >> ~/.zshrc
echo 'export FLUTTER_STORAGE_BASE_URL="https://mirrors.tuna.tsinghua.edu.cn/flutter"' >> ~/.zshrc

# 설정 반영
source ~/.zshrc

2. 필수 시스템 의존성 설치

Linux 데스크톱 앱 개발 및 Flutter 엔진 구동을 위해 필요한 빌드 도구와 라이브러리를 설치합니다.

sudo apt update
sudo apt install -y clang cmake ninja-build pkg-config libgtk-3-dev curl git

3. Android 개발 환경 구성

Android Studio를 설치한 후, Android SDK Command-line Tools를 구성해야 합니다.

  1. Android Studio를 실행하고 Settings > Languages & Frameworks > Android SDK로 이동합니다.
  2. SDK Tools 탭에서 Android SDK Command-line Tools (latest)를 체크하고 설치합니다.

그다음, ADB(Android Debug Bridge) 경로를 환경 변수에 추가합니다.

echo 'export ANDROID_HOME="$HOME/Android/Sdk"' >> ~/.zshrc
echo 'export PATH="$PATH:$ANDROID_HOME/platform-tools"' >> ~/.zshrc
source ~/.zshrc

Android 라이선스 동의 절차를 진행합니다. 모든 물음에 y를 입력하여 승인합니다.

flutter doctor --android-licenses

4. 웹 개발 환경 설정 (Chrome)

Flutter Web 개발을 위해서는 Google Chrome 브라우저가 필요합니다. .deb 패키지를 통해 공식 설치를 권장합니다.

cd /tmp
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb

5. 개발 환경 최종 점검

모든 설정이 완료되었다면 flutter doctor 명령어를 실행하여 누락된 항목이 없는지 확인합니다.

flutter doctor

출력 결과에서 모든 항목에 체크 표시(✓)가 나타나면 성공입니다. 만약 특정 항목에 오류가 발생하면 아래의 해결 방법을 참고하십시오.

트러블슈팅 가이드

Linux Toolchain 관련 오류

clang++ 또는 ninja가 없다는 메시지가 나오면 다음 명령어로 의존성을 다시 확인합니다.

sudo apt install clang cmake ninja-build libgtk-3-dev

Android SDK 라이선스 미승인

라이선스 관련 경고가 뜨는 경우 다시 한 번 승인 명령을 실행합니다.

flutter doctor --android-licenses

Chrome 실행 파일을 찾을 수 없는 경우

설치 후에도 Chrome을 인식하지 못한다면 환경 변수에 실행 경로를 직접 지정해 줍니다.

export CHROME_EXECUTABLE=/usr/bin/google-chrome

태그: ubuntu Flutter Dart android-sdk Linux-Desktop

10월 31일 09:08에 게시됨