Deliver (Fastlane) — その概要、App Storeへのアップロード、iOS・Android開発における設定

Deliver (Fastlane)とは？

Deliver (Fastlane)は、Fastlaneエコシステムのコンポーネントであり、App Storeへのモバイルアプリ公開プロセスを自動化します。バイナリファイルのアップロード、メタデータの更新（名前、説明、キーワード）、スクリーンショットのアップロード、すべてのローカライズ言語の価格設定を管理します。

Deliverがない場合、各リリースではApp Store ConnectのWebインターフェースを介して手動で情報を更新する必要があります。複数言語での説明文の入力、各画面サイズのスクリーンショットのアップロード、キーワードの更新、価格設定などです。App Store公開はiOSアプリライフサイクルの最終段階であり、バイナリファイルの検証、コンテンツの審査、アプリの本番公開を含みます。

App Store Connectドキュメント（2025）によると、定期的に更新されるアプリは再インストール率が30%向上し、検索結果でのランキングも向上します。Deliverを使用すると、チームは公開のルーチン作業を自動化し、数十言語にわたるメタデータ入力時の人為的ミスのリスクを低減することで、毎週のアップデート公開が可能になります。

App Storeで公開されるあらゆるアプリにDeliverを使用してください。特に、32言語の手動更新に数時間かかる多言語ローカライズプロジェクトで価値を発揮します。

DeliverがApp Store Connectと連携する仕組み

Deliverの動作メカニズムは2段階のプロセスに基づいています。第1段階では、ツールがメタデータを準備します — Deliverfile構造の検証、スクリーンショットの読み込み、変更マニフェストの生成を行います。第2段階では、DeliverがApp Store Connect APIにデータを送信し、バイナリファイルをアップロードして、Apple側でのビルド検証プロセスを開始します。

Deliverはすべての操作にApp Store Connect APIを使用し、Appleの最新要件との互換性を確保し、プライベートインターフェースの使用を排除します。App Store Connect APIは、ビルドのアップロード、メタデータ管理、レビューステータスの追跡など、アプリ操作を自動化するためのApple公式REST APIです。

バイナリファイルのアップロード

DeliverはFastlaneを介してGymと直接統合します。IPAビルド後、DeliverはそれをApp Store Connectにアップロードし、処理を開始します。--ipaパラメータでバイナリファイルのパスを指定します。指定しない場合、DeliverはGymfileで指定された、または以前のFastlaneステップで渡されたビルドディレクトリから最新のIPAを自動的に検出します。

アップロード後、DeliverはApple側のバイナリ処理の完了を待機します — Pilotと同様に、ステータスはプログレスバーで追跡されます。利用可能なステータス：Processing、Waiting For Review、In Review、Ready For Sale、Rejected。DeliverはFastfileのコールバックを介して、ステータス変更をチームに通知します。

アプリメタデータの管理

Deliverはアプリメタデータの完全なセットを管理します：名前、説明（短い説明と完全な説明）、キーワード、サポートURLとマーケティングURL、カテゴリ、年齢制限。アプリメタデータは、App Storeページに表示され、検索インデックス作成やASO最適化に使用されるアプリに関するテキスト情報です。

--submit_for_reviewパラメータは、メタデータアップロード後すぐにアプリを審査に提出します。これは完全自動リリースのための重要なパラメータです。これがない場合、Deliverはデータをアップロードするだけで、アプリをレビューに提出しません — 実際の提出前にすべてのフィールドを事前確認するのに便利です。

スクリーンショットの操作

Deliverは指定されたディレクトリから、すべてのデバイスと言語の組み合わせに対して自動的にスクリーンショットをアップロードします。ファイル名はパターンに従う必要があります：最初のスロットの6.5インチiPhoneの場合はiPhone_6.5_01.png。Deliverはスクリーンショットのサイズを判別し、各デバイスタイプのApple要件に適合させます。

スクリーンショットは正しい順序で、各ローカライズ言語ごとに個別にアップロードされます。言語のスクリーンショットが見つからない場合、Deliverは英語版をフォールバックとして使用します。スクリーンショットのローカライズは、さまざまな国のApp Storeで良好なランキングを獲得したいアプリにとって必須の要件です。Appleは検索結果でローカルコンテンツを考慮するためです。

# App Storeへの基本アップロードコマンド
fastlane deliver

# メタデータとスクリーンショットを指定したアップロード
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# アップロードなしのプレビュー
fastlane deliver --preview

DeliverfileによるDeliverの設定

Deliverfileは、構造化されたRuby形式でアプリのメタデータを保存するためのFastlane設定ファイルです。App Store Connectで手動でフォームに入力するのとは異なり、Deliverfileを使用すると、メタデータをGitでバージョン管理し、公開前にコードレビューを通じて変更を検証できます。

