Flutter 개발 시작 (macOS)

목차

 

❗️XCode 설치가 오래 걸리므로, 미리 App Store에서 설치 시작한 뒤, 이후 프로세스를 따라가는 것이 좋음

설치 전 확인 사항

• macOS 10.14 (Majave) 이상
  • Apple Silicon Mac 에서 설치시 Rosetta translation environment 설치 필요

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

• XCode 15
• CocoaPods 1.12
• Android Studio 2022.3 (Giraffe) 이상 (VS Code 미사용시)

 

Flutter SDK 설치 (Stable Channel macOS)

• link: https://docs.flutter.dev/get-started/install/macos/mobile-ios?tab=download
  • mac 사용자 기준 (Architecture 선택)
    • Intel → x64
    • M1, M2 칩 → arm64
• 다운받아 압축풀고 flutter폴더를 원하는 위치에 두기 (ex. `/Users/{myUsrName}/Desktop/Projects/flutter`)

 

Path 영구적 추가

• flutter 명령어를 아무 terminal session에서 실행시키기 위해 PATH 변수를 업데이트
• Flutter SDK를 다운받은 경로 확인 (ex. /Users/{myUsrName}/Desktop/Projects/flutter)
• terminal을 열어 echo $SHELL 명령으로 어떤 shell을 사용하고 있는지 확인

• bash를 사용중이면 $HOME/.bashrc를 생성/수정, Z shell을 사용중이면 $HOME/.zshrc를 생성/수정
  • _anyEditorHere_ $HOME/.bashrc 로 파일을 editor로 열기 (ex. code $HOME/.bashrc)
• 열린 파일 안에 다음 라인을 추가 ([path]는 위 Flutter SDK를 다운받은 경로로 넣기)

export PATH="$PATH:[PATH_TO_FLUTTER_SDK_DIRECTORY]/flutter/bin"

• source $HOME/.bashrc (혹은 /.zshrc)로 현재 terminal window를 refresh
• echo $PATH 와 which flutter를 통해 path 업데이트 확인

 

Flutter 실행

• flutter 명령어를 실행하여 필요한 SDK 다운로드

• flutter doctor 실행하여 dependencies확인

 

Xcode 설치/세팅

• Xcode 다운로드 및 설치 - https://developer.apple.com/xcode/
  • Xcode가 새롭게 설치된 버전을 사용하도록 설정, iOS 시뮬레이터 설치

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

• • Xcode를 열어 확인을 선택 하거나 sudo xcodebuild -license 를 입력하여 라이센스 계약 서명
• iOS 시뮬레이터 설정
  • open -a Simulator로 시뮬레이터 실행
  • 여기까지 하고 flutter doctor 명령어를 통해 현 상황을 확인한다

 

New Flutter Project

• 커멘드라인에서 flutter create my_flutter_app으로 새로운 Flutter app 생성
• 생성된 flutter app directory로 들어가 시뮬레이터가 실행중인지 확인 후 flutter run 입력
• 새로운 Flutter Application이 생성됨
  • flutter run 실행시 flutter pub get, pod install, Xcode build 까지 알아서 해줌

Flutter Project 구성

• pubspec.yml → 프로젝트의 metadata를 정의 (font, package, 기타 등등)
• ios / android → 각 OS의 배포를 위한 directory
• test → 테스팅을 위한 폴더
• lib → 작성한 코드가 들어가는곳, 주로 이 안에서 작업함

 

에러 Fix

• CocoaPods not installed
  • CocoaPods 설치를 위해 ruby를 설치해야하고, ruby 설치를 위해 homebrew 설치
    Homebrew 설치:
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    ruby 설치:
    brew install ruby
    CocoaPods 설치:
    sudo gem install cocoapods