갈루아의 반서재

"macOS에서 Xcode와 Flutter를 설치하여 iOS 앱 개발 환경을 구축하는 방법을 알아보세요. 이 가이드에서는 Xcode 설치, Flutter SDK 설정, 환경 변수 설정 등 iOS 개발을 위한 모든 준비 단계를 상세히 설명합니다."

1. Xcode 설치

Flutter로 iOS 앱을 개발하려면 Xcode가 필요하므로, App Store를 열어 Xcode를 검색한 후 다운로드 및 설치한다.

설치 후, Xcode를 처음 실행하여 필요한 추가 컴포넌트를 설치한다.

Xcode CLI (Command Line Tools) 도 설치한다.

% xcode-select --install
xcode-select: note: install requested for command line developer tools

2. Homebrew 설치

Flutter 설치를 위해 Homebrew 패키지 관리자를 용하는 것이 편리하므로, Homebrew가 설치되어 있지 않다면 다음 명령어를 통해 설치할 수 있다.

% /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
 
==> Checking for `sudo` access (which may request your password)...
Password:
==> This script will install:
/opt/homebrew/bin/brew
/opt/homebrew/share/doc/homebrew
/opt/homebrew/share/man/man1/brew.1
/opt/homebrew/share/zsh/site-functions/_brew
/opt/homebrew/etc/bash_completion.d/brew
/opt/homebrew
 
Press RETURN/ENTER to continue or any other key to abort:
==> /usr/bin/sudo /usr/sbin/chown -R planv:admin /opt/homebrew
==> Downloading and installing Homebrew...
remote: Enumerating objects: 79922, done.
remote: Counting objects: 100% (23646/23646), done.
remote: Compressing objects: 100% (283/283), done.
remote: Total 79922 (delta 23454), reused 23490 (delta 23344), pack-reused 56276 (from 1)
remote: Enumerating objects: 55, done.
remote: Counting objects: 100% (34/34), done.
remote: Total 55 (delta 33), reused 33 (delta 33), pack-reused 21 (from 1)
==> Updating Homebrew...
==> Downloading https://ghcr.io/v2/homebrew/portable-ruby/portable-ruby/blobs/sha256:e7340e4a1d7cc0f113686e461b93114270848cb14676e9037a1a2ff3b1a0ff32
############################################################################################################ 100.0%
==> Pouring portable-ruby-3.3.5.arm64_big_sur.bottle.tar.gz
Installing from the API is now the default behaviour!
You can save space and time by running:
  brew untap homebrew/core
Updated 1 tap (homebrew/bundle).
==> Installation successful!
 
==> Homebrew has enabled anonymous aggregate formulae and cask analytics.
Read the analytics documentation (and how to opt-out) here:
  https://docs.brew.sh/Analytics
No analytics data has been sent yet (nor will any be during this install run).
 
==> Homebrew is run entirely by unpaid volunteers. Please consider donating:
  https://github.com/Homebrew/brew#donations
 
==> Next steps:
- Run brew help to get started

3. Flutter 설치 및 실행

1) sdk 다운로드

- 먼저 Flutter 공식 홈페이지에서 macOS용 Flutter SDK를 다운로드한다. 사용하고 있는 CPU 타입을 확인*하여 적절한 sdk 를 다운로드한다.

- 다운로드한 .zip 파일을 원하는 위치에 압축을 푼다. 일반적으로 /Users/your_username/flutter에 설치한다.

* 맥북 CPU 아키텍처 확인 방법: Intel 또는 Apple 실리콘 여부 쉽게 알아보는 법

2) 환경변수 설정

아래와 같이 Flutter SDK의 경로를 PATH에 추가해 준다. 

% nano ~/.zshrc

파일을 저장한 후 변경사항을 반영한다.

% source ~/.zshrc

3) Flutter 도구가 제대로 설치되었는지를 다음 명령어를 통해 확인한다.

% flutter doctor
 
┌─────────────────────────────────────────────────────────┐
│ A new version of Flutter is available!                  │
│                                                         │
│ To update to the latest version, run "flutter upgrade". │
└─────────────────────────────────────────────────────────┘
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.13.0, on macOS 13.5.1 22G90 darwin-arm64, locale
    ko-KR)
