Flutter は「ひとつのコードで Android と iOS の両方が動く！」という魅力的なフレームワーク。
でも、実際に iOS でサンプルコードを動かすまでに一日費やすほど苦労した…。
今回は、環境構築でハマったポイントを記録しておく。

0. 私の動作環境

PC: Macbook Air M3
Android Studio: Ladybug Feature Drop | 2024.2.2
iOS Version: 18.3.1
iPhone Model:iPhone 12

1. Flutter SDK がないと Android Studio に怒られる

Android Studio を開いて Flutter プロジェクトを作ろうとしたら、「Flutter SDK が見つかりません」 というエラーが。
どうやら Android Studio が勝手に入れてくれるわけではなく、Flutter の公式ページから直接自分でダウンロード しないといけないらしい。

🔗 Flutter – Install

その後、 Android Studio に戻り、SDK がある場所を PATH として指定した。

しかし、ここで新たな問題発生🔥

2.Flutter SDK PATH を通そうとしたら macOS のセキュリティポップアップに邪魔される

Dart を開こうとしたら、"dart" can't be opened because Apple cannot check it for malicious software. というポップアップが出てブロックされる。

✅ 対処法

Mac の「システム設定」
「セキュリティとプライバシー」
下のほうまでスクロールし、 "dart" was blocked from use because it is not from an identified developer.という文章の横に Allow Anyway というボタンがあるのでクリックする

参考サイト: https://memorytin.com/2020/11/17/macos-big-sur-flutter-error-dart-cant-be-opened-because-apple-cannot-check-it-for-malicious-software/

こうしてポップアップブロックを突破した。

3. Developer Mode を ON にしても iOS で動作確認できない

Flutter SDK の PATH を指定すると、サンプルコードが Android 端末上で動いたため、いよいよ iOS で動かそうと Macbook にケーブルをさした。

しかし、

「To use your iPhone for development, turn on developer mode.」

とターミナルから文言が出てくるだけでうんともすんとも言わない。

念のため、iPhone の Developer Mode を ON にし直し再起動した。

なのに、永遠にこの状態から抜け出せない…。

✅ ほかに試したこと

iPhone の再起動 → 🙅
Lightning ケーブルを差し直す → 🙅
Xcode の設定を見直す → 🙅
Android Studio の再起動 → 🙅
flutter doctor を確認 → CocoaPods がないせいだった！！

というわけで cocoaPods を入れる作業に取り掛かる！

4. Ruby をインストールしないといけなかった

cocoaPods を入れるためには ruby の環境回りも整える必要があった

brew install rbenv
echo 'eval "$(rbenv init - bash)"' >> ~/.zshrc
source ~/.zshrc
rbenv install 3.2.2
rbenv global 3.2.2
ruby -v  # バージョン確認

ruby のバージョンが表示されたら、いよいよ cocoaPods のインストールに入る。

5. RubyGems のアップデートが必要だった

CocoaPodsのインストールには ruby だけでなく、RubyGems も必要のようである。
なので、以下のコマンドでアップデート。

gem update --system

6. `brew` コマンドが効かない問題

Homebrew がそもそも入ってない、または認識されないときの対処法。

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

7. CocoaPods をインストール

CocoaPods をインストールして、Flutter プロジェクトに適用する。

gem install cocoapods
pod setup

さらに、プロジェクトの ios フォルダに移動して pod install を実行。

cd (flutter_projectがあるディレクトリ)/ios
pod install

8. 結局 Xcode が必要だった

Flutter を使えば XCode なしで iOS アプリを作れると思っていたけど、結局ないと iOS ビルドができなかった。

ビルドできないと思ったら XCode がPCに入っているかどうか今一度確かめてみよう。

9. `No Podfile found in the project directory.` エラー

CocoaPods の設定をしようとしたら、「No Podfile found in the project directory.」 と怒られる。
これは、flutter のプロジェクトがあるディレクトリ内部にある ios ディレクトリの中で pod init を実行すれば解決。

cd (flutter_projectがあるディレクトリ)/ios
pod init

10. `PodFile` の iOS バージョンを変更

PodFile で設定されている iOS バージョンが古すぎるとビルドエラーが出るので修正を加える。

open Podfile

エディタで platform :ios, '13.0' に変更して、保存（Ctrl + X → Y → Enter）。

これで PodFile はOK！

11. `source ~/.zshrc` が効かなくなる問題

zsh の設定を反映しようとして source ~/.zshrc を実行したらエラー発生。

nano ~/.zshrc

このコマンドで zshrcを開き、 eval "$(rbenv init - zsh)" が正しく書かれているか確認したら直った。

12. `flutter doctor` で環境チェック

環境に問題がないか確認するために flutter doctor を実行。

flutter doctor

先ほどまであった CocoaPods not installed エラーがなくなっている🙌

13. `flutter run` で実機デバッグ

すべての設定が完了したら、iPhone を接続した状態で flutter run を実行！

flutter run

これでようやくサンプルコードが iPhone でも動いた✅

おまけ. iOS 上では Debug モードアプリは IDE から起動しないと使えない

Android は通常のアプリと同様に、アイコンをタップして直接開いてアプリを実行できるけど、 iOS はターミナルから flutter run するか Android Studio で実行しないとアプリが起動しない。

こうしたところに、 iOS のセキュリティ面での厳しさを実感した。

環境構築だけで 1 日終わった

Flutter SDK インストールから始まり、 Ruby, cocoaPods のインストールなどに追われた。

さらには、 Flutter のプロジェクトに cocoaPods を適用するために PodFile を作る必要があったりとターミナルで永遠とコマンドを叩いていた。

大学の卒業研究で Linux を使っていた関係でターミナルをたくさん使っていた時のことを思い出した。

とにかく、これらの作業だけで 丸 1 日消えてしまった…。
でも、ひとつのコードで Android と iOS の両方が動いたときは感動 した！

これから頑張るぞ！💪