Android Studio 用の Google アシスタント プラグイン

Google アシスタント プラグインは、Android Studio 内で App Actions をテストします。開発時とテスト時は、このプラグインを使用して、 Google アカウントのアシスタントでの App Actions。これにより、デプロイに向けてアプリを提出する前に、App Action でさまざまなパラメータがどのように処理されるかをテストできます。

仕組み

Google アシスタント プラグインには App Actions Test Tool が含まれています。 shortcuts.xml ファイルを解析し、App Actions のプレビューを 関連付けられます。こうしたプレビューにより、アプリの製品版を Google Play Console にデプロイする前に、Google アシスタントに App Actions を認識させることができます。

shortcuts.xml ファイル内の組み込みインテント（BII）ごとに、ツールがレンダリングします。 対応する JSON-LD オブジェクトが返され、デフォルトのパラメータ値が提供されます。次に、それらの値を変更し、意味のあるパラメータの組み合わせで App Actions をテストして、アプリの適切な機能が実行されることを確認します。プレビューは テストツールで作成、更新、削除できるため、 安全な環境で App Actions をテストします。

プレビューを作成したら、テストツール ウィンドウから直接テストデバイスで App Action をトリガーできます。BII が利用可能な場合 app name をデバイスの Google アシスタントで直接使用し、 試してみましょうたとえば、「OK Google, Example App を使用してエクササイズを開始する」を選択して、 BII: actions.intent.START_EXERCISE。

ロケールのサポート

テストツールで特定の言語 / 地域のプレビューを作成する方法は、BII によって異なります。 組み込みインテント リファレンスの各 BII のページには、それぞれの BII で利用できる機能の情報が記載されています。たとえば、テストツールで特定のロケールでのプレビューの作成をサポートしているか、ユーザーがトリガーできる App Actions があるかなどを確認できます。

プラグインを入手する

Google アシスタント プラグインは、Android Studio で利用できます。Android Studio のインストール方法と使用方法については、Android Studio のページをご覧ください。

Android Studio に Google アシスタント プラグインをインストールする手順は次のとおりです。

  1. [ファイル] >Settings（macOS では [Android Studio] > [Preferences]）
  2. [Plugins] セクションで [Marketplace] に移動し、 「Google アシスタント プラグイン」
  3. ツールをインストールして Android Studio を再起動します。

このプラグインは、Jetbrains の公開リポジトリから直接ダウンロードすることもできます。

セットアップの要件

Google アシスタント プラグインを使用するには、 テストする必要があります特に、Android Studio、テストデバイス、Google Play Console へのアクセスで、同じユーザー アカウントを使用する必要があることにご注意ください。

以下の構成手順で開発環境を準備します。

  • Android Studio（バージョン 4.0 以降）にログインします。
  • 同じアカウントを使用して、Android テストデバイス上の Google アプリにログインします。
  • 同じアカウントを使用して、テスト対象のアップロード済みアプリ パッケージに対する Google Play Console アクセス権を取得します。
  • Android テストデバイスで Google アプリを開き、アシスタントの初回セットアップ プロセスを完了します。
  • テストデバイスでデバイスデータの同期を有効にします。

制限事項

Google アシスタント プラグインには次の制限があります。

  • ウェブ インベントリを組み込んだ App Actions およびフォアグラウンド アプリの呼び出し テストツールまたは Android Debug Bridge（adb）で直接テストできない 使用できます。そのような App Actions をテストするには、まず、テストツールを使用してプレビューを作成します。次に、物理デバイスで Google アシスタントを操作して、App Actions をトリガーします。
  • actions.intent.OPEN_APP_FEATURE BII のインライン インベントリは、プレビューの作成または更新後 6 時間だけテストできます。テストツールのプレビューを更新するか新しいプレビューを作成すると、テストが可能な期間が 6 時間にリセットされます。

テスターを追加する

プロジェクトに別のユーザーを招待して、App Actions 統合のテストに参加してもらうことができます。これは、開発チームの他のメンバーとプロジェクトを共有して一緒にテストできるようにしたいときや、製品版リリースの準備のために品質保証（QA）テスターとプロジェクトを共有したいときに便利です。テスターは、Google Play ストアでライセンス テスターとして追加し、Google Play Console への読み取り専用アクセス権を付与する必要があります。

テスターを追加する手順は次のとおりです。

  1. Google Play Console にログインします。

  2. こちらの Google Play Console ヘルプトピックの「アプリ ライセンスを設定する」に記載されている手順を実施します。

    Google Play Console からライセンス テスターを追加します。
    図 1. ライセンス テスターを追加する
    で確認できます。

  3. ライセンス テスターの Google アカウントを Google Play Console の読み取り専用アカウントとして招待する できます。

    1. [ユーザーと権限] >新しいユーザーを招待 >アプリを追加します。
    2. [アプリのアクセス権] で、[管理者（すべての権限）] チェックボックスがオフになっていることを確認します。

プレビュー テストを有効にするテスターごとに、ログインする必要があります ユーザーの Google アカウントを使用して Android Studio に個別にアクセスできます。ログインしたら、Google アシスタント プラグインを使用して、テストユーザーごとにプレビューを作成します。

Google アシスタント プラグインを使用する

Android Studio で App Actions テストツールにアクセスするには、[Tools] >Google アシスタント > App Actions テストツール。ツールを開くと、アクティブなテストツール プレビューがあるかどうかに応じて、ビューが変化します。

プレビューの作成、更新、削除を行う

