Flutter with Apple Device

플러터로 애플 기기용 앱 개발 시작하기(Xcode)

기본적으로 설치한 Flutter SDK만으로는 애플 기기에 접근하거나 애플 기기용으로 만들수가 없다. X code로 build하는 과정이 필요하기 때문이다. 이를 위해 Xcode를 설치하고 path에 등록해줘야 한다.

1. Xcode 설치

https://developer.apple.com/xcode/ 이곳에서 설치할 수 있다.
나의 경우 이미 설치는 되어 있는데 정식 개발환경으로 초기화되어 있지 않았다. 따라서 Setup을 해줘야 하는 상황이다.

2. Xcode setup & license

sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'

먼저 xcode-select는 개발자 도구의 기준을 xcode로 변경한다는 명령어이고, xcodebuild는 최초 실행 시 필요한 초기 설정을 자동으로 실행하는 명령이다.

이 과정을 거치고, 위에서 이미 되었겠지만 혹시 모르니 xcode 라이선스를 검토하고 서명해줘야 한다.

sudo xcodebuild -license

3. 필수 도구 다운로드

ios 플랫폼 지원 및 최신 ios 시뮬레이터 런타임을 다운로드하기 위함이다.

xcodebuild -downloadPlatform iOS

무려 8GB나 된다.

4. install Rosetta

ARM(Apple Silicon)에서 개발하는 경우 Rosetta2를 설치해야 한다. Flutter 자체는 ARM 네이티브를 잘 지원하지만, Xcode 내부 일부 도구가 x86_64로만 제공되거나 CocoaPods / Ruby gem일 경우, iOS 시뮬레이터 관련 문제가 있는 경우에 이를 설치해야 한다. 다만 실무에서 사용하고 있다면 혹시 모를 상황에 대비하는 보험같은 느낌이다.

5. CocoaPods : apple 네이티브 라이브러리 관리자

플러터 플러그인 중 네이티브 코드가 포함된 것들을 연결시켜주는 라이브러리 관리자로 카메라, 비디오 플레이어 등을 사용하기 위해서는 설치해주는 것이 좋다.

brew install cocoapods

6. PATH 설정

이전에 안 했던 flutter의 path설정을 이번에 해보겠다.
설치한 Flutter SDK의 위치를 찾고, .zshrc의 맨 아래에 export Path="$PATH:$HOME/(SDK 위치) 이렇게 추가해준다. 이후에 ctrl + O를 하고 enter, ctrl + x로 마무리해준다. 그러면 편집기를 나와서 source ~/.zshrc로 적용해준다.

7. 확인

➜  ~ flutter --version
flutter doctor

Flutter 3.38.5 • channel stable • https://github.com/flutter/flutter.git
Framework • revision f6ff1529fd (6 days ago) • 2025-12-11 11:50:07 -0500
Engine • hash c108a94d7a8273e112339e6c6833daa06e723a54 (revision 1527ae0ec5) (6 days ago) • 2025-12-11
15:04:31.000Z
Tools • Dart 3.10.4 • DevTools 2.51.1
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.38.5, on macOS 15.7.2 24G325 darwin-arm64, locale en-US)
[✗] Android toolchain - develop for Android devices
    ✗ ANDROID_HOME = /Users/songwoo/Android/Sdk
      but Android SDK not found at this location.
[✓] Xcode - develop for iOS and macOS (Xcode 26.1.1)
[✓] Chrome - develop for the web
[✓] Connected device (2 available)
[✓] Network resources

! Doctor found issues in 1 category.

현재 안드로이드를 제외한 모든 부분이 설정이 완료되었다.