# Deliverfile — アプリメタデータ
app_identifier("com.company.app")
title("MyApp")
description("ストア向けアプリ説明")
keywords("モバイル, アプリ, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# メタデータのローカライズ言語
languages(["en-US", "ru", "de"])

languagesパラメータは、メタデータをアップロードする言語を決定します。fastlane/metadataフォルダ内に各言語用の個別ディレクトリを作成し、対応する説明、キーワード、マーケティングテキストファイルを配置する必要があります。Deliverは最大32のApp Store言語を同時にサポートします。

スクリーンショットのアップロードには、Fastlaneフォルダ内のscreenshotsディレクトリを使用します。フォルダ構造：screenshots/[Language]/[DeviceType]_[ScreenSize]_[Number].png。Deliverは指定された言語とデバイスのスクリーンショットを自動的にアップロードし、サイズをAppleの要件に適合させます。スクリーンショットの生成にはSnapshotの使用を推奨します — その出力形式はDeliverと互換性があります。

価格グループはprice_tierパラメータで設定し、0〜87の価格レベル番号を受け入れます。Appleの価格レベルは、アプリが利用可能なすべての国の通貨に自動的に変換されます。Deliverはリリースの一部として価格を変更でき、一時的なプロモーションやアプリのビジネスモデル変更に便利です。

アプリ公開のためのDeliverコマンド

Deliverインターフェースには、メタデータ、バイナリファイル、スクリーンショット、完全リリースのアップロードコマンドが含まれています。パラメータなしのメインコマンドfastlane deliverは、完全な公開サイクルのためにDeliverfileとメタデータディレクトリのデータを使用します。

fastlane deliver --previewコマンドは、実際にApp Store Connectにアップロードせずにメタデータの事前検証を実行します。アップロードには--forceが必要です — これがない場合、Deliverはプレビューモードで動作します。--skip_binaryパラメータはバイナリファイルのアップロードをスキップし、メタデータとスクリーンショットのみをアップロードします — 新しいリリースなしでASOフィールドを迅速に更新するのに便利です。

# バイナリアップロードを含む完全リリース
fastlane deliver --force --ipa "build/App.ipa"

# バイナリなしでメタデータのみアップロード
fastlane deliver --force --skip_binary

# スクリーンショットのみ更新
fastlane deliver --force --skip_metadata

--skip_metadataパラメータは既存のメタデータを変更せずに、スクリーンショットとバイナリファイルのみをアップロードします。これは、説明やASOフィールドを変更せずに修正を迅速に公開する必要があるホットフィックスリリースに便利です。フラグの組み合わせにより、各公開段階を個別に柔軟に管理できます。

リリースパイプラインへのDeliverの統合

リリースパイプラインとDeliverは、コミットからApp Store公開までのすべての段階を自動化するiOS向けの完全なCI/CDプロセスです。一般的なパイプラインには以下が含まれます：証明書用のMatch、IPAビルド用のGym、スクリーンショット用のSnapshot、そしてすべてのデータをApp Store Connectにアップロードして審査に提出するDeliver。

パイプラインにおけるDeliverの重要な機能は、構造化JSON形式でメタデータを保存するmetadata.jsonのサポートです。これにより、外部CMSシステムからプログラムでメタデータを生成したり、翻訳APIを介して複数言語の説明を自動的に作成したりできます。

# Fastfileのリリースパイプライン
lane :release do
    match(type: :appstore)
    capture_screenshots
    gym(scheme: "MyApp", export_method: "app-store")
    deliver(ipa: "build/MyApp.ipa", force: true, submit_for_review: true)
end

パイプラインでDeliverを呼び出す前に、すべてのメタデータが最新であることを確認してください：説明が新しいバージョンに対応しているか、スクリーンショットが新機能用に更新されているか、価格グループに変更が必要ないか。Submit for reviewはアプリをAppleの審査に送り、新しいアプリの場合は24〜48時間、アップデートの場合は2〜12時間かかります。

Deliverはapp_versionメカニズムをサポートしており、メタデータ更新の対象バージョンを指定できます。バージョンが指定されていない場合、DeliverはApp Store Connectで現在アクティブなアプリのバージョンを更新します。新しいバージョンをリリースするには、App Store ConnectインターフェースまたはAPIを介して事前に対応するバージョンを作成する必要があります。

Deliver使用時の一般的なエラー

Deliverを使用する際、開発者はメタデータ検証エラー、スクリーンショットファイル構造の誤り、認証問題に頻繁に直面します。エラー診断はコマンドログの分析から始まります — Deliverは各アップロード段階と拒否理由に関する詳細情報を出力します。

“Invalid screenshot path”エラーは、スクリーンショットのフォルダ構造が期待される形式と一致しない場合に発生します。解決策：スクリーンショットのファイル名がパターンDeviceType_ScreenSize_Number.pngに従っているか確認します（例：AppleiPhone15ProMax_6.7_01.png）。Deliverはファイル名の大文字小文字と区切り文字を区別します。

“Metadata validation failed”エラーは、メタデータがApp Storeの要件を満たしていないことを示します。解決策：説明の長さ（最大4000文字）、キーワードの長さ（最大100文字）、名前の長さ（最大30文字）を確認します。App Storeレビューガイドラインには各メタデータフィールドの完全な要件が記載されています — 各リリース前に確認することを推奨します。

“Apple ID not found”エラーでは、指定されたapple_identifierを持つアプリがApp Store Connectに存在しません。解決策：最初のDeliver呼び出し前に、Webインターフェースを介してApp Store Connectにアプリエントリを作成し、Bundle Identifierと名前を指定します。Deliverは新しいアプリを作成せず、ストアの既存エントリのみを更新します。