FlutterでiOSのリリースビルドを作る手順|flutter build ipaからArchive・アップロードまで

このページには広告が含まれる場合があります。

 

※2026年11月14日に、Flutter・Appleの公式ドキュメントで確かめた内容です(Flutterの公式ドキュメントは、この時点でFlutter 3.50を前提に書かれています)。コマンドの出力やXcodeの画面は、FlutterやXcodeのバージョン、環境によって異なります。

「flutter run では動くのに、App Storeに出す版の作り方がわからない」

「Archiveって何? ipaって何? Transporterって、Xcodeとは別のもの?」

デバッグでは動いているのに、App Storeに出す一歩手前で、急に知らない言葉が増えて戸惑う。iOSでは、そういう場面がよくあります。

先に答えを書くと、FlutterでiOSのリリースビルドを作ってApp Store Connectに上げる手順は、次の4つです。

  1. Xcodeで、プロジェクトの設定(表示名・バンドルID・署名のチーム・対応するiOSの下限)を確かめる
  2. pubspec.yaml の version で、バージョンとビルド番号を決める
  3. flutter build ipa を打つ
  4. できた.ipaを Transporter で上げる。または、できたアーカイブ(.xcarchive)をXcodeで開き、Validate App → Distribute App で上げる

flutter build ipa を打つと、プロジェクトの一番上の build フォルダの中に、次の2つができます。

  • build/ios/archive/ の中に、Xcodeのアーカイブ(.xcarchive。ひな形のままなら Runner.xcarchive)
  • build/ios/ipa/ の中に、App Storeに出すための.ipa

つまり、「Archive」は、Xcodeのメニューを手でたどらなくても、flutter build ipa が作ってくれるんです。

開発をすべてFlutterでやっているぼくの自社アプリは、6タイトル。Android版とiOS版を合わせると12本が、それぞれのストアに並んでいます。

では、4つの手順を、FlutterとAppleの公式ドキュメントで確かめながら1つずつ進めます。

 

1. 始める前に、そろっているか確かめること

Flutterの公式ドキュメントでは、iOSのリリースにはXcodeが要り、macOSの入ったパソコンで進める前提になっています。そのうえで、次のものが先に要ります。

  1. Apple Developer Programに入っていること(Appleの開発者の登録)
  2. バンドルIDの登録(Apple Developerのサイトの、App IDのページ)
  3. App Store Connectでのアプリの登録(「新規アプリ」で作り、2で登録したバンドルIDを選ぶ)

App Store Connectのヘルプでも、ビルドは、アカウントにアプリを追加したあとにアップロードする、と書かれています。順番が逆だと、上げたビルドの行き先がありません。

(App Store Connectでのアプリの登録から審査への提出までは、こちらの記事でも書いていますので、よろしければご覧ください)

Xcodeのバージョンも見ておく

2026年11月14日に確かめたApp Store Connectのヘルプの表では、iOSアプリはXcode 26以降でビルドしたものがサポートされる、と書かれています。しばらくXcodeを更新していなかったなら、ビルドの前に一度確かめておくと、上げてから弾かれずに済みます。

参考:Build and release an iOS app(Flutter docs、2026年11月14日確認)/ビルドのアップロード(App Store Connectヘルプ、2026年11月14日確認)

 

2. 手順1:Xcodeでプロジェクトの設定を確かめる

Xcodeで開くのは、Flutterのプロジェクトの ios フォルダの中にある Runner.xcworkspace です。ターミナルなら、プロジェクトのフォルダで次のように打つと開きます(Flutterの公式ドキュメントのコマンドです)。

open ios/Runner.xcworkspace

似た名前の Runner.xcodeproj ではなく、.xcworkspace のほうです。左のナビゲーターで「Runner」を選び、「TARGETS」の「Runner」を選ぶと、設定の画面になります。

Flutterの公式ドキュメントで「確かめておくもの」として挙げられているのは、次の5つです。

タブ・場所項目何を確かめるか
General の IdentityDisplay Nameホーム画面に出るアプリの名前
General の IdentityBundle IdentifierApp Store Connectに登録したバンドルIDと同じか
Signing & CapabilitiesAutomatically manage signing既定でオン。公式ドキュメントでは、たいていのアプリはこのままで足りる、とされています
Signing & CapabilitiesTeam自分のApple Developerのアカウントのチームを選ぶ。出てこなければ「Add Account…」から足す
Build Settings の DeploymentiOS Deployment Target対応するiOSの下限。Flutterが対応しているのはiOS 13以降で、使うプラグインがもっと新しいiOSの機能を使うなら、それに合わせて上げる

