맥OS에서 설치

시스템 요구 사항

Flutter를 설치하고 실행하기 위해서는 개발 환경이 다음과 같은 최소 요구 사항을 충족해야 합니다:

  • 운영 체제: macOS (64-bit)
  • 저장 공간: 2.8 GB (IDE나 개발 도구 용량은 별도).
  • 도구: Flutter는 맥OS 환경에서 아래 커멘트 라인 도구가 필요합니다.
    • bash
    • curl
    • git 2.x
    • mkdir
    • rm
    • unzip
    • which

Flutter SDK 다운로드

  1. 다음 설치 번들을 다운로드하여 Flutter SDK의 최신 stable 릴리즈를 받으세요:

    (loading…)

    다른 릴리즈 채널이나 이전 빌드를 받으려면 SDK 아카이브 페이지를 확인하세요.

  2. 다음 예시처럼 원하는 위치에 압축을 푸세요:

    $ cd ~/development
    $ unzip ~/Downloads/flutter_macos_vX.X.X-stable.zip
    
  3. flutter 도구를 path에 추가하세요:

    $ export PATH="$PATH:`pwd`/flutter/bin"
    

    이 명령은 현재 터미널 창에 대해서만 PATH 변수를 설정합니다. Flutter를 path에 영구적으로 추가하고 싶다면, Path 추가를 참고하세요.

  4. 선택적으로, 개발 바이너리를 사전 다운로드 하세요:

    flutter 도구는 필요에 따라 플래폼별 개발 바이너리를 다운로드 합니다. 미리 artifacts를 다운로드하는 게 바람직한 경우, 아래와 같은 방법으로 iOS 및 Android 바이너리를 먼저 다운로드 할 수 있습니다:

    $ flutter precache
    

    For additional download options, see flutter help precache.

이제 Flutter 명령을 실행할 수 있습니다!

Flutter doctor 실행

설정을 완료하는 데 필요한 플랫폼 의존성이 있는지 확인하기 위해 아래 명령을 실행하세요. (자세한 출력을 원한다면, -v 플래그를 추가하세요)

$ flutter doctor

이 명령은 당신의 환경을 체크하고 보고서를 터미널 창에 보여줍니다. Dart SDK는 Flutter와 함께 번들로 제공되기 때문에 별도로 설치할 필요가 없습니다. 출력된 내용을 꼼꼼히 보고 설치해야 할 다른 소프트웨어가 있는지 또는 수행해야 할 추가 작업이 있는지(굵은 글씨로 표시됨) 확인하세요.

예시:

[-] Android toolchain - develop for Android devices
    • Android SDK at /Users/obiwan/Library/Android/sdk
    ✗ Android SDK is missing command line tools; download from https://goo.gl/XxQghQ
    • Try re-installing or updating your Android SDK,
      visit https://flutter-kr.io/setup/#android-setup for detailed instructions.

다음 섹션에서는 이러한 작업을 수행하고 설치 과정을 완수하는 방법을 설명합니다. 누락된 디펜던시를 설치한 후에, flutter doctor 명령을 다시 실행하여 모든 설정이 올바른지 확인할 수 있습니다.

Update your path

You can update your PATH variable for the current session at the command line, as shown in Get the Flutter SDK. You’ll probably want to update this variable permanently, so you can run flutter commands in any terminal session.

The steps for modifying this variable permanently for all terminal sessions are machine-specific. Typically you add a line to a file that is executed whenever you open a new window. For example:

  1. Determine the directory where you placed the Flutter SDK. You need this in Step 3.
  2. Open (or create) the rc file for your shell. For example, macOS Mojave (and earlier) uses the Bash shell by default, so edit $HOME/.bashrc. macOS Catalina uses the Z shell by default, so edit $HOME/.zshrc. If you are using a different shell, the file path and filename will be different on your machine.
  3. Add the following line and change [PATH_TO_FLUTTER_GIT_DIRECTORY] to be the path where you cloned Flutter’s git repo:

    $ export PATH="$PATH:[PATH_TO_FLUTTER_GIT_DIRECTORY]/flutter/bin"
    
  4. Run source $HOME/.<rc file> to refresh the current window, or open a new terminal window to automatically source the file.
  5. Verify that the flutter/bin directory is now in your PATH by running:

    $ echo $PATH
    

    Verify that the flutter command is available by running:

    $ which flutter
    

