Flutter 환경 변수 설정 가이드

0

Flutter는 모바일, 웹, 데스크탑 애플리케이션을 한 번에 개발할 수 있는 크로스 플랫폼 개발 도구로 많은 개발자에게 사랑받고 있습니다. Flutter를 제대로 활용하기 위해서는 몇 가지 필수적인 환경 변수 설정이 필요합니다. 이번 글에서는 Flutter 개발 환경 설정에 대해 하나씩 살펴보겠습니다.

1. Flutter SDK 경로 설정

Flutter SDK는 Flutter 명령어를 터미널 또는 명령 프롬프트에서 사용할 수 있도록 설정해주는 필수 과정입니다.

Windows 설정:

환경 변수 창을 열고, 시스템 변수의 Path를 선택하고, 편집을 클릭합니다. 그리고 Flutter SDK가 설치된 경로를 추가합니다:

C:\src\flutter\bin

설정을 저장한 후, 명령 프롬프트를 재시작하고 아래의 명령어를 실행해 올바르게 설정되었는지 확인합니다.

flutter --version

macOS/Linux 설정:

터미널에서 `.bash_profile` 또는 `.zshrc` 파일을 엽니다:

nano ~/.bash_profile  # 또는 nano ~/.zshrc

다음 명령을 추가합니다:

export PATH="$PATH:/Users/your_username/flutter/bin"

파일을 저장한 후, 다음 명령어로 환경 변수를 적용합니다:

source ~/.bash_profile  # 또는 source ~/.zshrc

이 설정을 완료하면 Flutter 명령어를 명령줄에서 쉽게 사용할 수 있게 됩니다.

2. Android SDK 경로 설정

Flutter에서 Android 앱을 빌드하려면 Android SDK가 필요합니다. 이를 위해 `ANDROID_HOME` 환경 변수를 설정해야 합니다.

Windows 설정:

환경 변수 창을 열고, 시스템 변수에서 새로 만들기를 클릭하고 다음 정보를 입력합니다:

  • 변수 이름: `ANDROID_HOME`
  • 변수 값: Android SDK 경로: `C:\Users\your_username\AppData\Local\Android\Sdk`

시스템 변수 Path에 다음 경로를 추가합니다:

%ANDROID_HOME%\platform-tools

macOS/Linux 설정:

터미널에서 `.bash_profile` 또는 `.zshrc` 파일을 열고, 다음을 추가합니다:

export ANDROID_HOME=~/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools

파일을 저장하고 환경 변수를 적용합니다:

source ~/.bash_profile  # 또는 source ~/.zshrc

이 설정을 통해 Flutter에서 Android 앱 빌드를 수행할 수 있게 됩니다.

3. Java 환경 변수 설정

Flutter가 Android 프로젝트를 빌드할 때는 Java JDK가 필요합니다. Android Studio에 내장된 JDK를 사용할 수 있으며, 별도로 설치한 경우에는 `JAVA_HOME` 환경 변수를 설정해야 합니다.

Windows 설정:

환경 변수 설정 창을 열고, 시스템 변수에서 새로 만들기를 선택하고 다음 정보를 입력합니다:

  • 변수 이름: `JAVA_HOME`
  • 변수 값: `C:\Program Files\Android\Android Studio\jre`

macOS/Linux 설정:

`.bash_profile` 또는 `.zshrc` 파일을 열고, 다음을 추가합니다:

export JAVA_HOME="/Applications/Android Studio.app/Contents/jbr"
export PATH="$JAVA_HOME/bin:$PATH"

파일을 저장한 후, 환경 변수를 적용합니다:

source ~/.bash_profile  # 또는 source ~/.zshrc

이로써 Java 환경 설정도 완료되었습니다. 설정이 완료되면 `java -version` 명령어를 사용해 JDK가 제대로 설치되었는지 확인할 수 있습니다.

4. Dart SDK 경로 설정

Flutter SDK에는 Dart SDK가 포함되어 있어 별도로 Dart SDK 경로를 설정할 필요는 없습니다. Flutter SDK가 설치되면 자동으로 Dart 명령어를 사용할 수 있습니다.

5. 설정 후 확인

환경 변수를 모두 설정했다면, 몇 가지 명령어로 설정이 제대로 되었는지 확인할 수 있습니다:

Flutter 버전 확인:

flutter --version

Android SDK 경로 확인:

echo $ANDROID_HOME  # macOS/Linux
echo %ANDROID_HOME%  # Windows

Java 버전 확인:

java -version

이 명령어들을 사용하여 환경 설정이 정상적으로 이루어졌는지 확인해보세요.

결론

Flutter 환경 변수를 설정하는 것은 개발을 시작하기 위한 필수 과정입니다. Flutter SDK, Android SDK, 그리고 Java JDK의 설정을 통해 크로스 플랫폼 앱 개발을 효율적으로 시작할 수 있습니다. 특히 Flutter의 장점은 한번의 설정만으로 여러 플랫폼에서 사용할 수 있는 유연성입니다. 이번 가이드를 따라 환경 변수를 설정하고, Flutter로 더욱 풍부한 개발 경험을 시작해 보세요!

Leave a Reply