もう1つ、アプリのアイコンも、Xcodeの Runner フォルダの中の Assets.xcassets で、ひな形のアイコンから自分のものに差し替えておきます。

バンドルIDが「com.example」のままになっていないか

Flutterで作ったばかりのプロジェクトは、バンドルIDが com.example.〜 になっています。

flutter build ipa は、ビルドのあとに設定を見て、com.example のままのときや、アイコンがひな形のままのときに、注意の文を出します(FlutterのGitHubにある、flutter build ipa のコマンドの中身で確かめました)。出てきたら、App Store Connectに登録したバンドルIDに直してから、作り直します。

参考:Build and release an iOS app(Flutter docs、2026年11月14日確認)/build_ios.dart(Flutter の GitHub、2026年11月14日確認)

 

3. 手順2:バージョンとビルド番号を決める

番号を書く所は、Xcodeではなく、プロジェクトの一番上にある pubspec.yaml の1行です。

version: 1.0.0+1

Flutterの公式ドキュメントでは、+ より前がバージョン(iOSの CFBundleShortVersionString。ストアでユーザーに見える番号)、+ より後ろがビルド番号(CFBundleVersion)になる、とされています。

ビルド番号は、アップロードのたびに違うものが要ります。 2回目の提出からは、+ の後ろの数を増やしてからビルドします。

pubspec.yaml を書き換えずに、その回だけ番号を変えたいときは、flutter build ipa に --build-name(バージョン)と --build-number(ビルド番号)を付けて打ちます。たとえば「1.2.0の、ビルド番号7」なら、こうです。

flutter build ipa --build-name=1.2.0 --build-number=7

XcodeのGeneralのIdentityにある「Version」「Build」でも上書きできますが、pubspec.yaml と2か所で番号を持つと、どちらが本当の番号かわからなくなりがちです。ふだんは pubspec.yaml か、コマンドのどちらかに決めておくと迷いません。

参考:Build and release an iOS app(Flutter docs、2026年11月14日確認)

 

4. 手順3:flutter build ipa でアーカイブと.ipaを作る

いよいよビルドです。ターミナルでFlutterのプロジェクトのフォルダに移り、打つのはこの1行です。

flutter build ipa

Flutterの公式ドキュメントでは、このコマンドで、build/ios/archive/ にXcodeのアーカイブ(.xcarchive)が、build/ios/ipa にApp Store向けの.ipaができる、とされています。

FlutterのGitHubにあるコマンドの中身を見ると、アーカイブのファイル名は、Xcodeのプロダクト名(ひな形のままなら Runner)に .xcarchive を付けたものです。終わると「Built IPA to 〜」と、.ipaを置いた場所が出ます。

出力の「App Settings Validation」を読む

flutter build ipa は、アーカイブを作ったあとに、次の項目を一覧で出します(同じくコマンドの中身で確かめました)。

  • Version Number
  • Build Number
  • Display Name
  • Deployment Target
  • Bundle Identifier

ここで、番号やバンドルIDが思っていたものと違ったら、上げる前に気づけます。上げてから「番号が違った」と気づくより、ここで1回、目を通す方がずっと楽です。

付けておくと役に立つオプション

  • --obfuscate --split-debug-info=<フォルダ>:Dartのコードを読み解かれにくくする。公式ドキュメントで、付けることを考えてみて、と紹介されています
  • --export-method:App Store以外に配るときの出し方。何も付けなければApp Store向けで、ほかに ad-hoc・development・enterprise が選べます

ビルドの途中でエラーで止まったら

署名のチームを選んでいないと、Xcodeの署名のエラーで止まります。手順1の「Team」をもう一度見ます。

パッケージを足したあとに、pod install まわりのエラーで止まることもあります。

(CocoaPodsのエラーの見分け方は、こちらの記事でも書いていますので、よろしければご覧ください)

参考:Build and release an iOS app(Flutter docs、2026年11月14日確認)/build_ios.dart・application_package.dart(いずれもFlutter の GitHub、2026年11月14日確認)

 

5. 手順4:App Store Connectにアップロードする

上げ方は3通りあり、Flutterの公式ドキュメントにも3つとも載っています。初めてなら、AかBのどちらかで十分です。

A. Transporterで上げる(.ipaを使う)

