App Distribution のトラブルシューティングとよくある質問

連絡先メールアドレスがないため、アプリを配布できない

アプリをアップロードすると、次のようなエラーが発生することがあります。

「アプリ <app-id> の連絡先メールアドレスが見つかりません。Firebase コンソールで App Distribution にアクセスして設定してください。」

可能であれば、Firebase コンソールで連絡先メールアドレスを設定します。問題が解決しない場合は、Firebase サポートにお問い合わせください。

アプリのプロビジョニング中にエラーが発生する（400、409、500 エラー）

プロビジョニング中にエラー 400、409、500 が繰り返し発生する場合は、Firebase サポートにお問い合わせください。その際、お客様の Firebase プロジェクト番号とアプリ ID をお知らせください。

APK ファイルをアップロードできない

1. APK のサイズを確認します。バイナリ ファイルの合計サイズの上限は 2,048 MiB で、2 GB をわずかに超えます。

2. APK のファイルサイズがこの制限内にあり、再現可能な場合は、Firebase サポートにお問い合わせください。

fastlane を使用して APK をアップロードできない。APK が署名されていない。

次のコマンドを使用して、APK が署名されていることを確認します。

apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk

ソーシャル ログイン / サードパーティ API プロバイダのエラーの受信

AAB を App Distribution にアップロードすると、テストアプリの署名鍵証明書を使用して、生成された APK の再署名が Google Play によって自動的に行われます。サードパーティのサービスを引き続き使用する場合は、プロンプトが表示されたときに、API プロバイダにアプリを登録する必要があります。署名されたアプリのテスト証明書は Firebase コンソールで確認できます。

アップロードした AAB は Google Play にも表示されますか？

App Distribution にアップロードした AAB ビルドは、Google Play デベロッパー アカウントに表示されません（App Bundle エクスプローラや内部アプリ共有にも表示されません）。

Firebase と Google Play のリンクを解除するとどうなりますか？

Firebase Android アプリと Google Play のリンクを解除すると、次のようになります。

• 新しい App Bundle を App Distribution にアップロードしたり、App Distribution と Google Play のインテグレーションを介して Google Play にエクスポートできなくなります。

• 既存のビルドは、Firebase App Distribution ダッシュボードとテスターで引き続き使用できます。

• Firebase と Google Play 間でこれまでエクスポートされたデータには、引き続き両方のプロダクトからアクセスできます。

アプリを Google Play にリンクし直すことはできますか？

App Distribution から Android App Bundle（AAB）を配布し、アップロードした AAB を Firebase プロジェクトと Google Play デベロッパー アカウントの両方に自動的にリンクするには、次の要件を満たしている必要があります。

• Google Play デベロッパー アカウントに、オーナーまたは管理者のいずれかのアクセスレベルが付与されている。

• Firebase プロジェクトに対して、オーナーまたは Firebase 管理者のいずれかのロールが付与されている。

• アプリが Firebase と Google Play デベロッパー アカウントに登録されている。つまり、Firebase Android アプリと Google Play アプリの両方が必要になります。

• Google Play のアプリと Firebase Android アプリが同じパッケージ名で登録されている。

• Google Play のアプリがアプリ ダッシュボードで設定され、いずれかの Google Play トラック（内部テスト、クローズド テスト、オープンテスト、製品版）に配布されていること。

• Google Play でアプリの審査が完了し、アプリが公開されている。[アプリのステータス] 列に、内部テスト（未公開の内部テスト以外）、クローズド テスト、オープンテスト、製品版のいずれかのステータスが表示されている場合、アプリは公開されています。

上記の条件を満たしていないアプリをアップロードし、現在、そのアプリが要件を満たしている場合は、Firebase Android アプリと Google Play のリンクを再試行できます。

テスターが Google アカウントを持っていない

Google アカウントを作成すると、自動的に Gmail アドレスが付与されます。

テスターに Google Workspace または Gmail のアドレスがない場合、またはテスターが別のメールアドレスでログインすることを希望している場合は、Gmail 以外のメールアドレスをアカウントにリンクして、そのメールアドレスを使用するようにテスターに伝えてください。

予備のメールアドレスを変更する場合は、以下のガイドラインに従ってください。

• Gmail アドレスは使用しない。
• 別の Google アカウントにリンクされているメールアドレスは使用しない。
• このメールアドレスでログインする場合は、必ず Google アカウントのパスワードを使用してください。

詳しくは、別のメールアドレスで Google アカウントにログインするをご覧ください。

テスターが適切なアプリやビルドを確認できない

テスターが招待状の送信先と異なるメールアドレスで招待を承諾した場合、テスターは適切なアプリやビルドを確認できない場合があります。

