MacOS에서 Flutter 개발 환경 설정
안녕하세요! 이 가이드에서는 MacOS에서 Flutter 개발 환경을 설정하는 방법에 대해 상세히 알아보겠습니다. 저는 이전에 Windows에서만 Flutter 작업을 해왔기 때문에 MacOS로 전환했을 때 과정이 꽤 달랐습니다. 특히 iOS 개발을 위한 설정이 추가로 필요해서 적응하는 데 시간이 걸렸습니다. 이 가이드는 Android Studio를 사용하는 Flutter 개발자를 위해 작성되었으며, Windows에서 MacOS로 전환하는 과정에서 겪을 수 있는 여러 문제들을 해결하는 데 도움이 되시길 바랍니다!
목차
1. Homebrew 설치하기
MacOS에서 패키지 관리자인 Homebrew를 먼저 설치합니다.
- Homebrew 공식 웹사이트에 접속합니다.
- 웹사이트 중앙에 표시된 설치 명령어를 복사합니다.
- 터미널을 열고 복사한 명령어를 붙여넣고 실행합니다.
- 비밀번호를 입력하라는 메시지가 나타나면 Mac 로그인 비밀번호를 입력합니다.
- 설치가 완료되면 PATH 환경을 설정해야 합니다. 터미널에 표시된 두 개의 명령어를 각각 복사하여 실행합니다.
- 새 터미널을 열고
brew --version명령어를 입력하여 설치가 정상적으로 완료되었는지 확인합니다.
2. Git 설치하기
Homebrew를 이용해 Git을 간편하게 설치합니다.
- 터미널에서 다음 명령어를 실행합니다:
brew install git - 설치가 완료되면
git --version명령어로 설치 상태를 확인합니다.
3. Flutter SDK 설치하기
Flutter SDK를 다운로드하고 적절한 위치에 설정합니다.
-
Flutter SDK 다운로드 페이지로 이동합니다.
-
'Stable Channel' 섹션에서 'macOS' 탭을 선택합니다.
-
필요한 버전(예: 3.3.2)을 찾아 Mac 칩셋에 맞는 zip 파일을 다운로드합니다:
- Intel 칩 맥북: Intel zip 파일 다운로드
- Apple 실리콘(M1/M2) 맥북: Apple chip zip 파일 다운로드
-
다운로드 받은 zip 파일의 압축을 풉니다.
-
홈 디렉토리에 development/sdk 폴더 구조를 생성합니다:
mkdir -p ~/development/sdk -
압축 해제한 Flutter 폴더를 ~/development/sdk 경로로 이동시킵니다.
-
Flutter 명령어를 어디서든 사용할 수 있도록 PATH 환경 변수를 설정합니다:
- 홈 디렉토리로 이동:
cd ~ - .zshrc 파일 편집:
vi .zshrc - 'i' 키를 눌러 편집 모드로 전환
- 다음 라인 추가:
export PATH="$PATH:/Users/[사용자이름]/development/sdk/flutter/bin" - [사용자이름]을 본인의 맥 사용자 계정명으로 변경
- ESC 키를 누른 후
:wq를 입력하고 엔터를 눌러 저장 후 종료 - 변경사항 적용:
source ~/.zshrc
- 홈 디렉토리로 이동:
-
flutter --version명령어로 Flutter가 정상적으로 설치되었는지 확인합니다.
4. Android Studio 설치하기
Flutter 앱 개발을 위해 Android Studio를 설치합니다.
- Android Studio 다운로드 페이지로 이동합니다.
- MacOS에 맞는 버전을 다운로드합니다:
- Intel 칩: Mac with Intel chip
- Apple 실리콘: Mac with Apple chip
- 다운로드한 파일을 실행하고 'Open' 버튼을 클릭합니다.
- 설치 마법사를 따라 진행하며, 라이선스 동의 항목에 체크합니다.
- 설치가 완료될 때까지 기다립니다.
- 설치 후 Android Studio를 실행하고 Flutter 플러그인을 설치합니다:
- Preferences/Settings > Plugins 메뉴로 이동
- Marketplace 탭에서 'Flutter' 검색
- Flutter 플러그인 설치 (Dart 플러그인도 자동으로 설치됨)
- Android Studio 재시작
5. Xcode 설치하기
iOS 앱 개발을 위해 필수적인 Xcode를 설치합니다.
- App Store를 열고 검색창에 'Xcode'를 입력합니다.
- Xcode를 설치합니다 (용량이 크므로 시간이 걸릴 수 있습니다).
- 설치가 완료되면 Xcode를 실행합니다.
- 필요한 경우 MacOS 로그인 비밀번호를 입력하고 라이선스 동의에 'Agree'를 클릭합니다.
- 추가 컴포넌트 설치 화면에서 필요한 컴포넌트를 선택하고 'Install'을 클릭합니다.
- iOS 시뮬레이터 사용을 위해 다음 단계를 수행합니다:
- Xcode > Preferences > Components 메뉴로 이동
- 필요한 iOS 시뮬레이터 버전 다운로드
6. Flutter doctor 이슈 해결하기
설치 후 Flutter doctor를 실행하여 환경 설정 이슈를 확인하고 해결합니다.
- 터미널에서
flutter doctor명령어를 실행합니다. - 표시되는 이슈들을 하나씩 해결합니다:
Rosetta 2 설치 (Apple 실리콘 Mac의 경우)
sudo softwareupdate --install-rosetta --agree-to-licenseAndroid toolchain 이슈 해결
- Android Studio를 실행하고 'More Actions > SDK Manager'로 이동합니다.
- 'SDK Tools' 탭에서 'Android SDK Command-line Tools (latest)'를 체크합니다.
- 'Apply' 버튼을 클릭하여 설치합니다.
- 터미널에서 Android 라이선스에 동의합니다:
flutter doctor --android-licenses - 모든 라이선스 동의 항목에 'y'를 입력합니다.
Xcode 설정 이슈 해결
Flutter doctor 출력에 표시된 명령어들을 실행합니다.
CocoaPods 설치
brew install cocoapodsiOS 시뮬레이터 이슈 해결 (필요한 경우)
xcodebuild -downloadPlatform iOS마무리
모든 단계를 완료한 후 flutter doctor 명령어를 다시 실행하여 모든 이슈가 해결되었는지 확인하세요. 모든 항목에 체크 표시가 나타나면 Flutter 개발 환경이 성공적으로 구축된 것입니다.
이제 Android Studio에서 Flutter를 사용하여 iOS 및 Android 앱을 모두 개발할 수 있습니다:
- Android Studio 실행
- New Flutter Project 선택
- 프로젝트 이름과 위치 설정
- 프로젝트 생성 후 iOS 시뮬레이터나 Android 에뮬레이터 선택
- 실행 버튼 클릭