Transporterは、Appleが出しているMacのアプリです。Mac App Storeから入れます。

  1. Transporterを開き、App Store Connectのアカウントでサインインする
  2. build/ios/ipa/ の中の.ipaを、Transporterの画面にドラッグ&ドロップする
  3. 画面の案内に沿って、検証とアップロード(配信)を進める

Mac App Storeの説明では、検証のときの警告・エラー・配信のログや、過去の配信の履歴も見られる、とされています。うまくいかなかったときに、どこで止まったかを読み返せるのが助かるところです。

B. Xcodeで上げる(.xcarchiveを使う)

Xcodeで上げるときは、flutter build ipa が作ったアーカイブを開きます。

open build/ios/archive/Runner.xcarchive

(ファイル名は、手順3で出たものに合わせてください)

開くと、Xcodeの「Organizer」の「Archives」に、そのアーカイブが出てきます。

「Validate App と Distribute App、どっちを先に押したらええねん?」となりますよね。順番は、こうです。

  1. Validate App を押す。Appleのドキュメントでは、TestFlightやApp Storeに出す前に、簡単な自動の検証をしてくれる、とされています
  2. 問題が出たら、直してからもう一度 flutter build ipa で作り直す。Flutterの公式ドキュメントでは、アップロードするまでは、同じビルド番号を使い回してよい、とされています
  3. 問題がなければ Distribute App を押す
  4. 出し方の一覧から TestFlight & App Store を選び、「Distribute」を押す

4で TestFlight Internal Only を選ぶと、TestFlightの内部テストでしか使えないビルドになり、審査には出せません。App Storeに出すつもりなら、TestFlight & App Storeの方を選びます。

Distribute Appの最後で、上げずに書き出す(Export)こともできます。Flutterの公式ドキュメントでは、そのときにできる ExportOptions.plist を使って、次からはXcodeを開かずに同じ設定で.ipaを作れる、とされています。

flutter build ipa --export-options-plist=path/to/ExportOptions.plist

なお、Appleのドキュメントでは、Xcodeのメニューの Product > Archive でアーカイブを作る方法が案内されています。ただ、Flutterの公式ドキュメントが案内しているのは、flutter build ipa で作ったアーカイブをXcodeで開く流れなので、この記事もその順にしました。

C. コマンドラインで上げる(altool)

App Store ConnectのAPIキーを作ってあるなら、ターミナルからも上げられます。Flutterの公式ドキュメントに載っているコマンドは、こうです。