デベロッパーが招待状を送信して新しいビルドに追加するメールアドレス（メールアドレス A）と、テスターが招待の承諾に使用するメールアドレス（メールアドレス B）が異なる場合があります。この場合、バックグラウンドでリンクが作成されます。メールアドレス A が新しいビルドに追加されると、実際にアクセス権が付与されるのはメールアドレス B になります。

テスターが別のメールアドレスで招待を受諾した場合に問題を解決する手順は次のとおりです。

1. Firebase コンソールの [App Distribution] ページで、[テスターとグループ] タブにある [すべてのテスターを表示] セクションからテスターを削除します。既存の招待状が削除されます。

2. アプリをテストするテスターを再度招待します。テスターに招待メールが届きます。

3. テスターが同じメールアドレスで招待を承諾していることを確認します。

テスターにメール通知が届かない

次のいずれかの場合、テスターにメール通知が届かないことがあります。

• メール通知が迷惑メールフォルダに送信されている。

• メールフィルタが設定されている。

• テスターが、招待を送信したメール アカウントと異なるメール アカウントで招待を受け入れた。テスターが、最初に招待が送信されたメール アカウントで新しいリリース メールを受け取った。

• テスターは以前に招待されているが、最初の招待を承諾しなかった。テスターが今後のリリースに追加されても、最初の招待を承諾していないため、このテスターには App Distribution からリリース通知が自動的に送信されません。

解決方法 1

1. テスターに、迷惑メールフォルダとメールサービスで設定したメールフィルタを確認するように伝えます。

2. テスターがメール配信の登録を解除した場合は、次の操作を行うようにテスターに伝えます。

   1. 以前にアプリから受け取ったメールを見つけます。
   2. メールの下部にある [Manage email settings] をクリックして、[Allow emails] をクリックして再登録します。

解決方法 2

テスターがメール通知を受信せずにアプリの招待を受諾したい場合は、App Tester アプリ（ダウンロード手順）で、保留中のアプリの招待状を直接表示できます。

解決方法 3

1. Firebase コンソールの [App Distribution] ページで、[テスターとグループ] タブにある [すべてのテスターを表示] セクションからテスターを削除します。この操作を行うと、既存の招待状が削除されます。

2. アプリをテストするテスターを再度招待します。テスターに招待メールが届きます。招待が届いたメールアドレスで招待を承諾するようにテスターに伝えます。

アプリがインストール済みであることが表示されない

テスターがリリースをダウンロードしてインストールしても、アプリの詳細ユーザー インターフェースに、アプリがインストール済みであることが表示されないことがあります。これは既知の問題です。また、Firebase アプリのバンドル ID が APK のバンドル ID と一致しないこともあります。

APK のバンドル ID が、アップロードに使用した Firebase アプリのバンドル ID と一致していることを確認してください。

不明なアプリをデバイスにインストールできないことを通知する Android アラートが表示される

実行中のアプリやブラウザに Google Play 以外のアプリをインストールする権限が付与されていないと、Android のアラートが表示されます。権限を付与する手順は次のとおりです。

• Android バージョン 8 以降: 設定アプリで、[この提供元のアプリを許可] をタップします。

• Android バージョン 7 以前: 設定アプリで [セキュリティ] をタップし、[提供元不明のアプリ] を選択します。メッセージが表示されたら、[OK]、[信頼する] の順にタップします。

テスト用 APK をインストールできない

テスターのデバイスにテスト用 APK がインストールできない場合:

• 新しいバージョンの証明書が、テスターのデバイスにインストールされている証明書のバージョンと一致することを確認します。Android システムでは、証明書が一致している場合にのみ、アプリの更新が許可されます。詳細については、署名に関する考慮事項をご覧ください。
• テスターのデバイスの OS バージョンがアプリでサポートされていることを確認します（minSdkVersion を確認してください）。

Android App Tester アプリにログインできない

App Tester アプリにログインできず、ログイン画面に戻る場合は、制限が設定された Google Workspace（旧 G Suite）を使用している可能性があります。

制限の設定を削除するには:

1. Google Workspace の [アプリ] タブで、Firebase App Distribution が「Access: Blocked」に設定されていないことを確認します。

2. [サービス] タブで、Cloud Platform が制限されていないことを確認します。

3. 設定が削除されたら、もう一度ログインしてみてください。

AAB インストール時のエラー: 「アプリをインストールできません」

このエラーは、インストールされるアプリが、デバイスにすでにインストールされているアプリと競合する場合に発生する可能性があります。たとえば、同じアプリの異なるバリエーションで、カスタム権限や ContentProvider 名を持つアプリの可能性があります。