[✓] Android toolchain - develop for Android devices (Android SDK version 33.0.1)
[✓] Xcode - develop for iOS and macOS (Xcode 14.3.1)
[✓] Chrome - develop for the web
[✓] Android Studio (version 2022.3)
[✓] Connected device (2 available)
[✓] Network resources
 
• No issues found!

4) Flutter로 iOS 앱을 빌드하기 위해 CocoaPods 를 설치한다. CocoaPods는 Xcode 프로젝트에서 외부 라이브러리를 쉽게 관리할 수 있도록 도와주는 도구로, Homebrew를 이용해 다음과 같이 설치할 수 있다.

 % brew install cocoapods

5) xcode 설정

iOS 개발을 위해 다음과 같은 추가 설정이 필요하다. Xcode 를 실행하여  Settings > Locations 탭에서 명령줄 도구(Command Line Tools)가 올바르게 선택되었는지 확인한다.

프로젝트를 빌드할 때 사용하는 시뮬레이터를 Xcode에서 설치하고 설정한다. Flutter에서 iOS 시뮬레이터를 사용하려면 다음 명령어를 사용할 수 있다.

% open -a Simulator

다음과 같이 iOS 시뮬레이터가 실행됨을 확인할 수 있다.

6) Flutter 프로젝트를 생성하고 실행한다.

- Flutter 프로젝트 생성

% flutter create my_flutter_app
Creating project my_flutter_app...
Resolving dependencies in my_flutter_app... 
Got dependencies in my_flutter_app.
Wrote 129 files.
 
All done!
You can find general documentation for Flutter at: https://docs.flutter.dev/
Detailed API documentation is available at: https://api.flutter.dev/
If you prefer video documentation, consider:
https://www.youtube.com/c/flutterdev
 
In order to run your application, type:
 
  $ cd my_flutter_app
  $ flutter run
 
Your application code is in my_flutter_app/lib/main.dart.

프로젝트 디렉토리로 이동한 후 iOS 시뮬레이터에서 실행한다.

% cd my_flutter_app
my_flutter_app % flutter run
Resolving dependencies... 
  async 2.11.0 (2.12.0 available)
  boolean_selector 2.1.1 (2.1.2 available)
  characters 1.3.0 (1.3.1 available)
  clock 1.1.1 (1.1.2 available)
  collection 1.17.2 (1.19.1 available)
  fake_async 1.3.1 (1.3.2 available)
  flutter_lints 2.0.3 (5.0.0 available)
  lints 2.1.1 (5.1.0 available)
  matcher 0.12.16 (0.12.17 available)
  material_color_utilities 0.5.0 (0.12.0 available)
  meta 1.9.1 (1.16.0 available)
  path 1.8.3 (1.9.1 available)
  stack_trace 1.11.0 (1.12.0 available)
  stream_channel 2.1.1 (2.1.2 available)
  string_scanner 1.2.0 (1.4.0 available)
  test_api 0.6.0 (0.7.3 available)
  web 0.1.4-beta (1.1.0 available)
Got dependencies!
Launching lib/main.dart on iPhone 14 Pro Max in debug mode...
Running Xcode build...                                                  
 └─Compiling, linking and signing...                        17.6s
Xcode build done.                                           29.2s
[VERBOSE-2:FlutterDarwinContextMetalImpeller.mm(37)] Using the Impeller rendering backend.
Syncing files to device iPhone 14 Pro Max...                       113ms
 
Flutter run key commands.
r Hot reload. 🔥🔥🔥
R Hot restart.
h List all available interactive commands.
d Detach (terminate "flutter run" but leave application running).
c Clear the screen
q Quit (terminate the application on the device).
 
A Dart VM Service on iPhone 14 Pro Max is available at:
http://127.0.0.1:51063/jmYv9TXKYpE=/
The Flutter DevTools debugger and profiler on iPhone 14 Pro Max is available at:
http://127.0.0.1:9100?uri=http://127.0.0.1:51063/jmYv9TXKYpE=/

Xcode 시뮬레이터가 실행되며 Flutter 앱이 실행되는 것을 볼 수 있다.