Android Studio 專用 Google 助理外掛程式

Google 助理外掛程式會在 Android Studio 中測試應用程式動作。在開發和測試期間，您可以使用這個外掛程式，為 Google 帳戶建立 Google 助理應用程式動作預覽。然後您就可以在提交用於部署之前，先測試應用程式動作處理各種參數的方式。

運作方式

Google 助理外掛程式包含應用程式動作測試工具，此功能可以剖析 shortcuts.xml 檔案，並為單一 Google 帳戶建立應用程式動作預覽。Google 助理可透過這些預覽功能，在部署正式版應用程式至 Google Play 管理中心之前辨識您的應用程式動作。

對於 shortcuts.xml 檔案中的每個內建意圖 (BII)，工具會轉譯對應的 JSON-LD 物件並提供預設參數值。然後您就可以修改這些值，使用有意義的參數組合以測試應用程式動作，並確保這些動作能夠執行正確的應用程式函式。系統會在測試工具中建立、更新和刪除預覽，方便您在安全的環境中疊代及測試應用程式動作。

建立預覽後，您可以透過測試工具視窗在測試裝置上觸發應用程式動作。如為可供使用者觸發的 BII，您可以直接在裝置上透過 Google 助理使用 app name，以試用應用程式動作。舉例來說，您可以說「Ok Google，使用範例應用程式開始我的運動」，啟動使用 actions.intent.START_EXERCISE BII 的應用程式動作。

語言支援

在測試工具中，為特定語言代碼建立預覽會因 BII 而異。內建意圖參考資料中的每個 BII 頁面均提供該 BII 可用功能的相關資訊，例如測試工具是否支援為特定語言代碼建立預覽，以及應用程式動作是否可供使用者觸發。

取得外掛程式

Google 助理外掛程式適用於 Android Studio。如要瞭解安裝和使用 Android Studio 的資訊，請參閱 Android Studio 頁面。

如要在 Android Studio 中安裝 Google 助理外掛程式，請按照下列步驟操作：

  1. 依序前往「File」 >「Settings」 (在 macOS 則為「Android Studio」 >「Preferences」)。
  2. 在「Plugins」部分，前往「Marketplace」並搜尋「Google Assistant plugin」。
  3. 安裝工具，然後重新啟動 Android Studio。

您也可以直接從 Jetbrains 公開存放區下載此外掛程式。

設定需求條件

使用 Google 助理外掛程式需要完成特定設定步驟，才能成功測試應用程式動作。具體而言，您必須在 Android Studio、測試裝置和取得 Google Play 管理中心存取權時，使用「相同使用者帳戶」。

請使用下列設定準備開發環境：

  • 登入 Android Studio (4.0 以上版本)。
  • 使用同一個帳戶在 Android 測試裝置中登入 Google 應用程式。
  • 使用相同帳戶，取得 Play 管理中心存取權，以便存取要測試的已上傳應用程式套件。
  • 在 Android 測試裝置中開啟 Google 應用程式，完成 Google 助理初始設定程序。
  • 在測試裝置中啟用裝置資料同步處理。

限制

Google 助理外掛程式有下列限制：

  • 使用網頁廣告空間和前景應用程式叫用的應用程式動作無法直接在測試工具中測試，也無法使用 Android 偵錯橋接器 (adb) 指令測試。如要測試這類應用程式動作，請先使用測試工具建立預覽。然後在實體裝置上與 Google 助理互動，以觸發這些應用程式動作。
  • actions.intent.OPEN_APP_FEATURE BII 的內嵌目錄僅可在預覽建立或更新後六小時內測試。更新測試工具預覽或建立新預覽，即可重新計算六小時的時間範圍。

新增其他測試人員

您可以邀請其他使用者加入專案，讓他們測試應用程式動作整合情形。當您想與開發團隊的其他成員分享專案，讓他們所有人都可以進行測試，或是為準備產品推出而與品質查驗 (QA) 測試人員分享專案時，這項功能就能派上用場。您必須將測試人員新增為 Google Play 商店的「授權測試人員」，並授予 Google Play 管理中心的唯讀存取權。

如要新增其他測試人員，請按照下列步驟操作：

  1. 登入 Play 管理中心。

  2. 參閱這篇 Play 管理中心說明主題中「設定應用程式授權」一節的操作說明。

    透過 Google Play 管理中心新增授權測試人員。
    圖 1. 新增授權測試人員。

  3. 邀請授權測試人員的 Google 帳戶，做為 Google Play 管理中心的唯讀權限使用者。

    1. 依序選取「使用者和權限」>「邀請新的使用者」>「新增應用程式」。
    2. 在「App Access」(應用程式存取權) 部分中，確認已勾選「Admin (all permissions)」(管理員 (所有權限)) 核取方塊。

對於要啟用預覽測試的每個測試人員，您必須以該使用者的 Google 帳戶分別登入 Android Studio。登入後，請使用 Google 助理外掛程式，為測試使用者建立預覽。