問題の発生後すぐにバグレポートを収集するようにテスターに依頼し、レポートを参照して原因の詳細を確認できます。テスターは、新しいアプリをインストールする前に競合するアプリを削除する必要があります。

403 エラー: 「管理者にお問い合わせください」

403 エラーが表示された場合は、使用中のアカウントにアプリのインストールとテストの権限が付与されていないことを意味します。アクセス権は、Google Workspace アカウントのドメインの管理者によって行われます。

アプリのインストールとテストを行う権限があると思われる場合は、Google Workspace アカウントの管理者にアカウントの設定変更を依頼してください。管理者が個別に制御されていないサービスへのアクセスを管理する手順を行います。

複数のアカウントをお持ちの場合は、アプリのインストールやテストが制限されていない別のアカウントでログインを試みてください。

新しい Android デバイスでテストする

初めてテスターになる場合は、テスターとして設定するをご覧ください。

既存の App Distribution テスターで、新しい Android デバイスを入手した場合は、新しいテスターのフロー全体を再度行うのではなく、次の手順を行います。

1. Android デバイスで appdistribution.firebase.google.com に移動します。

2. 既存のテスター アカウントでログインし、画面下部の [App Tester をダウンロード] ボタンをクリックして Android App Tester アプリをインストールします。

テスターがアプリでフィードバックを開始できない

アプリで App Distribution Android SDK がアプリ内フィードバックをサポートするようにセットアップされていても、テスターがフィードバックを送信できない場合は、次の手順を行います。

1. アプリで App Distribution Android SDK の詳細ログを有効にします。

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

2. 「FirebaseAppDistribution」でフィルタリングして、アプリログのエラー メッセージを確認します。

3. テスターがインストールされたリリースにアクセスできることを確認します。

   1. ログに「テスターはこのリソースへのアクセス権がありません」と表示される場合は、テスターがアプリに招待されていないか、テスターがリリースにアクセスできない可能性があります。

   2. Firebase コンソールの App Distribution ダッシュボードで、テスターのデバイスで動作している正確なリリースを見つけて、テスターがリリースカードの [テスター] タブに表示され、Accepted 状態であることを確認します。

   それでもフィードバックを受け取れない場合は、次の手順を行います。

   1. テストデバイスで、App Tester またはテスター ウェブアプリを使用して Firebase App Distribution にログインします。アプリのテストへの招待を受けたときに使用した Google アカウントを必ず選択してください。

   2. App Tester またはテスト ウェブアプリを使用してアプリを再度インストールし、テスターがリリースにアクセスできることを確認します。

   3. 同じ Google アカウントでログインして、再度フィードバックを送信してください。

4. Firebase App Testers API を有効にしたことを確認します。詳細については、App Distribution Tester API を有効にするをご覧ください。

5. [Key restrictions] で、許可されている API のリストに Firebase App Testers API が含まれていることを確認します。

アプリで送信されたフィードバックを受信しない

1. フィードバックを送信する際に「送信したフィードバックは、開発モードのため送信されなかった」というメッセージが表示された場合は、次のコマンドを実行してデバイスでデベロッパー モードを無効にします。

   adb shell setprop debug.firebase.appdistro.devmode false
   

2. google-services.json ファイルを調べて、正しいプロジェクトとアプリに関するフィードバックを送信していることを確認します。

3. アプリで App Distribution Android SDK の詳細ログを有効にします。

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

4. 「FirebaseAppDistribution」でフィルタリングして、アプリログのエラー メッセージを確認します。

テスターがアプリ内アラートを受信できない

アプリで App Distribution Android SDK がセットアップされていても、テスターがアプリ内アラートを受信できない場合は、次の手順を行います。

1. Firebase App Distribution API から返されたタスクに OnFailureListener を関連付けて、エラー メッセージを確認します。

   Java

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> {
                     if (e instanceof FirebaseAppDistributionException) {
                        // Log exception here
                     }});
   

   Kotlin

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e ->
                     if (e is FirebaseAppDistributionException) {
                        // Log exception here
                     }
     }
   

2. テスターが新しいリリースにアクセスできることを確認します。

   1. アプリでデバッグモードを有効にします。方法については、Google アナリティクスのドキュメントをご覧ください。

   2. シミュレータでアプリを実行し、「FirebaseAppDistribution」という文字列を検索します。

      ログでリリースが見つからなかったか、テスターにアクセス権がない場合は、テスターがまだ新しいリリースに関連付けられていない可能性があります。

   3. Firebase コンソールの App Distribution ダッシュボードで、テスターがビルドの配布先に含まれ、承諾済み状態になっていることを確認してください。

      それでもテスターがアラートを受信できない場合は、以下のヒントを参考にして、テスターがアプリのテストへの招待を承諾してテストデバイスを適切に設定しているかどうか確認してください。

      1. テストデバイスで、App Tester またはテスター ウェブアプリから Firebase App Distribution にログインします。アプリのテストへの招待を承諾したときに使用した Google アカウントを必ず選択してください。

      2. 新しいアプリのリリースが App Tester またはテスター ウェブアプリで利用できることを確認します。

