Flutter & Android Studio 설치 및 설정 가이드

Flutter & Android Studio 설치 및 설정 가이드(MacOS M2)

1. Flutter 설치

1. Flutter SDK 다운로드:
   • Flutter 공식 사이트에서 최신 버전의 Flutter SDK를 다운로드합니다.
   • 다운로드한 ZIP 파일을 원하는 디렉토리에 압축을 해제합니다. 예를 들어, ~/flutter 또는 ~/Desktop/flutter 같은 경로를 선택합니다.
2. 경로 설정:
   • Flutter 명령어를 어디서든 사용할 수 있도록 PATH 환경 변수에 Flutter 경로를 추가합니다.
   • 터미널에서 다음 명령어로 .zshrc 파일을 엽니다:
     bash

     코드 복사

     nano ~/.zshrc
   • .zshrc 파일에 다음 줄을 추가합니다:
     bash

     코드 복사

     export PATH="$PATH:/Users/your-username/flutter/bin"
   • 변경 사항을 적용하려면 다음 명령어를 실행합니다:
     bash

     코드 복사

     source ~/.zshrc
3. 설치 확인:
   • 터미널에서 flutter doctor 명령어를 실행하여 설치 상태를 확인합니다:
     bash

     코드 복사

     flutter doctor
   • 이 명령은 기본적인 설치 상태를 확인하고 필요한 추가 설정을 알려줍니다.

2. Android Studio 설치 및 Flutter 플러그인 설정

1. Android Studio 설치:
   • Android Studio 공식 사이트에서 Android Studio를 다운로드하고 설치합니다.
   • macOS 사용자는 .dmg 파일을 열고, Android Studio 아이콘을 Applications 폴더로 드래그하여 설치합니다.
2. Flutter 및 Dart 플러그인 설치:
   • Android Studio를 열고 Preferences (Windows/Linux에서는 Settings)로 이동합니다.
   • Plugins를 선택한 후, Marketplace에서 Flutter를 검색하여 설치합니다. Flutter 플러그인을 설치하면 Dart 플러그인도 자동으로 설치됩니다.
   • 설치가 완료되면, Android Studio를 재시작합니다.
3. Android SDK 설정:
   • Android Studio에서 Preferences > Appearance & Behavior > System Settings > Android SDK로 이동하여, 필요한 SDK 버전을 설치합니다. 보통 최신 버전이나 프로젝트에서 요구하는 버전을 선택하면 됩니다.

3. Xcode 설정 (iOS 개발용)

1. Xcode 설치:
   • Mac App Store에서 Xcode를 다운로드하고 설치합니다.
   • 설치 후, Xcode를 열고 Xcode > Preferences > Locations에서 Command Line Tools가 선택되어 있는지 확인합니다.
2. CocoaPods 설치:
   • iOS 플러그인 관리를 위해 CocoaPods가 필요합니다.
   • 터미널에서 다음 명령어를 입력하여 CocoaPods를 설치합니다:
     bash

     코드 복사

     sudo gem install cocoapods
   • 설치가 완료되면 pod setup을 실행하여 초기 설정을 완료합니다:
     bash

     코드 복사

     pod setup

4. Flutter 설정 점검 및 문제 해결

Flutter와 Android Studio 설정 과정에서 자주 발생하는 오류와 해결 방법을 정리했습니다.

---

주요 오류 및 해결 방법

1. flutter 명령어가 인식되지 않을 때

• Flutter 경로가 올바르게 설정되지 않은 경우입니다.
• .zshrc 파일을 열어 export PATH="$PATH:/Users/your-username/flutter/bin" 줄을 추가하고, 변경 사항을 적용합니다:
  bash

  코드 복사

  source ~/.zshrc
• 경로가 정확히 설정되었는지 확인하기 위해 echo $PATH로 경로를 출력해 보세요.

2. Some Android licenses not accepted 오류

• Android SDK 라이선스에 동의하지 않은 경우 발생합니다.
• 터미널에서 다음 명령어를 실행하여 라이선스에 동의합니다:
  bash

  코드 복사

  flutter doctor --android-licenses

3. Xcode not installed 오류

• iOS 개발을 위해 Xcode가 설치되지 않았거나, Command Line Tools가 설정되지 않은 경우 발생합니다.
• Xcode를 설치하고, Xcode > Preferences > Locations에서 Command Line Tools가 올바르게 설정되었는지 확인하세요.

4. CocoaPods not installed 오류

• iOS 플러그인 관리를 위해 CocoaPods가 필요하지만 설치되지 않은 경우입니다.
• Ruby 버전이 낮은 경우 CocoaPods 설치가 실패할 수 있습니다. Ruby를 최신 버전으로 업데이트 후 설치를 다시 시도합니다:
  bash

  코드 복사

  brew install ruby sudo gem install cocoapods pod setup
• 설치 후 pod --version으로 CocoaPods가 제대로 설치되었는지 확인합니다.

5. Flutter 버전이나 채널 오류 (0.0.0-unknown 오류)

• Flutter가 잘못 설치되었거나 Git 설정에 문제가 있는 경우 발생합니다.
• 다음 명령어로 안정적인 채널로 전환 후 업데이트합니다:
  bash

  코드 복사

  flutter channel stable flutter upgrade

6. Unable to get list of installed Simulator runtimes 오류

• Xcode 시뮬레이터가 설치되지 않았거나 올바르게 설정되지 않은 경우 발생합니다.
• Xcode를 열고 Xcode > Settings > Components로 이동하여 필요한 iOS 시뮬레이터를 설치합니다.

---

5. 최종 점검

설정이 완료되면, 터미널에서 flutter doctor 명령어를 실행하여 모든 설정이 제대로 완료되었는지 최종 점검하세요.

bash

코드 복사

flutter doctor

모든 항목이 체크 표시(✓)로 나타나고 "No issues found!" 메시지가 표시되면 성공적으로 설정이 완료된 것입니다.

 

 

• Flutter SDK 다운로드 및 경로 설정: Flutter 명령어를 사용하기 위해 경로를 환경 변수에 추가.
• Android Studio 설치 및 Flutter 플러그인 설정: Android Studio에 Flutter와 Dart 플러그인을 설치하여 Flutter 개발 환경 구축.
• Xcode와 CocoaPods 설정 (iOS 개발용): iOS 개발을 위해 필요한 Xcode와 CocoaPods 설정.
• Flutter 환경 점검 및 오류 해결: flutter doctor 명령으로 필수 구성 요소가 제대로 설치되었는지 확인하고 발생할 수 있는 오류 해결.