使用 Google 助理外掛程式

依序前往「Tools」(工具) >「Google Assistant」(Google 助理) >「App Actions test tool」(應用程式動作測試工具)，即可在 Android Studio 中存取應用程式動作測試工具。開啟工具時，檢視畫面會根據您是否使用測試工具預覽而變更。

建立、更新及刪除預覽

你可以使用草稿版本的應用程式進行測試。詳情請參閱「準備及推出版本」。請先在草稿模式下測試應用程式，再送交審查。

此測試工具會根據您的 Google 帳戶和應用程式套件名稱 (應用程式 ID) 建立預覽，因此您可以使用同一個 Google 帳戶來測試多個應用程式。只要每個應用程式的 ID 都不同，您就可以繼續使用同一 Google 帳戶建立預覽和進行測試。如有多個可存取相同應用程式套件的 Google 帳戶，這些帳戶皆可使用測試工具為應用程式建立獨立預覽。

如要建立預覽，請在 Android Studio 中執行下列操作：

  1. 開啟應用程式動作測試工具。
  2. 另外可選擇輸入應用程式名稱和語言來進行測試。預設的應用程式名稱和語言為 test app action 和 en。
  3. 按一下「Create Preview」(建立預覽)。如果出現提示訊息，請詳閱並接受應用程式動作政策和服務條款。預覽建立後，測試工具視窗會更新，顯示 shortcuts.xml 檔案中的 BII 相關資訊。

測試工具使用應用程式名稱建構及模擬應用程式動作的 Google 助理查詢。已部署的應用程式動作會使用您的 Play 商店應用程式名稱進行叫用，但您可以在測試工具中使用任何叫用名稱。不過，建議您在測試工具中使用應用程式名稱做為叫用名稱。

您提供的語言代碼必須與測試裝置上的 Google 助理語言相符，而且一次只能為一個地區建立預覽。舉例來說，如果 Google 助理的語言是英文 (美國)，您可以輸入 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 物件並提供預設參數值。您可以修改這些預設值，使用有意義的參數組合測試應用程式動作，並確保這些動作能執行正確的應用程式功能。

參數及參數值通常會遵循屬性或說明的 schema.org 或 schema.googleapis.com 結構。如需取得任何 BII 參數的相關資訊，您可以存取參數的結構定義類型說明，並查看參數所對應的較高層級參數。

舉例來說，actions.intent.CREATE_MONEY_TRANSFER BII 支援意圖參數 moneyTransfer.transferMode。MoneyTransfer 的 schema.googleapis.com 頁面會將 transferMode 列為屬性。transferMode 屬性是轉移模式，且會預期已列舉類型 FinancialTransferMode 的值，例如 SendMoney。

在測試工具中，您可以提供任何一個列舉做為 transferMode 的值：

  • http://schema.googleapis.com/SendMoney
  • http://schema.googleapis.com/ReceiveMoney

觸發應用程式動作

建立預覽並設定 BII 後，就可以直接透過測試工具視窗，在測試裝置上觸發應用程式動作。

如要使用測試工具觸發應用程式動作，請按照下列步驟操作：

  1. 連結測試裝置。
  2. 在「Select Target Device」(選取目標裝置) 區段中，選擇要觸發應用程式動作的裝置。
  3. 在「測試應用程式動作」區段中，按一下「Run App Action」(執行應用程式動作 按鈕。

在測試工具中觸發的應用程式動作會使用顯示的 Android Debug Bridge (adb) 指令。產生的 adb 殼層指令會包含 Google 應用程式執行 BII 所需的所有中繼資料。這個方法會在 Google 助理擷取查詢中的重要資訊後，模擬應用程式動作的行為。

Android Studio 記錄

系統會以 Android Studio 記錄檔提供測試工具專有的記錄，而非 Logcat 輸出內容。直接在工作站上執行的程序會產生 Android Studio 記錄。可用於排解測試工具作業的問題，例如建立、更新或刪除預覽。

如要存取 Android Studio 記錄檔，請依序前往「Help」>「Show log in Explorer」 (MacOS 中則為「Help」>「Show log in finder」)。

如要查看與應用程式動作相關的記錄，請前往 Logcat。Logcat 會從與 Android Studio 連結的虛擬或實體裝置擷取記錄。

如要取得裝置的應用程式動作記錄，請按照下列步驟操作：

  1. 按一下 Android Studio 工具視窗列中的「Logcat」，存取 Logcat 記錄訊息。
  2. 搜尋包含 ActivityTaskManager 的記錄。

取得支援和其他資源

Google 助理外掛程式提供說明文件、程式碼研究室和其他資源的連結，協助您使用測試工具學習並取得協助。

您可以在 Android Studio 中依序選取「Tools」(工具) >「Google Assistant」(Google 助理) >「Help」(說明) 以開啟 Google 助理。

應用程式動作測試工具 Google 助理 圖 2.Google 助理外掛程式的說明區段。