Flutter | MacOS 개발 환경 구축

Flutter는 iOS와 Android APP을 한 번에 개발할 수 있는 Google에서 개발한 크로스플랫폼 프레임워크이다.

더해서 Web과 Windows, MacOS도 개발 가능하다.

Table of Contents

SDK Download & 환경 변수

SDK Download

먼저 Flutter SDK를 설치해 준다. Flutter SDK 설치는 공식 페이지(www.flutter.dev/get-started/install)에서 자신의 칩(인텔 또는 애플실리콘)에 맞는 MacOS 버전을 다운로드 받아 적당한 경로에 압축을 푼다.

환경 변수

다음은 macOS가 Flutter SDK의 위치를 알 수 있도록 환경변수를 세팅해 준다.

macOS는 Bash 또는 Z Shell의 2가지 종류의 쉘을 사용하는데 알아보기 위해 다음 명령을 실행해 본다.

echo $SHELL

여기서 “/bin/bash”라는 출력이 나오면 ‘Bash’이고 “/bin/zsh”이라는 출력이 나오면 ‘Z Shell’이다.

// Bash 사용시
vi ~/.bash_profile
vi ~/.bashrc

// Z Shell 사용시
vi ~/.zshrc

위와 같이 편집기를 이용하여 프로필 파일의 끝에 다음 코드를 추가한다.

export PATH="$PATH:{압축 푼 경로}/bin"

예를 들어 “$HOME/Development/SDK”경로에 압축을 풀었다면

export PATH="$PATH:$HOME/Development/SDK/flutter/bin"

위와 같이 입력 후 저장해준다.

Xcode 설치

Xcode는 애플 앱스토어에서 제공하니 간단히 설치하면 된다.

다만 설치가 완료되면 시스템에서 사용할 버전으로 설정하기 위해 아래 명령을 실행해 준다.

sudo xcodebuild -license accept
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch

이 후 안내에 따라 완료까지 진행한다.

Brew & CocoaPods 설치

CocoaPods는 iOS, macOS 프로젝트에 서드파티 라이브러리와 의존성을 관리하는 도구이다. 외부 라이브러리를 쉽게 추가하고 관리하기 위해 사용한다.

“https://brew.sh/“로 접속해 “Install Homebrew” 설치 스크립트를 복사해서 터미널을 통해 실행한다.

설치 과정을 완료하면 아까와 같이 환경 변수에 brew 위치를 등록해준다.

// Bash 사용시
echo 'PATH="usr/local/bin:$PATH"' >> ~/.bash_profile

// Z Shell 사용시
echo 'PATH="usr/local/bin:$PATH"' >> ~/.zshrc

이제 터미널을 재시작한 후 다음과 같이 CocoaPods를 설치해준다.

brew install CocoaPods

Android Studio 설치

안드로이드 스튜디오 홈페이지(https://developer.android.com/studio)에서 자신의 칩에 맞는 스튜디오를 다운로드 및 기본값으로 설치한다.

다음 Dart/Flutter 플러그인을 설치한 후 스튜디오를 재시작 한다.

자바 설치

우선 “flutter doctor”를 이용해서 Flutter에서 사용하는 자바 버전을 확인한다.

flutter doctor --verbose

위 명령의 출력 결과로 확인되는 자바버전을 설치해 주어야 한다.

좀 전 설치한 brew를 이용하여 설치할 수 있다.

// Homebrew 미설치시 Homebrew 설치명령
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

// Homebrew로 자바 설치 (예 : 버전 17)
brew install openjdk@17

jdk 설치 후 해당 경로를 프로파일 파일을 수정하여 환경번수 ‘JAVA_HOME’에 설정해 준다.

프로파일 vi 편집기로 열고,

// Bash 사용시
vi ~/.bash_profile
// Z Shell 사용시
vi ~/.zshrc

아래 코드를 끝에 작성해 준다.

export JAVA_HOME="/opt/homebrew/opt/openjdk@17"
export PATH="/opt/homebrew/opt/openjdk@17/bin:$PATH"
export PATH=$JAVA_HOME/bin:$PATH

자바 버전 확인 명령

// Bash 사용 시
source ~/.bash_profile
// Z Shell 사용 시
source ~/.zshrc

// 자바 버전 확인
java -version

Flutter SDK가 JDK 버전을 사용하도록 세팅하기 (예 : JDK Version 17)

flutter config --jdk-dir=$JAVA_HOME

Flutter Doctor로 확인하기

아래 명령으로 Flutter 환경에 대한 종합 점검 및 확인이 가능하다.

flutter doctor

출력 결과가 모두 초록색 체크박스여야 한다.

문제 예시 : cmdline-tools component is missing

Android SDK Command Line Tools가 없어서 생긴 문제이다.

Android Studio에서 Customize > All settings > Language & Frameworks > Android SDK > SDK Tools 탭에서 찾아서 설치할 수 있다.

문제 예시 : Android license status unknown

Android Studio 라이선스 동의가 필요하다. 아래 명령만 실행하면 해결 가능하다.

flutter doctor --android-licenses

참고

좋은 글 : 책 컨셉수업 1장