テスターがアプリを終了後に再度ログインするように求められる

デフォルトでは、テスターは Google アカウントに一度ログインし、テスト機能を有効にするだけで済みます。アプリを終了して再度開くとログインを求められる場合は、以下のヒントを参考にして、App Distribution の構成が正しく行われていることを確認してください。

• Firebase App Testers API が有効になっていることを確認します。詳細については、App Distribution Tester API を有効にするをご覧ください。

• [Key restrictions] で、許可されている API のリストに Firebase App Testers API が含まれていることを確認します。

• 通常、ログアウト時に SharedPreferences をクリアすると、テスターの状態をクリアできます。App Distribution では、テスターがアプリにログインしているかどうかを示すフラグが格納されます。詳細については、GitHub リポジトリをご覧ください。

アプリに追加できるテスターに制限はありますか？

Firebase App Distribution では、テスターについて次の制限があります。

• 1 つの Firebase プロジェクトに追加できるテスターは最大 500 人までです。

• App Distribution グループに追加できるテスターは最大 200 人までです。

テスターを追加するには、追加料金なしの上限の引き上げをリクエストしてください。

テスターの招待に有効期限はありますか？

招待の有効期間は 30 日です。この期間内にテスターは招待を承諾してアプリのテストを開始できます。招待が期限切れになる 5 日前に、Firebase コンソール内のリリース テスターの横に有効期限のお知らせが表示されます。招待状は、テスターの行のプルダウン メニューから再送信して更新できます。

アプリのリリース期間はどのくらいですか？

次のいずれかの条件に該当する場合、アプリのリリースは App Distribution から削除されます。

• アプリのリリースから 150 日以上経過している。
• アプリのリリース数が上限の 1,000 を超えており、かつ、アプリのリリースが最新の 1,000 個のアプリ リリースよりも古い。

詳細については、App Distribution で最大 1,000 個のリリースをサポートをご覧ください。

150 日の有効期限または 1,000 個のリリース上限に達すると、アプリは App Distribution ダッシュボードと Firebase App Tester アプリから削除されます。テスターがリリースをインストールしている場合、ローカルのアプリ バージョンは引き続き実行できます。

アプリのリリースを長期間利用できるようにするには、次のいずれかの推奨事項を行います。

• アプリのリリースが期限切れになるかリリース上限を超える前に、APK または AAB をダウンロードして App Distribution ダッシュボードからリリースを削除します。次に、APK または AAB を App Distribution に新しいビルドとして再度アップロードします。
• リリースをダウンロードし、長期アーカイブのために Cloud Storage にアップロードします。

アプリのリリースは 150 日後に期限切れになります

アプリのリリースを Firebase にアップロードすると、リリース日から 150 日間、App Distribution ダッシュボードにリリースが表示されます。リリースをアップロードすると、テスターに配布できます。テスターは、Firebase App Tester アプリのリリースをテストデバイスにインストールします。

リリースが期限切れになる 30 日前から Firebase App Tester アプリにアプリリリースの有効期限の通知が届きます。

App Distribution では最大 1,000 個のリリースがサポートされます

App Distribution では、アプリごとに最大 1,000 個のリリースが許可されます。アプリがリリース数の上限である 1,000 個に達すると、App Distribution はこの上限を超える最も古いリリースを自動的に削除します。

アプリのリリースを手動で管理する場合は、App Distribution REST API を使用してアプリのリリースを一括で一覧表示し、削除します。

ご不明な点がございましたら、Firebase サポートまでお問い合わせください。

デバイスにインストールしたテスト用アプリにアクセスするにはどうすればよいですか？

テスターの方は、Firebase App Tester をダウンロードすることをおすすめします。このアプリを使用すると、すべてのテストビルドに 1 か所からアクセスできます。

テスター アカウントを削除するにはどうすればよいですか？

App Distribution テスター アカウントとそれに関連するデータを削除する手順は次のとおりです。

1. https://appdistribution.firebase.google.com にアクセスして、Google アカウントでログインします。

2. 右上の settings（[アカウントを管理]）をクリックし、

   [アカウントを削除] をクリックします。

3. 省略可: Google アカウントの権限で、Firebase App Distribution のアクセス権を取り消します。注: App Distribution アカウントを最初に削除せずにアクセス権を取り消した場合、テスター アカウントとデータは削除されませんのでご注意ください。