症状：TestFlightの外部テストを開始できない。
最短の切り分け：まずビルドが外部テストに使える状態かを確認し、その後にテストグループ、審査、テスターへの通知を順番に見ます。リモートMacの接続障害と、App Store Connectの配信設定は分けて調べてください。
対象読者：
- ビルドをアップロードしたのに外部テストグループへ追加できない独立系iOS開発者。
- 旅先でリモートMacを使い、顧客や外部テスターへテスト版を届けたいフリーランス。
- 構築の問題か配信設定の問題かを判別したい小規模チーム。
まず構築と配信の境界を分ける
リモートMacで行うのは、主にXcodeでのアーカイブ作成とビルドのアップロードです。アップロード後のビルド状態、外部テストグループ、ベータ審査、招待はApp Store Connectで確認します。テスター側では、招待や公開リンクから参加し、対応する端末にインストールできるかを確認します。
この三つを混ぜると、配信設定の未完了をリモートMacの不具合と誤認しやすくなります。Macへの接続が保たれ、アップロード結果が確認できるなら、次はApp Store Connectの画面に表示された状態を証拠として扱います。
| 見えている症状 | 確認する場所 | 次に行うこと |
|---|---|---|
| アップロードは完了したがテストに使えない | ビルドの状態と表示メッセージ | 外部テストの対象になれる状態か確認 |
| グループにビルドが出ない | アプリ、プラットフォーム、グループ条件 | 条件やビルド選択を修正 |
| 審査後もテスターが参加できない | 審査状態、通知設定、参加経路 | メール招待または公開リンクを確認 |
Appleのビルド状態の説明とアップロード状態の説明を照合してください。アップロードが完了したことと、外部テストに利用できることは別の確認項目です。
外部テストに使えるビルドか確認する
「アップロード済み」という表示だけで判断せず、App Store Connectで対象アプリを開き、ビルドのステータスと画面上の案内を確認します。処理中、利用可能、対応が必要など、表示される状態によって次の作業が変わります。状態名や具体的なメッセージを控えてから操作すると、再アップロードの繰り返しを避けられます。
| 状態・観察結果 | 判断の目安 | 対応 |
|---|---|---|
| アップロード処理が完了していない | App Store Connect側で処理が続いている可能性 | 表示が更新されるまで状態を確認 |
| ビルドに対応事項が表示されている | 配信前に確認または入力が必要 | 表示された項目を開いて対応 |
| 外部テストグループで選択できる | グループに追加できる候補 | グループ側の設定へ進む |
外部テスト用のビルドには、輸出コンプライアンスに関する情報の確認が必要になる場合があります。表示された質問に基づいて処理し、根拠なく設定を推測しないでください。ベータビルドの輸出コンプライアンス情報に関するAppleの手順を参照します。
注意：内部テストで使えていることだけでは、外部テストも開始できる証拠になりません。外部テストの可否は、App Store Connectで対象ビルドを選べるか、表示された状態が何かで判断してください。
グループにビルドが出ない原因を確認する
テストグループに選択肢がないときは、すぐに再アップロードせず、選択対象と条件を確認します。アプリを取り違えていないか、プラットフォームが一致しているか、テストグループの条件が候補ビルドに合っているかを順に見ます。
| 確認項目 | 観察する証拠 | 対応 |
|---|---|---|
| アプリ | App Store Connectで開いているアプリ名 | 対象のアプリに切り替える |
| プラットフォーム | ビルドとグループの対象 | 同じプラットフォームの候補を選ぶ |
| グループ条件 | 対応する端末やOSなどの設定 | 条件を確認し、必要なら調整 |
| ビルドの状態 | 選択画面に表示される状態や案内 | 表示内容に従い、利用可能な状態にする |
Appleの外部テスターの招待とビルド管理の説明では、外部テストグループにビルドを追加して管理する流れを確認できます。条件に一致する候補がないなら、まずグループ条件かビルド選択を修正します。同じアーカイブを根拠なく再送するのは後回しです。
審査前後とテスト情報を切り分ける
外部テストを開始する前に、テスト用の説明や連絡先など、App Store Connectで求められる情報を確認します。入力欄が未完了なら、ビルドそのものの失敗ではなく、配信前の情報不足が原因である可能性があります。Appleのテスト情報入力ガイドに沿って、画面上で必要とされる項目を埋めてください。
審査状況は、表示されている段階と結果で分けて扱います。審査待ち、審査中、承認、却下を混同せず、却下の場合はApp Store Connectに示された理由を確認して対応します。審査にかかる時間や結果を、リモートMacの性能や接続状況から推測しないでください。
承認後の招待と参加条件を確認する
審査が承認されていても、設定や参加経路が合わなければテスターは参加できません。以下の順で確認します。
- 対象の外部テストグループで、承認されたビルドが選ばれているか確認します。
- テスターがそのグループのメンバーか、または公開リンクで参加する設定かを確認します。
- 自動通知が有効かを見ます。無効なら、手動で通知が必要かを確認します。
- メール招待の場合、案内先とテスターの参加状況を照合します。
- 公開リンクの場合、リンクが有効で、参加条件や人数の設定に合うか確認します。
- テスター側の端末が、グループで指定された条件に合っているか確認します。
Appleのテスター情報の表示と管理で、登録状態を確認できます。公開リンクは第三者へ転送される可能性があります。想定する範囲を超えて参加者が広がると困る場合は、公開を続ける前にリンクの設定と参加条件を見直してください。
補足：メール招待と公開リンクは同じ経路ではありません。どちらを案内したかを先に特定し、その経路の設定とテスターの状態を確認すると、調査対象を絞れます。
リモートMac側の証拠を照合する
App Store Connectに候補ビルドが見当たらず、構築またはアップロードの結果が疑わしい場合は、リモートMacと配信画面を分けて記録します。Appleのビルドアップロード手順を参照し、次の証拠を一組で確認してください。
- Xcodeで対象プロジェクトと対象アプリを開き、作成したアーカイブを確認します。
- アーカイブのアプリ、バージョン、ビルド情報が、配信対象と一致しているか記録します。
- アップロード操作の完了表示や、エラーがあればその内容を控えます。
- App Store Connectで対象アプリを開き、ビルドが表示されるか確認します。
- 表示されたビルド状態と対応メッセージを記録し、テストグループ側の選択状態と照合します。
アップロードの記録があり、App Store Connectにもビルドが表示されているなら、テスター招待やグループ条件の確認へ進みます。記録がない、またはエラーが出ているなら、アーカイブとアップロードを先に見直します。画面上の状態だけでは原因を特定できない場合は、状態名と確認済みの項目を添えてAppleのサポートへ問い合わせてください。
リモートMacで継続的に構築する必要があり、手元にmacOS環境がない場合は、MACCOMEのリモートMac案内で利用方法を確認できます。作業場所や接続先を比較するなら、Mac miniの案内や東京向けの案内も参照してください。既に安定したMacを所有し、長期にわたり高負荷の構築を続けるなら自前環境が合う場合もあります。一方、移動中だけmacOSが必要で、軽量端末から作業したいなら、必要な期間だけリモートMacを利用する選択肢があります。
よくある質問
TestFlightの外部テストが始まらない場合
まずApp Store Connectで対象ビルドの状態と、外部テストに使えるかを確認します。次にテストグループ、必要なテスト情報、審査状態を順番に照合してください。リモートMacの接続確認だけでは、配信側の未設定や審査状態は解決できません。
テストグループに選べるビルドがない場合
対象アプリとプラットフォーム、テストグループの条件、ビルドの状態を確認します。条件が合わない場合は設定か選択対象を修正し、画面に対応事項が出ていれば先に解消します。再アップロードは、アップロード結果に問題がある証拠がある場合に検討してください。
アップロード済みのビルドで招待が届かない場合
外部テストの審査状態、グループへのビルド追加、テスターの登録状態を確認します。さらに、自動通知の設定と、実際に使った招待メールまたは公開リンクを確認してください。公開リンクには参加条件が設定されている場合があるため、テスター側が条件を満たしているかも照合します。
外部テストの審査承認後にテスターへ知らせる方法
自動通知が有効かどうかをグループの設定で確認します。自動通知を使っていない場合は、手動で案内する必要があるかを確認し、テスターに招待メールまたは公開リンクを送ります。通知を受け取っていても参加できない場合は、グループ所属と端末の参加条件を調べます。