統合テストアプリを使用したFire TVランチャー統合のテスト(任意)
ディープリンクを検証した後、Amazonの統合テストアプリを使用して、アプリがサインインインテントや再生インテント、および機能リクエストに正しく応答しているかをテストできます。
アプリでランチャー統合が適切に実装されているかを確認するには、これが最も簡単な方法です(このトピックは、メディアカタログがFire TVに統合されているFire TV対応アプリに適用されます)。
- このテストオプションを使用すべき場合
- プロセスの概要
- 手順A: 統合テストアプリをダウンロードする
- 手順B: テスト用にアプリを修正する
- 手順C: アプリとFire TV統合テストアプリをFire TVデバイスにインストールする
- 手順D: 統合テストアプリでアプリをテストする
このテストオプションを使用すべき場合
このテストオプションは、アプリの開発を完了し、ランチャーからのインテントに応答するコードを実装済みの場合に使用してください(アプリにFire TVランチャーを統合するを参照)。統合テストアプリを使用してアプリの統合をテストするには、Fire TVデバイスが必要となります。
すべての機能が実装されたアプリのテストや、サインインインテントや再生インテントのテストのみを行う場合は、Android Debug Bridge(ADB)オプションを使用してください(ADBを使用したFire TVランチャー統合のテストを参照)。
プロセスの概要
AmazonのFire TV統合テストアプリを使用してFire TVランチャー統合のテストを行う場合は、以下のプロセスに従ってください。
- 統合テストアプリをダウンロードします。
- 統合テストアプリ用に適切なインテントパッケージを使用できるようにするため、アプリをアップデートします。
- アプリとFire TV統合テストアプリをFire TVデバイスにインストールします。
- Fire TV統合テストアプリを使用してアプリをテストします。
手順A: 統合テストアプリをダウンロードする
テスト開始前に、Fire TV統合テストアプリをコンピューターにダウンロードする必要があります。
手順B: テスト用にアプリを修正する
Fire TV統合テストアプリを使用するため、アプリに以下の変更を加えてください。
- アプリにFire TVランチャーを統合するに記載の変更をまだ行なっていない場合は、このドキュメントを参照してアプリに変更を加えてください。
- ブロードキャスト機能のメソッド内で、
com.amazon.tv.launcher
の名前をcom.amazon.tv.integrationtestonly
に変更します。たとえば、intent.setPackage("com.amazon.tv.launcher")
をintent.setPackage("com.amazon.tv.integrationtestonly")
に変更します。
integrationtestonly
インテントパッケージはテスト専用です。テスト終了後、Amazonアプリストアに公開申請をする前に、必ずインテントパッケージ名を元のcom.amazon.tv.launcher
に戻してください。手順C: アプリとFire TV統合テストアプリをFire TVデバイスにインストールする
テスト開始前に、アプリとFire TV統合テストアプリをFire TVデバイスにインストールする必要があります。インストールの際は、以下の手順に従ってください。
- ADBを使用してFire TVデバイスをコンピューターに接続します。詳細については、ADBを使用してFire TVに接続する方法を参照してください。
- アプリと統合テストアプリの両方をデバイスにサイドロードします。詳細については、アプリをインストールして実行する方法を参照してください。
手順D: 統合テストアプリでアプリをテストする
アプリと統合テストアプリの両方がFire TVデバイスで使用できるようになったら、テストを開始できます。テスト時は以下の手順に従ってください。
- 統合テストアプリを起動します。
- Fire TVメインメニューから、[設定] > [アプリケーション] > [インストール済みアプリケーションを管理] の順に選択し、統合テストアプリを選択します。
- [アプリを起動] を選択します。
-
[Request Capabilities] をクリックします。
統合テストアプリによって、アプリの機能をリクエストするブロードキャストインテントが送信されます。アプリがリクエストに応答し、必要な要素をすべて返した場合、テスト成功のメッセージとアプリから返された各機能の値がテストアプリに表示されます。
注: ここでのテスト成功は、アプリがテスト用ブロードキャストインテントに応答したことのみを意味します。このテストは、アプリが返したデータの正確さを検証するものではありません。 -
アプリが返した機能の値が正しいことを検証してください。
機能の送受信が正常に終了すると、Fire TVにテキスト入力ボックスと [Send Intent] ボタンが表示されます。
-
コンテンツのURLまたはIDを入力して、[Send Intent] をクリックします。
コンテンツ参照は、実装に応じてURIである場合と、データエクストラの名前と値のペアである場合があります。アプリが認識するコンテンツ参照を入力してください。コンテンツ参照と実装が適切であれば、アプリが起動し、インテントとコンテンツ参照の処理が行われます。
アプリのテストが完了したら、必ずブロードキャストインテントパッケージを
com.amazon.tv.launcher
に戻してください。