본문 바로가기

바닐라 코드/flutter

macOS Flutter 설치

 

1. 공식 사이트를 통해 Flutter 설치

  1. Flutter 공식 설치 가이드 확인:
    https://docs.flutter.dev/get-started/install/macos
  2. 설치가 완료되면 flutter doctor 명령어로 상태 확인:
    flutter doctor
    

2. Git 설치

  • Xcode를 설치하면 Git이 자동으로 설치됩니다.
  • 별도 Git 설치는 필요 없습니다.

3. Rosetta 설치

Apple Silicon(M1/M2) Mac에서 필수 설치 항목

  1. Rosetta 설치 명령:
    sudo softwareupdate --install-rosetta --agree-to-license
    
  2. Mac 비밀번호 입력:
    • 설치 과정에서 비밀번호 입력창이 나올 수 있습니다.

4. Flutter SDK 다운로드

  1. Flutter SDK 다운로드:
    • CPU에 맞는 SDK 파일을 Flutter 공식 사이트에서 다운로드.
  2. 원하는 폴더에 압축 해제:
    • 예: /Users/username/flutter.

5. PATH 설정 및 확인

Flutter 실행 파일을 PATH에 추가하여 터미널에서 실행 가능하도록 설정

  1. 터미널에서 아래 명령어를 실행:
    export PATH="$PATH:[PATH_TO_FLUTTER_SDK]/bin"
    
    예:
    export PATH="$PATH:/Users/username/flutter/bin"
    
  2. PATH 설정 확인:
    echo $PATH        # 등록된 경로 리스트 확인
    which flutter     # flutter 실행 경로 확인
    

6. Flutter Doctor 실행

  1. 터미널에서 다음 명령 실행:
    flutter doctor
    
  2. 출력 결과 확인:
    • [✓]가 표시된 항목은 정상적으로 설정된 상태.
    • [X]가 표시된 항목은 Flutter에서 제공하는 설명을 따라 해결.

7. Xcode 설치

  1. Xcode 설치 방법:
    • 앱스토어에서 Xcode 검색 후 설치.
    • 또는 아래 명령어로 설치:
      sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
      sudo xcodebuild -runFirstLaunch
      
  2. 설치 후 라이선스 동의:
    • 설치 과정에서 agree를 입력해야 할 수 있습니다.
  3. Xcode Command-line Tools 설치 확인:
    xcode-select --install
    

8. Android Studio 설치

  1. Android Studio 다운로드:
    https://developer.android.com/studio
  2. CPU에 맞는 버전을 다운로드하여 설치.
  3. Android Studio 설정:
    • 설치 완료 후 SDK 및 API 설정 → "Next".
    • 라이선스 동의 → "Finish".

9. Android Studio 설정 추가

9.1 SDK Manager 설정

  1. Android Studio 실행 → "Welcome to Android Studio" 화면에서 More Actions 클릭.
  2. SDK Manager 선택.
  3. 필수 구성 요소 선택:
    • Android SDK Build-Tools.
    • Android SDK Command-line Tools.
    • Android Emulator.
    • Android Emulator Hypervisor Driver.
    • Android SDK Platform-Tools.
  4. 적용 후 라이선스 동의 → 설치 완료.

9.2 Android Emulator 설정

  1. Android Studio 실행 → 우측 상단 점 세 개 메뉴Virtual Device Manager 클릭.
  2. Create Device 클릭:
    • 사용하려는 기기(예: Pixel 5 등)를 선택 → "Next".
  3. Android 버전 선택:
    • 원하는 Android 버전을 선택 후 다운로드 → "Next".
  4. Emulated Performance:
    • 가능한 경우 Hardware 옵션 선택 → "Finish".
  5. 생성된 가상 장치 리스트에서 Play 버튼(화살표) 클릭:
    • 가상 장치가 정상적으로 실행되는지 확인.

10. Flutter Doctor로 전체 확인

  1. Android Studio 및 Xcode 설치가 완료되면 다시 flutter doctor 명령어 실행:
    flutter doctor
    
  2. 모든 항목이 [✓] 상태인지 확인합니다.
    • [X]가 표시된 경우 Flutter에서 제공하는 설명을 따라 해결합니다.

10. 가상장치 관리자 설정 (Android Virtual Device 설정)

Flutter 개발 시 사용할 **가상 휴대폰(에뮬레이터)**을 설정하는 단계입니다.

가상 장치 설정 방법

  1. Android Studio 실행:
    • 실행 후, 시작화면의 More Actions 클릭.
    • 또는 우측 상단 점 세 개 메뉴를 클릭.
  2. Virtual Device Manager 선택:
    • 메뉴에서 Virtual Device Manager를 클릭.
  3. Create Device 클릭:
    • 사용할 기기(예: Pixel 5, Pixel 6)를 선택 → "Next".
  4. Android 버전 선택:
    • 사용할 Android 버전을 선택합니다.
    • 선택한 버전이 다운로드되지 않은 경우, 다운로드를 진행 → "Next".
  5. Emulated Performance 설정:
    • 성능 최적화를 위해 가능한 경우 Hardware 옵션 선택 → "Finish".
  6. 가상 장치 실행 확인:
    • 생성된 가상 장치 리스트에서 Play 버튼(화살표) 클릭.
    • 가상 장치가 정상적으로 실행되는지 확인합니다.

참고

  1. PATH 설정 영구 저장:
    • PATH 설정을 영구적으로 적용하려면 .zshrc 또는 .bash_profile에 추가:
      echo 'export PATH="$PATH:/Users/username/flutter/bin"' >> ~/.zshrc
      source ~/.zshrc
      

'바닐라 코드 > flutter' 카테고리의 다른 글