[Flutter] Mac flutter 개발 환경 설치 (Mac OS 13 Ventura)

Flutter SDK archive

macOS 13 Intel Mac에서 Flutter 3.22.0 설치하기

최근 Flutter로 모바일 앱을 개발하기 위해 개발환경을 설정했다.

그런데 사용 중인 Mac이 macOS 13.7.8에서 더 이상 OS 업데이트가 불가능했고, 최신 Flutter SDK를 설치했을 때 macOS 최소 지원 버전 문제로 실행되지 않았다.

 

 

그래서 최신 Flutter 대신 macOS 13에서 실행 가능한 Flutter 3.22.0을 직접 설치했습니다.

이 글에서는 인텔 맥 기준으로 설치 과정과 PATH 설정 방법을 정리했습니다.

---

1. 개발환경 확인

먼저 현재 Mac의 OS 버전을 확인한다.

sw_vers

실행 결과:

ProductName:    macOS
ProductVersion: 13.7.8
BuildVersion:   22H730

따라서 현재 환경은 macOS 13.7.8이다.

Mac의 CPU 아키텍처도 확인한다.

uname -m

 

결과:

x86_64

 

즉, Apple Silicon이 아닌 Intel Mac 인걸 확인할 수 있습니다. (다른방법도 있지만 일단 확인)

따라서 Flutter SDK를 다운로드할 때 x64 버전을 선택해야한다는 것을 알 수 있습니다.

---

2. 최신 Flutter를 사용할 수 없는 문제

처음에는 Homebrew를 통해 Flutter를 설치해보면 

brew --version

결과:

Homebrew 7.0.6

이후 Flutter를 실행했는데 다음과 같은 오류가 발생하게 됩니다.

VM initialization failed:
Current Mac OS X version 13.0 is lower than minimum supported version 14.0

즉, 현재 설치된 최신 Flutter SDK는 macOS 14 이상을 요구하고 있었다.

그래서 구형 맥에서는 Flutter의 구버전을 사용하는 방법을 선택해야합니다. 

---

3. Flutter 3.22.0 다운로드

방법은 간단합니다. 
플러터 가이드 문서에 들어가면 이전 버전의 SDK 다운로드를 안내하고 있습니다.
 

Flutter SDK archive

그래서 위 Flutter SDK Archive 항목에서 Mac OS 13을 지원하는 플러터 버전은 3.22.0 버전이라 알고 있어서 
3.22.0 버전을 다운로드 받아서 SDK를 다운로드한 후 압축을 해제했습니다. 
그리고 제가 개발하기 위한 경로에 Flutter SDK를 이동시켰습니다.

 

~/Desktop/Dev/flutter

 

즉 실제 경로는 다음과 같습니다.

/Users/사용자명/Desktop/Dev/flutter

 

---

4. Flutter SDK가 정상적으로 실행되는지 확인

PATH를 설정하기 전 SDK가 정상적으로 실행되는지 확인했습니다. 

~/Desktop/Dev/flutter/bin/flutter --version

정상이라면 다음과 같은 결과가 출력됩니다.

Flutter 3.22.0 • channel stable
Framework • revision 5dcb86f68f
Engine • revision f6344b75dc
Tools • Dart 3.4.0 • DevTools 2.34.3

이것으로 정상적으로 실행됐다면 Flutter SDK 자체는 정상적으로 설치된 것을 확인할 수 있습니다. 

---

5. Flutter PATH 설정

터미널에서 Flutter 명령어를 어디서든 사용할 수 있도록 하기위해서 PATH를 설정했습니다.

먼저 ~/.zprofile에 Flutter 경로를 추가했다.

echo 'export PATH="$HOME/Desktop/Dev/flutter/bin:$PATH"' >> ~/.zprofile

그리고 설정을 적용합니다.

source ~/.zprofile

이후 Flutter 명령어의 위치를 확인한다.

which flutter

정상적으로 설정되었다면 다음과 같이 출력된다.

/Users/사용자명/Desktop/Dev/flutter/bin/flutter

 

---

6. PATH가 바로 적용되지 않는 경우

설정 후에도 다음과 같이 나올 수 있다.

zsh: command not found: flutter

또는:

flutter not found

이 경우 현재 터미널 세션에 PATH를 직접 적용한다.

export PATH="$HOME/Desktop/Dev/flutter/bin:$PATH"

다시 확인한다.

which flutter

그리고:

flutter --version

정상적으로 Flutter 버전이 출력되면 PATH 설정이 완료된 것이다.

 

최종적으로 다음 명령어가 정상적으로 실행되는 것을 확인하면 된다.

which flutter
flutter --version
flutter doctor