※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つです。
- Xcodeで、プロジェクトの設定(表示名・バンドルID・署名のチーム・対応するiOSの下限)を確かめる
pubspec.yamlのversionで、バージョンとビルド番号を決めるflutter build ipaを打つ- できた.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の入ったパソコンで進める前提になっています。そのうえで、次のものが先に要ります。
- Apple Developer Programに入っていること(Appleの開発者の登録)
- バンドルIDの登録(Apple Developerのサイトの、App IDのページ)
- 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 の Identity | Display Name | ホーム画面に出るアプリの名前 |
| General の Identity | Bundle Identifier | App Store Connectに登録したバンドルIDと同じか |
| Signing & Capabilities | Automatically manage signing | 既定でオン。公式ドキュメントでは、たいていのアプリはこのままで足りる、とされています |
| Signing & Capabilities | Team | 自分のApple Developerのアカウントのチームを選ぶ。出てこなければ「Add Account…」から足す |
| Build Settings の Deployment | iOS 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+1Flutterの公式ドキュメントでは、+ より前がバージョン(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=7Xcodeの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 ipaFlutterの公式ドキュメントでは、このコマンドで、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から入れます。
- Transporterを開き、App Store Connectのアカウントでサインインする
build/ios/ipa/の中の.ipaを、Transporterの画面にドラッグ&ドロップする- 画面の案内に沿って、検証とアップロード(配信)を進める
Mac App Storeの説明では、検証のときの警告・エラー・配信のログや、過去の配信の履歴も見られる、とされています。うまくいかなかったときに、どこで止まったかを読み返せるのが助かるところです。
B. Xcodeで上げる(.xcarchiveを使う)
Xcodeで上げるときは、flutter build ipa が作ったアーカイブを開きます。
open build/ios/archive/Runner.xcarchive(ファイル名は、手順3で出たものに合わせてください)
開くと、Xcodeの「Organizer」の「Archives」に、そのアーカイブが出てきます。
「Validate App と Distribute App、どっちを先に押したらええねん?」となりますよね。順番は、こうです。
- Validate App を押す。Appleのドキュメントでは、TestFlightやApp Storeに出す前に、簡単な自動の検証をしてくれる、とされています
- 問題が出たら、直してからもう一度
flutter build ipaで作り直す。Flutterの公式ドキュメントでは、アップロードするまでは、同じビルド番号を使い回してよい、とされています - 問題がなければ Distribute App を押す
- 出し方の一覧から 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_idyour_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つ並べます。
- App Store Connectにアプリを作る前に上げた
ビルドは、アプリを登録したあとに上げます。先に「新規アプリ」を作ります。
- ビルド番号が前と同じ
pubspec.yaml の + の後ろを増やしてから、flutter build ipa で作り直します。
- XcodeのBundle Identifierと、App Store ConnectのバンドルIDが違う
flutter build ipa の「App Settings Validation」のBundle Identifierを見て、App Store Connectのアプリと同じかを確かめます。
- Runner.xcodeprojの方を開いて設定した
設定は、.xcworkspace のほうを開いて見直します(手順1)。
- Distribute AppでTestFlight Internal Onlyを選んだ
審査に出すなら、TestFlight & App Storeを選んで上げ直します。
- 古い記事の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の処理が終わるとメールが届き、そこから審査に出すビルドを選べる
ビルドエラー解決・動作確認・申請代行まで、現役開発者が対応します。











