SiiD BLOG ロゴ

[Flutter]iOSのビルドで失敗したらまず試すこと10選

[Flutter]iOSのビルドで失敗したらまず試すこと10選

この記事を書いた人

SiiD BLOG編集部

SiiD BLOG編集部

SiiD BLOG編集部にて、皆さんの学習やキャリアに役立つ記事を発信します! 普段は受講生の皆さん向けに、学習やキャリアの相談にのったりもしています。

ビルドがよくコケて詰まるので、備忘録に。。。
ざっくりいうと、(Flutterアプリに限ったことではないけど)大抵は再インストールする・削除する・再起動するで解決できることが多そうです。

1.原因を特定

flutter doctor -v
開発環境にどこかしら不具合があれば検知してくれる。エラーが引っかかったらそのメッセージに従おう。
困ったらとりあえずまず初めに実行するコマンド。

2.キャッシュのクリア

flutter clean
キャッシュをクリアする。
不具合かと思いきや単にキャッシュのせいの場合も多々あるので、何かしら変更点を加えたらクリアしてみるのが◯。

3.xcodeでビルド

VS CodeなどのIDEを使っていてビルドに失敗した場合、Xcodeでのビルドを試してみるとワンチャンうまくいくかもしれない。

4.Xcode, Simulatorの再起動

Xcode, Simulatorを一度閉じて、再起動してからトライ。
Stackoverflow見てると、これだけで解決することも多々ある様子。

5.パッケージの再インストール

パッケージが足りなかったり、古くてバージョンが合わなかったりでエラーの場合もある。
その場合は下記のコマンドたちを試してみる

5.1.flutter pub get

pubspec.yaml にあるパッケージを全てインストール

5.2.flutter pub remove {package名}

パッケージを個々に指定して削除

5.3.flutter pub add {package名}

パッケージを個々に指定してインストール

5.4.flutter pub upgrade

pubspec.yaml にあるパッケージを全てインストール。
flutter pub get と違って pubspec.yaml のみ参照し、 pubspec.lock で指定されているバージョンは無視するので注意。

6.Flutter自体のアップグレード

flutter upgrade
flutterのバージョンが古いならアップグレードしよう。

7.cocoapodsのアップグレート

cocoapodsのバージョンが古くてビルドに失敗するケースもある。
rubyでインストールしてる人は gem update cocoapods
homebrewでインストールしてる人は brew upgrade cocoapods

8.iosフォルダごと一度消してみる

/ios フォルダをまるごと削除し、 flutter create -i swift . で再製性。
これをやるとき、もちろんバックアップは忘れずに。

9.iOSのサポートバージョンを上げる

project.pbxproj ファイル内にある IPHONEOS_DEPLOYMENT_TARGET のバージョン値を変えてみる。
2022/5の時点では 9.0 がよい。それ未満になっていたら変更する。

10.実機のiPhoneでビルドがうまくいかなかったら...

これもよくあるのですが、下記を全部試すといずれかでビルドできるようになることがある。

  • iPhoneのOSを最新版にアップデートする
  • MacのOSを最新版にアップデートする
  • Xcodeを最新版にアップデートする(※先にMacのOSがアップデートされている必要アリ)
  • iPhoneとMacを繋ぎ直す
  • iPhoneとMacを再起動する

iOSビルドの失敗は、Xcodeや証明書など複数の要因が絡むため、切り分けの経験がないと原因を判断しづらい領域です。詰まったときに聞ける相手がいる学び方という選択肢もあります。

AIプログラミングスクール「SiiD」について

AIプログラミングスクール「SiiD」は、未経験からITエンジニア転職を目指す方向けのオンラインスクールです。

SiiDの特徴

  • 現役エンジニアでYouTube登録者約13万人の「セイト先生」が代表兼主任講師
  • 採用側の実務知見(2,000人以上の選考・150名以上のエンジニア採用)にもとづく指導
  • 生成AIを取り入れた学習設計と、実務レベルのフルスタックWeb開発スキル
  • Workship CAREER(株式会社GIG)と連携した無料の転職伴走支援
  • 経済産業省認定のReスキル講座で、給付金の条件を満たせば実質105,600円〜
  • 学割あり(35%オフ)

こんな方におすすめ

  • 未経験・文系・社会人からITエンジニア転職を本気で目指したい方
  • 独学に限界を感じている方
  • 費用を抑えながら実務スキルと転職サポートを両立したい方

「未経験だから」とあきらめる必要はありません。採用する側を知り尽くしたプロが、給付金で負担を抑えながら内定まで伴走します。

シェアする

未経験からのエンジニア転職を本気で目指すなら「SiiD」

SiiDはYouTube 13万人のセイト先生が主任講師のAIプログラミングスクール。元人事部長&現役エンジニアによる徹底指導で、生涯年収を大きくアップさせませんか?

SiiDの詳細を見る