メインコンテンツまでスキップ

ストアへのアプリのリリース

リリース候補がストアにアップロードされ、すべての承認が完了すると、ユーザーへのリリースが可能になります。iOSの場合、まずApp Store審査にアプリを提出する必要もあります。Androidのリリースはリリースステップに直接進みます。

Store Releases のサブAPIのベースURLは次のとおりです: https://api.bitrise.io/release-management/v2/store-releases/v1。エンドポイント、パラメーター、スキーマの全一覧については、Store Releases APIリファレンスを参照してください。

ベータ配信の設定（iOS）Click to copy link​

正式リリースを提出する前に、TestFlight（iOSのみ）を通じてビルドをベータテスターに配布できます。

TestFlightテストグループの一覧表示Click to copy link​

リリースに関連付けられたTestFlightテストグループを返します。特定のグループへの配布を開始するには、レスポンスのidの値を使用します。

curl -X GET "https://api.bitrise.io/release-management/v2/store-releases/v1/app-versions/RELEASE_ID/beta-distribution/testing-groups" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

TestFlightグループへのベータ配信の開始Click to copy link​

特定のTestFlightグループのテスターに対して、リリースビルドを利用可能にします。テスターには通知が届き、TestFlightアプリから直接ビルドをインストールできます。

curl -X PATCH "https://api.bitrise.io/release-management/v2/store-releases/v1/app-versions/RELEASE_ID/beta-distribution/testing-groups/GROUP_ID" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

TestFlight向けのテスト内容メモの追加Click to copy link​

リリースビルドにテスト手順を添付します。テスターはビルド通知を受け取った際、TestFlightアプリでこれらのメモを確認できます。

curl -X POST "https://api.bitrise.io/release-management/v2/store-releases/v1/app-versions/RELEASE_ID/beta-distribution/what-to-test" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "locale": "en-US",
    "whats_new": "Fixed login issue and improved onboarding flow."
  }'

リリースノートの追加（Android）Click to copy link​

リリースノートはアプリのGoogle Play Store掲載ページの新機能の下に表示され、ユーザーがアプリを更新する前後に表示されます。複数の言語でノートを提供できます。Google Playはユーザーのデバイス言語に一致するバージョンを表示し、一致するものがない場合はen-USにフォールバックします。

BCP 47言語タグを使用して、言語とテキストのペアの配列をrelease_notesフィールドに渡します（例: en-US、de-DE、fr-FR）:

curl -X PUT "https://api.bitrise.io/release-management/v2/store-releases/v1/app-versions/RELEASE_ID/google-play-store/localized-release-notes" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "release_notes": [
      {
        "language": "en-US",
        "text": "Fixed login issue and improved onboarding flow."
      },
      {
        "language": "de-DE",
        "text": "Login-Problem behoben und Onboarding-Flow verbessert."
      }
    ]
  }'

各リリースノートのテキストは最大500文字まで指定できます。

ストア審査への提出（iOS）Click to copy link​

Android

API経由で提出されたAndroidのリリースは、設定済みのGoogle Playトラックに直接進み、個別の審査提出ステップは不要です。以下のリリースステップに進んでください。

エンドポイント機能必要なロール
POST /app-versions/{id}/apple-app-store/review/submitリリースをApp Store審査に提出します。リリースマネージャー
GET /app-versions/{id}/apple-app-store/review/status現在のApp Store審査ステータスを取得します。誰でも
POST /app-versions/{id}/apple-app-store/review/cancel保留中の審査提出をキャンセルします。リリースマネージャー

リリースをApp Store審査に提出します:

curl -X POST "https://api.bitrise.io/release-management/v2/store-releases/v1/app-versions/RELEASE_ID/apple-app-store/review/submit" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "copy_primary_whats_new": true,
    "localizations": [
      {
        "locale": "en-US",
        "whats_new": "Bug fixes and performance improvements.",
        "description": "Updated description for this version.",
        "keywords": "productivity, task manager"
      }
    ]
  }'

copy_primary_whats_new: trueを設定すると、プライマリロケールの「新機能」テキストが、テキストが未設定の他のすべてのローカライズにコピーされます。

審査ステータスを確認するには:

curl -X GET "https://api.bitrise.io/release-management/v2/store-releases/v1/app-versions/RELEASE_ID/apple-app-store/review/status" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

リリース設定の構成Click to copy link​

リリースする前に、アップデートをユーザーにロールアウトする方法を設定します:

curl -X PATCH "https://api.bitrise.io/release-management/v2/store-releases/v1/app-versions/RELEASE_ID/apple-app-store/release/settings" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "release_type": "AFTER_APPROVAL",
    "phased_release": true
  }'

release_typeのオプション:

  • AFTER_APPROVAL: Appleによる承認後に自動的にリリースします。
  • MANUAL: 手動でトリガーするまでリリースを保留します。
  • SCHEDULED: 指定した日時にリリースします（ISO 8601形式のearliest_release_dateが必要です）。

phased_release: trueを使用すると、アップデートを一度に配信するのではなく、7日間かけてユーザーにロールアウトします。

ユーザーへのリリースClick to copy link​

エンドポイント機能必要なロール
POST /app-versions/{id}/apple-app-store/releaseアプリをApp Storeにリリースします。リリースマネージャー
GET /app-versions/{id}/apple-app-store/release/statusrelease statusを取得します。誰でも
POST /app-versions/{id}/apple-app-store/release/pause段階的リリースを一時停止します。リリースマネージャー
POST /app-versions/{id}/apple-app-store/release/continue一時停止中の段階的リリースを再開します。リリースマネージャー
POST /app-versions/{id}/apple-app-store/release/complete段階的リリースを即座に完了します。リリースマネージャー

リリースをトリガーします:

curl -X POST "https://api.bitrise.io/release-management/v2/store-releases/v1/app-versions/RELEASE_ID/apple-app-store/release" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

release statusを確認します:

curl -X GET "https://api.bitrise.io/release-management/v2/store-releases/v1/app-versions/RELEASE_ID/apple-app-store/release/status" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Accept: application/json"

段階的リリースを即座に完了するには（すぐに100%のユーザーへ展開する場合）:

curl -X POST "https://api.bitrise.io/release-management/v2/store-releases/v1/app-versions/RELEASE_ID/apple-app-store/release/complete" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

リリースWebhookの設定Click to copy link​

リリースが主要な段階に達した際に通知を受け取るよう、送信Webhookを設定できます。

curl -X POST "https://api.bitrise.io/release-management/v2/store-releases/v1/app-versions/RELEASE_ID/outgoing-webhooks" \
  -H "Authorization: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "events": ["release_started", "submitted_for_review"],
    "webhook_configuration_id": "WEBHOOK_CONFIG_ID"
  }'

個々のイベントを列挙する代わりにall_events: trueを設定すると、リリースのライフサイクル全体のイベントについて通知を受け取れます。

関連情報