Homebrew를 사용한 맥북 플러터 설치하기

플러터로 개발을 하기 위해서는 가장 먼저 플러터를 설치해야겠죠? 플러터를 설치하는 방법엔 여러 가지가 있겠지만, 저는 homebrew를 사용해서 설치하는 방법에 대해서 알려드리려 합니다. Homebrew를 미리 깔아야 하기는 하지만 가장 깔끔하게 설치할 수 있어서 저는 이 방법을 제일 선호합니다. 이 포스트는 맥북 에어 m2 모델을 기반으로 작성되었다는 점을 알려드리며, 바로 시작해 보도록 하죠. 

---

플러터 시작하기 01 : Scaffold

---

필요한 프로그램 설치하기

우선 플러터를 설치하기 앞서 미리 설치해야 하는 프로그램들이 있습니다. 안드로이드 스튜디오, Xcode, 구글 크롬이 바로 그 주인공입니다. 정확하게 말씀드리자면 이 프로그램들이 필수는 아니지만, 안드로이드, iOS, 웹 개발을 하다 보면 어차피 필요하게 되는 프로그램이죠.

Xcode는 앱스토어에서 받으실 수 있습니다. 

안드로이드 스튜디오는 Android Developers 홈페이지에서 받으실 수 있습니다. 

구글 크롬은 구글 홈페이지에서 받으실 수 있습니다.

추가로 Apple Silicon 칩, 즉 m1, m2, m3 맥북에 플러터를 설치하기 위해서는 우선 Rosetta Translation을 설치해 주어야 합니다. Rosetta Translation은 인텔 아키텍처를 arm 아키텍처로 변환해 주는 프로그램입니다. 터미널에서 다음 명령어를 입력하면 간단하게 설치가 완료됩니다. 이후에 비밀번호를 입력하라고 나오면 맥북 비밀번호를 입력하시면 됩니다.

sudo softwareupdate --install-rosetta --agree-to-license

플러터 설치하기

사전 준비가 끝났으니 이제 플러터를 설치해 보죠. 터미널에서 다음 명령어를 입력해서 homebrew를 통해 설치를 진행해 보겠습니다.

brew install --cask flutter

잠시 기다리면 설치가 완료됩니다. Homebrew를 통해서 설치하면 환경 변수를 설정할 필요가 없어서 매우 편리하네요. 그럼 이제 플러터가 정상적으로 설치됐는지 알아보기 위해 플러터 닥터를 실행해 봅시다. 터미널에 다음 명령어를 입력하면 설치 현황을 볼 수 있습니다.

flutter doctor

잠시 기다리면 위 사진처럼 리포트가 나오는데요, 어디에서 설치가 완료되지 않았는지 쉽게 확인할 수 있어서 매우 편리합니다. 저는 Android toolchain과 Xcode에서 오류가 났네요. 플러터를 처음 설치할 때 가장 흔하게 나는 오류이기도 하죠. 하나씩 해결해 보도록 하겠습니다. 

Android toolchain 오류 해결하기

Android toolchain 오류 내역을 보면 두 가지 오류가 있는 것을 볼 수 있습니다. 첫 번째는 cmdline-tools를 찾을 수 없어서 나는 문제고요, 두 번째는 Android license를 아직 확인하지 않아서 나는 오류입니다. 우선 첫 번째 문제부터 해결해 보겠습니다.

 안드로이드 스튜디오를 실행한 후 More Actions > SDK Manager로 들어가 줍시다.

SDK Tools 탭으로 들어간 후 Android SDK Command-line tools (latest)를 찾아 체크하고  우측 하단에 OK 버튼을 클릭해 줍시다. 이어서 나오는 라이선스에 동의하고 설치를 진행하시면 됩니다. 이로써 첫 번째 문제는 해결됐습니다. 

두 번째 문제는 간단하게 해결할 수 있습니다. 터미널에서 다음 명령어를 입력한 후 나오는 라이선스에 동의하며 진행하기만 하면 됩니다. y를 입력하면서 진행하시면 됩니다. 

flutter doctor --android-licenses

Xcode 오류 해결하기

이번에는 Xcode에서 난 오류들을 해결해 보도록 하겠습니다.  첫 번째는 Xcode를 받은 후 아직 설치가 완료되지 않았기 때문에 나는 오류이고요, 두 번째는 iOS 개발에 필요한 CocoaPods가 설치되지 않아서 나는 오류입니다. 두 오류 모두 간단하게 해결이 가능합니다.

우선 첫 번째 오류는 다음 두 개의 명령어를 실행하면 간단하게 해결이 됩니다. 비밀번호를 입력하라고 나오면 이번에도 역시 맥북 비밀번호를 입력하시면 됩니다. 

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

CocoaPods는 homebrew를 통해서 설치가 가능합니다. 터미널에서 다음 명령어를 입력한 후 잠시 기다리면 설치가 완료됩니다.

brew install cocoapods

마무리

이제 마지막으로 한번 더 플러터 닥터를 실행한 후 위 사진처럼 문제가 없다고 나오면 성공적으로 설치가 완료된 것입니다. 이제 안드로이드 스튜디오나 VS Code 등을 사용해서 플러터 개발을 시작하시면 됩니다.

---