플랫폼 설정

MacOS에서는 iOS 및 Android용 Flutter 앱을 모두 개발할 수 있습니다. 웹 개발(개발자 프리뷰)도 가능합니다. 첫번째 Flutter 앱을 만들고 실행하기 위해 두 플랫폼 중 하나 이상 설치를 완료하세요.

iOS 설정

Xcode 설치

iOS용 Flutter 앱을 개발하기 위해서는 Xcode가 설치된 맥이 필요합니다.

  1. 최신 안정 버전의 Xcode를 설치하세요 (웹에서 다운로드 혹은 맥 앱스토어).
  2. 아래 명령을 실행하여 새롭게 설치된 버전을 사용하도록 Xcode 커멘드라인 도구를 설정하세요

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

    최신 버전 Xcode를 사용하고자 할 때, 보통은 이 경로가 올바른 경로입니다. 다른 버전을 사용하기를 원한다면, 다른 경로를 지정해주세요.

  3. Xcode를 한 번 열어 확인을 선택하거나 커멘드라인에서 sudo xcodebuild -license를 입력하여 Xcode 라이센스 계약이 서명되었는지 확인하세요.

최신 안정 버전보다 오래된 버전도 동작할 순 있지만, Flutter 개발에 권장되지는 않습니다. 대상 비트 코드 이전 버전의 Xcode를 사용하는 것은 지원되지 않으며 동작하지 않을 수 있습니다.

Xcode를 사용하여 iOS 기기 또는 시뮬레이터에서 Flutter 앱을 실행할 수 있습니다.

iOS 시뮬레이터 설정

iOS 시뮬레이터에서 Flutter 앱을 실행하고 테스트하기 위해서, 아래 단계를 수행하세요:

  1. 맥에서 Spotlight를 통해 혹은 아래 명령을 입력하여 시뮬레이터를 찾으세요.

    $ open -a Simulator
    
  2. 시뮬레이터의 Hardware > Device메뉴의 설정에서 시뮬레이터가 64비트 기기(iPhone 5s 이상)를 활용하고 있는지 확인하세요.
  3. 기기 화면 크기에 따라서, 시뮬레이터에서 높은 해상도의 iOS 기기가 화면을 초과할 수 있습니다. 시뮬레이터의 Window > Scale 메뉴에서 기기의 스케일을 설정하세요.

간단한 Flutter 앱 만들고 실행하기

첫번째 Flutter 앱을 만들고 설정이 잘 되는지 확인하기 위해, 아래 단계를 수행하세요:

  1. 커멘드라인에서 아래 명령을 실행하여 새로운 Flutter 앱을 만듭니다:

    $ flutter create my_app
    
  2. Flutter’s starter 앱이 들어있는 my_app 디렉토리가 생성됩니다. 해당 디렉토리로 이동하세요:

    $ cd my_app
    
  3. 시뮬레이터에서 앱을 실행하기 위해, 시뮬레이터가 실행중인지 확인한 후 다음을 입력하세요:

    $ flutter run
    

iOS 기기에 배포