xcrun altool --upload-app --type ios -f build/ios/ipa/*.ipa --apiKey your_api_key --apiIssuer your_issuer_id

your_api_key と your_issuer_id は、自分のキーのものに置き換えます。認証のくわしいことは、man altool で見られます。

「Application Loader」は、もうない

古い記事には、Application Loaderで上げる手順が出てくることがあります。Xcode 11のリリースノートで、Application LoaderはXcodeに含まれなくなった、とされています。今は、上のA〜Cのどれかを使います。

参考:Build and release an iOS app(Flutter docs、2026年11月14日確認)/ビルドのアップロード(App Store Connectヘルプ、2026年11月14日確認)/Distributing your app for beta testing and releases・Xcode 11 Release Notes(いずれもApple Developer Documentation、2026年11月14日確認)/Transporter(Mac App Store、2026年11月14日確認)

 

6. アップロードしたあと

上げ終わっても、すぐにApp Store Connectで選べるわけではありません。App Store Connectのヘルプでは、Appleのシステムでの処理が終わってから表示され、終わるとメールが届く、とされています。Flutterの公式ドキュメントでは、30分以内にメールが届くはず、と書かれています。

処理が終わったら、App Store Connectのバージョンのページでビルドを選び、審査に出します。

上げたのに、いつまでも出てこないときに確かめる順番は、こちらにまとめています。

ビルドの横に「コンプライアンスがありません」と出たら、暗号化についての質問に答える必要があります。

(輸出コンプライアンスの質問の考え方は、こちらの記事でも書いていますので、よろしければご覧ください)

 

7. よくあるつまずき

iOSのリリースビルドで、止まりやすい所を6つ並べます。

  1. App Store Connectにアプリを作る前に上げた

ビルドは、アプリを登録したあとに上げます。先に「新規アプリ」を作ります。

  1. ビルド番号が前と同じ

pubspec.yaml の + の後ろを増やしてから、flutter build ipa で作り直します。

  1. XcodeのBundle Identifierと、App Store ConnectのバンドルIDが違う

flutter build ipa の「App Settings Validation」のBundle Identifierを見て、App Store Connectのアプリと同じかを確かめます。

  1. Runner.xcodeprojの方を開いて設定した

設定は、.xcworkspace のほうを開いて見直します(手順1)。

  1. Distribute AppでTestFlight Internal Onlyを選んだ

審査に出すなら、TestFlight & App Storeを選んで上げ直します。

  1. 古い記事のApplication Loaderを探している

今のXcodeには入っていません。TransporterかXcodeのDistribute Appで上げます。

参考:Build and release an iOS app(Flutter docs、2026年11月14日確認)/ビルドのアップロード(App Store Connectヘルプ、2026年11月14日確認)

 

8. アップロードをAIに任せる時代でも、手順を知っておく

正直に言うと、ぼく自身は今、自分のアプリの管理を、Claude CodeというAIの道具に任せています。

前は、時間のかかるリリース作業にてんてこ舞いになっていました。それが今は、コーディングも、ストアへのアップロードも、AIがやってくれる。ぼくが手を動かしたのは、鍵づくり・ファイル名の直し・質問への答え・審査に出すボタンぐらいでした。「これまでの苦労は一体何やったんや!?」と思ったくらいです。

ただ、AIに任せるにしても、最初の設定(AIの道具とストアやプロジェクトとの結び付け)は人がやりますし、最後の実機での動作確認も残ります。

そして、AIが「今どの段で止まっているか」を言ってきたときに、それが署名の話なのか、番号の話なのか、アップロードの話なのかがわからないと、次の一手を一緒に決められません。手で打つにしても、AIに任せるにしても、この記事の4つの段を頭に入れておくと、止まった場所がすぐわかります。

(てんてこ舞いの日が続いて、気持ちが張りつめている方には、ぼくの自社アプリの1つ、瞑想アプリの Meiso もあります)

 

App Storeへのリリースで手が止まっている方へ

ぼくは、App Store Connectへの申請で手が止まっている方と、Zoomの画面共有で同じ画面を見ながら、リリースまでを一緒に進めるお手伝いをしています。リジェクトされたときの原因の見方や、再申請のご相談も受けています。よろしければ、お気軽にご相談ください。

 

まとめ

参考:Build and release an iOS app(Flutter docs、2026年11月14日確認)/ビルドのアップロード(App Store Connectヘルプ、2026年11月14日確認)/Distributing your app for beta testing and releases(Apple Developer Documentation、2026年11月14日確認)

何かのお役に立てれば幸いです。

  • FlutterでiOSのリリースビルドを作って上げる手順は、①Xcodeで設定を確かめる ②pubspec.yaml で番号を決める ③flutter build ipa ④TransporterかXcodeで上げる、の4つ
  • 先に、Apple Developer Programへの登録・バンドルIDの登録・App Store Connectでのアプリの登録を済ませておく
  • iOSアプリは、Xcode 26以降でビルドしたものがサポートされる(2026年11月14日確認)
  • Xcodeは ios/Runner.xcworkspace を開き、Display Name・Bundle Identifier・Team・iOS Deployment Target(iOS 13以降)を確かめる
  • version: 1.0.0+1 の + の前がバージョン、後ろがビルド番号。上げるたびに、後ろの数を増やす
  • flutter build ipa で、build/ios/archive/ にアーカイブ(.xcarchive)、build/ios/ipa に.ipaができる。出力の「App Settings Validation」で番号とバンドルIDを確かめる
  • Xcodeで上げるときは、Validate App → Distribute App → TestFlight & App Store の順。内部テスト専用の出し方を選ぶと、そのビルドは審査に使えない
  • Application Loaderは、Xcode 11からXcodeに含まれていない
  • 上げたあとは、Appleの処理が終わるとメールが届き、そこから審査に出すビルドを選べる

アプリのリリースでお困りですか?
Google Play・App Storeへのリリース支援サービスをご用意しています。
ビルドエラー解決・動作確認・申請代行まで、現役開発者が対応します。

みんプロ式・アプリ開発支援サービス一覧を見る ↗

こんな記事も読まれています

人気No.1

前向きな気持ちになれる 占星術・タロットリーディング

あすコロ式・相談サロン 【ナビるやん】

人に言えない悩みから使命・運勢診断まで、あなたに寄り添いながら“ナビゲート”する、あすコロ人気No.1のオンライン相談サロン。占星術・心理学・タロットの叡智を活かし、普段認識していない「潜在意識」にアクセスしてあなたの気づいていない可能性を拓かせ、明日から前向きに歩めるようになる60分のリーディングセッション。

今すぐ詳細を見る(メルマガ登録で初回半額) ▶

TOP