このページでは、トラブルシューティングのヘルプ情報を説明します。また、App Distribution によるアプリの配布とテストに関するよくある質問とその回答を紹介します。
アプリのインストールとテスト
次のヒントは、テスト用アプリのインストールとデバイスへのアクセスに関連するトラブルシューティングに役立ちます。
Google アカウントにテスト用アプリへのアクセス権がない
以前にインストールした(または招待を承諾した)テスト用アプリにアクセスできない場合、間違った Google アカウントにログインしている可能性があります。アクセス権のあるアプリは、アプリのテストへの招待を承諾した際に使用した Google アカウントに関連付けられています。招待の承諾に使用した Google アカウントでログインしてから、もう一度お試しください。
テスト用アプリを実行すると、「信頼できないエンタープライズ デベロッパー」エラーが発生する
アプリを開く前にテストデバイスでデベロッパー証明書を信頼しなかった場合は、「信頼できないエンタープライズ デベロッパー」エラーが発生します。設定アプリの [Profiles & Device Management] 画面で、アプリのデベロッパー名を選択して信頼してください。
「デベロッパーを待機中」になり、テスト用アプリをインストールできない
アドホック配布をインストールする場合、デベロッパーがテストデバイスで実行するようにアプリを構成していないと [Waiting for developer] ボタンが表示されます。アプリを利用できるようにするには、デベロッパーが次の操作を行う必要があります。
テストデバイスの UDID を Apple デベロッパー ポータルに追加します(デバイスを Firebase に登録すると UDID がデベロッパーにメールで送信されます)。
アプリのプロビジョニング プロファイルにこのデバイスを含めます。
更新済みのプロビジョニング プロファイルを使用してアプリをビルドします。
Firebase コンソール、CLI、fastlane を使用して、新しいビルドを配布します。
App Distribution SDK によるアプリ内アラートの有効化
以下のヒントは、App Distribution SDK を使用してアプリ内の新しいビルドアラートを有効にする際に発生する問題をデベロッパーやテスターがトラブルシューティングするのに役立ちます。
テスターがアプリ内アラートを受信できない
アプリで App Distribution SDK をすでにセットアップしているにもかかわらず、テスターがアプリ内アラートを受信できない場合は、アプリが新しいリリースを取得しているかどうかを確認してください。
アプリでデバッグモードを有効にします(方法については、Google アナリティクスのドキュメントをご覧ください)。その後、シミュレータでアプリを実行し、「[Firebase/AppDistribution]」という文字列を検索します。
アプリのリリースを取得していることを確認します。
有効なリリース オブジェクトが返されている場合は、ビュー コントローラのライフサイクル(ビューが表示される前にアラート ダイアログが読み込まれる)に問題が生じている可能性があります。App Distribution SDK では、デフォルトでアラート ダイアログは表示されません。アプリ内でダイアログを表示する方法と場所を指定する必要があります(例については基本アラート構成をご覧ください)。
リリースが返されていない場合は、テスターが新しいリリースにまだ関連付けられていない可能性があります。Firebase コンソールの App Distribution ダッシュボードで、テスターがビルドのディストリビューションに含まれており、[承認済み] 状態になっていることを確認してください。
それでもテスターがアラートを受信できない場合は、以下のヒントを参考にして、テスターがアプリのテストへの招待を承認してテストデバイスを適切に設定しているかどうか確認してください。
テストデバイスで、Firebase App Distribution ウェブクリップにログインします(アプリのテストへの招待を承認したときに使用した Google アカウントを必ず選択してください)。
新しいアプリリリースがウェブクリップで利用できることを確認します。
テスターがアプリを終了後に再度ログインするように求められる
デフォルトでは、テスターは Google アカウントに一度ログインするだけで、新しいビルドアラートの有効化や新しいビルドのインストールを行うことができます。アプリを終了して再度開くとログインを求められる場合は、以下のヒントを参考にして、App Distribution の構成が正しく行われていることを確認してください。
App Distribution Tester API が有効になっていることを確認します(App Distribution SDK ガイドをご覧ください)。
Google Cloud Platform Console の [キーの制限] で、制限された API キーを使用していないことを確認します。
通常、ログアウト時に
UserDefaults
をクリアすると、テスターの状態をクリアできます。App Distribution では、テスターがアプリにすでにログインしているかどうかを示すフラグが格納されます(詳しくは、GitHub リポジトリをご覧ください)。
よくある質問
アプリに追加できるテスターに制限はありますか?
Firebase App Distribution では、テスターについて次の制限があります。
1 つの Firebase プロジェクトに追加できるテスターは最大 500 人までです。
App Distribution グループに追加できるテスターは最大 200 人までです。
配布ごとに追加できるテスターは最大 200 人までです。
この上限よりも多くのテスターを追加するには、無料の上限の引き上げをリクエストしてください。
アプリのビルドに有効期限はありますか?
アプリのビルドを Firebase にアップロードすると、(Firebase コンソールの)App Distribution ダッシュボードで、アップロードした日から 150 日間(5 か月間)利用できます。その後、テスターにビルドを配布します。テスターは、Firebase App Distribution のウェブクリップからそのビルドをテストデバイスにインストールできます。ユーザーとテスターに通知するために、有効期限切れから 30 日後に、有効期限切れのお知らせがビルドに表示されます。
150 日が経過すると、ビルドは有効期限切れになり、App Distribution ダッシュボードと Firebase App Distribution のウェブクリップの両方から削除されます。テスターがビルドをインストールした場合、アプリのローカル バージョンは引き続き実行されます。
ビルドを長期間保持する場合は、次の解決策をおすすめします。
ビルドが有効期限切れになる前に、App Distribution ダッシュボードから IPA をダウンロードし、ビルドを削除する。 続いて、IPA を(新しいビルドとして)Firebase App Distribution に再度アップロードする。
ビルドをダウンロードし、長期アーカイブのために Cloud Storage for Firebase にアップロードする。
Firebase プロファイルとは何ですか?
Firebase プロファイルは、App Distribution で次のことを可能にする構成プロファイルです。
デバイスの一意のデバイス ID(UDID)を収集して、テストデバイスを登録する。アドホック配信をテストする場合、テストデバイスの UDID と アプリのプロビジョニング プロファイルにデバイスを追加する方法が記載されたメールが Firebase から送信されます。このメールの情報により、デバイスでビルドのテストを行うことができます。
デバイスのホーム画面に Firebase App Distribution ウェブクリップをインストールする。ウェブクリップを使用すると、すべてのテスト用アプリをインストールして 1 か所からアクセスできるようになります。テストに招待された新しいビルドは、自動的にウェブクリップに追加されます。
iOS デバイスに構成プロファイルをインストールする方法については、Apple のドキュメントをご覧ください。
デバイスにインストールしたテスト用アプリにアクセスするにはどうすればよいですか?
Firebase App Distribution ウェブクリップを使用すると、すべてのテスト用アプリにアクセスできます。このクリップは、Firebase プロファイルをインストールしたときに、テストデバイスのホーム画面に自動的に追加されます。アドホック配信をテストする場合は、アプリのテストを行う前にプロファイルをインストールする必要があります。
エンタープライズ配信のテストを行う場合は、プロファイルを手動でインストールできます。
Google にログインして招待を承諾します(まだ承諾していない場合)。
[Test apps] で、テストするアプリを選択します。
アプリのページの右上にある [mobile_screen_share] をタップします。
表示された手順に沿って Firebase プロファイルをインストールします。
テスター アカウントを削除するにはどうすればよいですか?
App Distribution テスター アカウントとそれに関連するデータを削除する手順は次のとおりです。
https://appdistribution.firebase.google.com にアクセスして、Google アカウントでログインします。
右上の settings([アカウントを管理])をクリックし、
[アカウントを削除] をクリックします。
省略可: Google アカウントの権限で、Firebase App Distribution のアクセス権を取り消します。注: App Distribution アカウントを最初に削除せずにアクセス権を取り消した場合、テスター アカウントとデータは削除されませんのでご注意ください。