본문 바로가기

춘기IT/춘기개발

Flutter 개발 환경 설정 (MacOS 플러터 설치)

 

 

 

🛠 Flutter 개발 환경 설정 (MacOS 플러터 설치)

 

✅ brew 설치

  • Homebrew 사이트 접속
  • 중앙에 보이는 install Homebrew 하단의 명령 커멘드 라인 복사
  • 터미널 -> 복사한 명령 커멘드 붙여넣기 -> 비밀번호 입력(Password: 맥북 잠금모드 해제 시 사용하는 비밀번호)
  • 설치 완료 후 brew를 어디서든 사용할 수 있도록 PATH 환경 설정 진행 (터미널에서 가이드 해줌) 

       “Run these two commands in your terminal to add Homebrew to your PATH:”

        ㄴ 하단의 두 줄을 한 줄 씩 터미널에서 각각 복사 붙여넣기

  • 설치 및 환경 셋팅 완료
  • 모든 창을 닫고 새로운 터미널 열어서 homebrew 버전 출력

       ㄴ brew --version 입력 후 Enter > Homebrew 버전 확인

 

✅ git 설치

  • brew를 설치했기 때문에 git 설치를 brew 명령어를 통해 간단하게 설치 진행
  • 터미널 -> brew install git 입력 후 Enter
  • 설치 완료 시 git --version 입력하여 버전 확인

✅ flutter sdk 설치

  • Flutter SDK archive 접속
  • 우측 상단의 Get started -> macOS -> Desktop (Ios 선택해도 상관 없음)
  • 스크롤 내려서, Install the Flutter SDK -> Download and install -> Intel chip과 Apple chip에 따라 맞는 zip 파일 다운로드
  • SDK 경로에는 한글이 입력되면 안됨
  • home -> development -> sdk -> 다운로드받은 zip파일 압축 푼 후 zip 파일 삭제

       ㄴ flutter 폴더 위치: /Users/[사용자이름]/development/sdk

  • flutter PATH 잡기 -> 터미널에서 cd~ 입력 후 Enter -> vi .zshrc

       ㄴ 위치 중요* cd~ 통해서 홈 화면에서 진행

       ㄴ [경로 확인] 새로운 터미널에서 cd development/sdk/flutter/bin 입력 후 Enter -> pwd 입력 후 Enter 

  • vi .zshre 입력한 터미널에

       ㄴ export PATH="$PATH:/Users/[사용자이름]/development/sdk/flutter/bin" 입력 ->

  • 터미널 가장 끝에 :wq 입력(write and quit의 약자, 저장하고 나가기)
  • 새로운 터미널에 source ~/.zshrc 입력 후 Enter -> 환경변수 리로드 -> flutter 명령어 정상 실행 확인 
  • flutter --version 입력하여 버전 확인

✅ VSCode 설치

✅ Android Studio 설치

  • Android Studio 사이트 접속
  • Android 스튜디오 다운로드 (Koala / Meerkat)
  • 동의 후 Intel chip과 Apple chip에 따라 맞는 zip 파일 다운로드
  • Application에 하나 넣고, 더블 클릭으로 실행 -> Next -> 라이선스 항목 동의 후 진행 -> 설치 완료

✅ xcode 설치

  • 앱스토어에서 xcode 입력 후 설치 진행
  • 열기 버튼으로 실행 확인 -> 동의 -> 비밀번호 입력 -> macOS 선택(다른 것 추가 설치 가능) 후 설치

✅ flutter doctor 이슈 대응

  • 터미널 -> flutter doctor 입력 -> 이슈 확인

 🚫 1. softwareupdate 문제 > flutter doctor가 이슈 가이드 해줌

  • sudo softwareupdate --install-rosetta --agree-to-license 복사 -> 새로운 터미널에 붙여넣기
  • 완료 되면 기존 터미널에 flutter doctor 실행하여 문제 해결됐는지 확인 

 🚫 2. Android toolchain 문제

  • android studio 실행 -> More Action -> SDK Manager 메뉴 선택
  • SDK Tools 탭 메뉴 -> 목록 중 Android SDK Command-line Tools(latest) 체크 -> Apple -> 설치 -> Finish
  • 터미널에 flutter doctor --android-licenses 입력 -> 모든 항목에 y로 입력
  • 완료 되면 터미널에 flutter doctor 실행하여 문제 해결됐는지 확인 

 🚫 3. Xcode installation 문제

  • fluter doctor가 이슈 가이드 해줌 -> 두가지 명령어 복사하여 터미널에 입력

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

       ㄴ sudo xcodebuild -runFirstLaunch

  • 터미널에 flutter doctor 실행하여 문제 해결됐는지 확인 

 🚫 4. CocoaPods 설치 문제

  • 터미널에 brew install cocoapods 입력 -> 설치 완료
  • 터미널에 flutter doctor 실행하여 문제 해결됐는지 확인 

 🚫 5. xcode unable to get list of installed Simulator runtimes 오류

  • 터미널에 xcodebuild -downloadPlatform iOS 입력 -> 설치 완료
  • 터미널에 flutter doctor 실행하여 문제 해결됐는지 확인