[Flutter] 설치 (macos)

최근에 시작한 프로젝트에서 Flutter를 사용하기로 했기에 Flutter 설치 과정을 가져왔다.

 

 

 

 

오늘은 Flutter를 처음 접하는 나를 위한 .. Flutter Install 가이드가 되겠다.

 

 

 

 

 

 

 

 

🔽 나의 스펙

• mac os m2
• git, homebrew 설치되어있음.

 

 

🔽 공식 문서 링크

아래의 공식문서 링크를 보면 자세하게 설명되어 있으니 아래의 글을 따라 읽고 따라하면된다.

• https://docs.flutter.dev/get-started/install/macos/mobile-ios

Start building Flutter iOS apps on macOS

• https://codingapple.com/unit/flutter-install-on-windows-and-mac/

• 공식문서 말고 이런 영상 강의도 있다.

Flutter 설치와 개발환경 셋팅 2025 (윈도우 / 맥) - 코딩애플 온라인 강좌

 

 

 

 

 

 

 

 

🔽 1. Flutter SDK 설치

Flutter를 설치하는 두 가지 방법이 있는데, 나는 Flutter SDK 압축 파일을 다운로드하였다.

아래의 두 버튼에서 download and install 을 눌러서 우측의 apple silicon으로 설치했다.

 

 

🔽 2. Flutter SDK 설치

나는 플러터 sdk압축 파일의 압축을 풀고 그 파일을 desktop/tool/flutter 폴더 안에 넣었다.

 

 

 

🔽 3. PATH 환경 변수에 Flutter 추가 (zsh 기준)

1) zsh 설정 파일 열기
~/.zshrc 파일을 텍스트 편집기로 연다.

예를 들어, nano를 사용한다면:

nano ~/.zshrc

 

2) Flutter SDK 경로 추가
파일의 맨 아래에 아래 줄을 추가한다.
여기서 flutter 폴더가 Desktop/tool/flutter에 있다고 가정하면, 아래와 같다.

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

• $HOME은 사용자의 홈 디렉토리를 나타낸다.
• 만약 경로가 다르다면 해당 경로에 맞게 수정하시길.

 

🔽 4. 설정 확인

1. flutter 명령어 확인
iTerm2에서 다음 명령어를 입력하여 Flutter가 올바르게 PATH에 추가되었는지 확인한다.
Flutter의 버전 정보가 출력되면 정상적으로 설정된 것입니다.

flutter --version

 

 

2. flutter doctor 실행
추가로 환경 점검을 위해 아래 명령어를 실행하면, Flutter 설치 상태 및 추가적으로 필요한 도구(Xcode, Android toolchain 등)를 확인해준다.

flutter doctor

 

 

 

 

🔽 5. iOS 개발 환경 구성 - Xcode 설치 및 설정

Mac App Store에서 Xcode를 검색하여 설치한다.

설치 후 Xcode를 한 번 실행하여 라이선스 동의 및 초기 설정을 완료한다.

터미널에서 아래 명령어를 실행하여 Xcode의 개발 도구 경로를 지정합니다.

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

 

 

 

 

 

🔽 6. iOS 개발 환경 구성 - CocoaPods 설치

CocoaPods는 iOS 프로젝트에서 외부 라이브러리(패키지)를 관리하는 도구다.

 

1) CocoaPods 설치 (Homebrew 사용)

brew install cocoapods

 

2) 초기 CocoaPods 셋업 (선택사항)

pod setup

 

 

 

🔽 7. VSCode 확장 플러그인 설치

VSCode를 사용하여 Flutter 앱을 개발할 예정이라면, 아래 확장을 설치하는 것이 좋다.

VSCode의 확장(Extensions) 탭에서 "Flutter"와 "Dart"를 검색하여 설치한다.

 

 

 

 

🔽 8. 중간 점검

여기까지 진행하고 flutter doctor 명령어를 실행해보면 아래와 같이 android toolchain 문제가 뜬다.

 

 

 

🔽 9. android studio 설치

android 설치하고 sdk에서 'android SDK Command-line Tools' 를 설치해준다.

 

~/Library/Android/sdk/cmdline-tools/latest/bin/sdkmanager --install "cmdline-tools;latest"

설치후 위의 명령어를 입력해주니 문제 해결!

 

 

 

 

 

 

 

 

🔽 10. 새 Flutter 프로젝트 생성 및 실행

1) 프로젝트 생성
터미널에서 아래 명령어를 입력합니다.

flutter create my_flutter_app

 

2) 프로젝트 디렉터리로 이동 후 실행

cd my_app 
flutter run

 

그럼 아래와 같이 잘 작동하는 것을 확인할 수 있다.

 

 

 

 

 

끝!