Flutter 앱을 실제 iOS 기기에 배포하려면 서드 파티 CocoaPods 의존성 관리자와 Apple 개발자 계정이 필요합니다. 또한, Xcode에서 실제 기기 배포 설정을 해야합니다.

  1. 아래 명령어로 CocoaPods을 설치하고 설정하세요:

    $ sudo gem install cocoapods
    $ pod setup
    
  2. Xcode 서명 흐름에 따라 프로젝트를 프로비저닝하세요:

    1. Flutter 프로젝트 디렉토리에서 터미널로 open ios/Runner.xcworkspace 명령을 실행하여 기본 Xcode 워크스페이스를 여세요.
    2. 실행 버튼 옆 기기 선택 메뉴에서 배포하고 싶은 기기를 선택하세요.
    3. Xcode 왼쪽 내비게이션 패널에서 Runner 프로젝트를 선택하세요
    4. Runner target 설정 페이지에서, 개발팀이 잘 선택 됐는지 확인하세요. Xcode버전에 따라 UI가 조금씩 다릅니다.
      • Xcode 9 & 10에서는 General > Signing > Team 아래에 있습니다.
      • Xcode 11 이상에서는, Signing & Capabilities > Team 아래에 있습니다.

      팀을 선택하면, Xcode가 개발 인증서를 생성하고 다운로드한 후, 계정에 기기를 등록하고, 프로비저닝 프로파일을 생성 및 다운로드합니다 (필요할 경우).

      • 처음 iOS 개발 프로젝트를 시작하기 위해, 애플 ID로 Xcode에 로그인해야 할 수도 있습니다. Xcode account add 모든 애플 ID가 개발 및 테스트에 사용 가능합니다. 앱 스토어에 앱을 배포하려면 애플 개발자 프로그램에 등록해야 합니다. 맴버십 유형에 관한 자세한 내용은 맴버십 선택을 참고하세요.

      • iOS 개발을 위해 실제 기기를 처음 연결하면, 맥과 개발 인증서를 모두 신뢰해야 합니다. iOS 기기를 맥에 처음 연결할 때 대화 상자에서 Trust를 선택하세요.

        Trust Mac

        다음으로, iOS 기기의 설정으로 가서, General > Device Management로 이동하여 인증서 신뢰하기를 선택하세요.

      • Xcode에서 자동 서명이 실패한다면, 프로젝트의 General > Identity > Bundle Identifier가 고유한지 확인해보세요. Check the app's Bundle ID

  3. flutter run 명령으로 앱을 시작하세요.

Android 설정

Android 스튜디오 설치

  1. Android 스튜디오 다운드로 및 설치.
  2. Android 스튜디오를 시작하고 ‘Android 스튜디오 설치 마법사’를 실행합니다. 설치 마법사는 Flutter로 Android를 개발할 때 필요한 최신 Android SDK, Android SDK 플랫폼 도구, Android SDK 빌드 도구를 설치합니다.

Android 기기 설정

Android 기기에서 Flutter 앱을 실행하고 테스트하기 위해서, Android 4.1 (API 16) 이상에서 동작하는 Android 기기가 필요합니다.

  1. 기기에서 개발자 옵션USB 디버깅을 활성화 해야합니다. 자세한 사항은 Android 문서에서 확인하실 수 있습니다.
  2. 윈도우인 경우: 구글 USB 드라이버를 설치하세요.
  3. USB케이블을 이용하여 기기를 컴퓨터에 연결하세요. 장치에 관한 메시지가 나타나면, 컴퓨터가 장치에 접근할 수 있도록 권한을 부여하세요.
  4. Flutter에 안드로이기 기기가 연결됐는지 확인하기 위해 터미널에서 flutter devices 명령을 실행하세요. 기본적으로, Flutter는 adb 도구에 연결된 버전의 Android SDK를 사용합니다. 다른 곳에 설치된 Android SDK를 사용하고 싶다면, ANDROID_HOME 환경 변수를 해당 디렉토리로 변경해야 합니다.

Android 에뮬레이터 설정

Android 에뮬레이터에서 Flutter 앱을 실행하고 테스트하기 위해, 아래 단계를 수행하세요:

  1. 기기에서 VM 가속화를 활성화하세요.
  2. Android Studio > Tools > Android > AVD Manager를 실행하고 Create Virtual Device를 선택하세요. (Android 하위 메뉴는 Android 프로젝트 내부에 있을 때만 나타납니다.)
  3. 기기 해상도를 선택하고 Next를 누르세요.
  4. 가상화하려는 Android 버전에 맞게 1개 이상의 시스템 이미지를 선택하고 Next를 누르세요. x86 또는 x86_64 를 권장합니다.
  5. 에뮬레이터 성능에서, 하드웨어 가속화를 위해 Hardware - GLES 2.0를 선택하세요.
  6. AVD 구성이 올바른지 확인하고 Finish를 선택하세요.

    위 단계에 대한 자세한 내용은 AVD 관리를 참고하세요.

  7. Android 가상 기기 관리자에 있는 툴바에서 Run을 클릭하세요. 에뮬레이터가 시작되고 선택한 OS 버전과 기기의 기본 캔버스가 표시됩니다.

Web setup

To prepare to run and test your Flutter app on the web, you must install Chrome, if you haven’t already.

다음 단계

선호하는 편집기를 설정하세요.