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 助理外掛程式。」
  3. 安裝工具,然後重新啟動 Android Studio。

您也可以直接從 Jetbrains 公開存放區

設定需求條件

使用 Google 助理外掛程式需要完成特定設定步驟, 以便順利測試應用程式動作。特別是,您必須使用 Android Studio、測試裝置和 Google Play 的相同使用者帳戶 存取 Cloud 控制台

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

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

限制

Google 助理外掛程式有以下限制:

  • 包含網站目錄的應用程式動作 和前景應用程式叫用 無法直接在測試工具或 Android Debug Bridge (adb) 中測試 指令。如要測試這類應用程式動作,請先使用測試建立預覽 如果偏好在終端機視窗中工作 可使用 Google Cloud CLI gcloud 指令列工具然後在實體裝置上與 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. 在「應用程式存取權」中,確認「管理員 (所有權限)」核取方塊已勾選 已清除。
,瞭解如何調查及移除這項存取權。

對於要啟用預覽測試的每個測試人員,您必須登入 透過該使用者的 Google 帳戶單獨套用到 Android Studio。登入後,請使用 Google 助理外掛程式,為測試使用者建立預覽

使用 Google 助理外掛程式

依序前往「Tools」>「Tools」工具>,即可在 Android Studio 中使用應用程式動作測試工具Google 助理 > 應用程式動作測試工具。開啟工具時,檢視畫面會根據 您是否有使用中的測試工具預覽。

建立、更新及刪除預覽

您可以使用草稿版本應用程式進行測試。如需更多資訊 請參閱「準備及推出版本」。請先在草稿模式下測試應用程式 並送交審查。

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

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

  1. 開啟應用程式動作測試工具。
  2. 另外可選擇輸入應用程式名稱和語言來進行測試。預設 應用程式名稱和語言代碼為 test app actionen
  3. 按一下「Create Preview」。看到系統提示時,請詳閱並接受應用程式動作政策和服務條款。預覽建立完成後,測試工具 視窗更新,以便顯示在您的 shortcuts.xml 檔案。

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

您提供的語言代碼必須與裝置上的 Google 助理語言相符 測試裝置,而且一次只能為一個語言代碼建立預覽。舉例來說,如果 Google 助理的語言是英文 (美國),您可以輸入 en-US,但不能輸入 en-**en-GBen-US, en-GB。您可以使用根語言代碼,例如 做為 en,以同時包含 en-GBen-US

如要變更現有預覽的應用程式名稱或所選語言代碼,請按一下 測試工具中的「Delete」按鈕。然後輸入新的應用程式名稱和語言,再建立新的預覽。

如要更新與 shortcuts.xml 檔案相符的現有預覽,請按一下 測試工具中的「Update」按鈕。你目前的相關資訊 您可以在測試工具視窗的「Test App Action」部分找到預覽。

設定 BII

為應用程式建立預覽後,即可測試各種參數 新增 BII 的值若為 在 shortcuts.xml 檔案,外掛程式會轉譯相對應的 JSON-LD 物件,並提供預設參數值。您可以修改 預設值,使用有意義的參數組合測試應用程式動作 並確保應用程式功能正常運作

參數及參數值通常會遵循屬性或說明的 schema.orgschema.googleapis.com 結構。您可以 透過存取 及其較高層級的參數的型別說明。

舉例來說,actions.intent.GET_FOOD_OBSERVATION BII 支援意圖參數 foodObservation.forMealMealTypeschema.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

觸發應用程式動作

建立預覽並設定 BII 後,即可觸發 直接在測試工具視窗中顯示測試裝置上的應用程式動作。

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

  1. 連結測試裝置。
  2. 在「Select Target Device」部分,選擇要的裝置 觸發應用程式動作。
  3. 在「Test App Action」部分,點選「Run App Action」按鈕。

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

Android Studio 記錄

如要查看測試工具專屬的記錄,請前往 Android Studio 記錄檔 (而非 Logcat) 輸出內容直接在工作站上執行的程序會產生 Android Studio 記錄。您可以運用這些函式排解測試工具作業的問題,例如建立、 更新或刪除預覽內容

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

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

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

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

取得支援和其他資源

Google 助理外掛程式提供說明文件、程式碼研究室、 和其他學習資源與測試工具

您可以在 Android Studio 中依序選取「Tools」>「Google Assistant」>「Help」,開啟 Google 助理。

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