アプリのドラフト版をテストに使用できます。詳しくは、リリースを準備して公開するをご覧ください。審査のためにアプリを送信する前にドラフトモードでテストします。

テストツールは、Google アカウントとアプリ パッケージ名（アプリケーション ID）に基づいてプレビューを作成するため、同じ Google アカウントで複数のアプリをテストできます。アプリケーション ID がアプリごとに異なっていれば、同じ Google アカウントをプレビューの作成とテストに使用し続けることができます。同じアプリ パッケージにアクセスできる Google アカウントが複数あれば、それぞれでテストツールを使用して、そのアプリのためのプレビューを個別に作成できます。

プレビューを作成するには、Android Studio で次の手順を実施します。

  1. App Actions テストツールを開きます。
  2. テスト用のアプリ名とロケールを入力します（省略可）。デフォルトのアプリ名とロケールは、test app action と en です。
  3. [Create Preview] をクリックします。プロンプトが表示されたら、App Actions を確認して受け入れます。 利用規約に準拠する必要があります。プレビューが作成されると、テストツールが ウィンドウが更新され、 shortcuts.xml ファイルを使用します。

テストツールは、アプリ名を使用して、App Actions のアシスタント クエリを作成し、シミュレートします。デプロイされる App Actions は、Google Play ストアのアプリ名を使用します テストツールでは任意の呼び出し名を使用できます。 ただし、 テストツールを使用します。

指定するロケールは、テストデバイスの Google アシスタントの言語と一致する必要があります。プレビューは、一度に 1 つのロケールでのみ作成できます。たとえば、アシスタントの言語が英語（米国）の場合、en-US は入力できますが、en-**、en-GB、en-US, en-GB は入力できません。次のようなルート ロケールを使用できます。 en として、en-GB と en-US の両方を含めます。

既存のプレビューのアプリ名または選択済みのロケールを変更するには、テストツールで [Delete] ボタンをクリックします。次に、新しいプレビューを作成する前に、希望するアプリ名とロケールを入力します。

既存のプレビューを shortcuts.xml ファイルに合わせて更新するには、 テストツールの [Update] ボタン。現在のプレビューに関する情報は、テストツール ウィンドウの [Test App Action] セクションにあります。

BII を設定する

アプリのプレビュー作成後に、プラグインで BII のさまざまなパラメータ値をテストできます。プラグインは、shortcuts.xml ファイル内の BII ごとに、対応する JSON-LD オブジェクトをレンダリングし、デフォルトのパラメータ値を提供します。これらのデフォルト値を変更し、意味のあるパラメータの組み合わせで App Actions をテストして、アプリの適切な機能が実行されることを確認できます。

パラメータとその値は、通常、プロパティと説明の schema.org または schema.googleapis.com 構造に従います。詳しくは、 任意の BII パラメータに関する情報を パラメータとその上位レベルのパラメータの型の説明。

BII「actions.intent.GET_FOOD_OBSERVATION」など インテント パラメータ foodObservation.forMeal をサポートしている。 「 MealType の schema.googleapis.com ページに name がリストされています プロパティです。 forMeal プロパティは転送モードであり、 列挙された MealType 型の値（MealTypeLunch など）。

使用する場合は、任意の列挙値を foodObservation.forMeal:

  • https://schema.googleapis.com/MealTypeSnack
  • https://schema.googleapis.com/MealTypeBrunch
  • https://schema.googleapis.com/MealTypeLunch
  • https://schema.googleapis.com/MealTypeBreakfast
  • https://schema.googleapis.com/MealTypeDinner
  • https://schema.googleapis.com/MealTypeDesert

App Actions をトリガーする

プレビューを作成して BII を設定したら、テストツール ウィンドウから直接テストデバイスで App Action をトリガーできます。

テストツールで App Action をトリガーする手順は次のとおりです。

  1. テストデバイスを接続します。
  2. [Select Target Device] セクションで、App Action をトリガーするデバイスを選択します。
  3. [Test App Action] セクションで、[Run App Action] ボタンをクリックします。

テストツールでトリガーされる App Actions は、表示される Android Debug Bridge（adb）コマンドを使用します。生成された adb シェルコマンドには、Google アプリが BII を実行するために必要なすべてのメタデータが含まれています。このアプローチは、アシスタントがクエリから重要な情報を抽出した後の App Action の動作を模倣しています。

Android Studio のロギング

テストツールに固有のログは、Logcat 出力としてではなく、Android Studio ログファイルとして参照できます。ワークステーション上で直接実行されるプロセスで Android Studio が生成される できます。これを使用して、テストツールの操作（作成、変換、 プレビューの作成、削除などを行えます

Android Studio ログファイルにアクセスするには、[Help] > [Show log in explorer]（macOS の場合は [Help] > [Show log in finder]）に移動します。

アプリの App Actions に関連するログは、Logcat で参照できます。Logcat は、Android Studio に接続された仮想デバイスまたは物理デバイスからログをキャプチャします。

デバイスの App Actions ログを取得する手順は次のとおりです。

  1. Android Studio のツール ウィンドウ バーで [Logcat] をクリックして、Logcat のログメッセージにアクセスします。
  2. ActivityTaskManager を含むログを検索します。

サポートとその他のリソース

Google アシスタント プラグインは、ドキュメント、Codelab、 テストツールの使い方に関する学習とサポートのその他のリソースもご紹介します。

Android Studio でアシスタントを開くには、 [ツール] >Google アシスタント >ヘルプをご覧ください。

App Actions テストツール アシスタント 図 2. Google アシスタント プラグインのヘルプ セクション