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 助理外掛程式,請按照下列步驟操作:
- 前往「File」>「Settings」 (在 macOS 中則為「Android Studio」>「Preferences」)。
- 在「Plugins」部分,前往「Marketplace」並搜尋 「Google 助理外掛程式。」
- 安裝工具,然後重新啟動 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 管理中心的唯讀存取權。
如要新增其他測試人員,請按照下列步驟操作:
- 登入 Play 管理中心。
請按照下方「設定應用程式授權」一節中的指示操作。 Play 管理中心說明主題。
,瞭解如何調查及移除這項存取權。邀請授權測試人員的 Google 帳戶做為 Google Play 管理中心的唯讀權限 內容。
- 選取「使用者和權限 >」邀請新的使用者 >新增應用程式。
- 在「應用程式存取權」中,確認「管理員 (所有權限)」核取方塊已勾選 已清除。
對於要啟用預覽測試的每個測試人員,您必須登入 透過該使用者的 Google 帳戶單獨套用到 Android Studio。登入後,請使用 Google 助理外掛程式,為測試使用者建立預覽。
使用 Google 助理外掛程式
依序前往「Tools」>「Tools」工具>,即可在 Android Studio 中使用應用程式動作測試工具Google 助理 > 應用程式動作測試工具。開啟工具時,檢視畫面會根據 您是否有使用中的測試工具預覽。
建立、更新及刪除預覽
您可以使用草稿版本應用程式進行測試。如需更多資訊 請參閱「準備及推出版本」。請先在草稿模式下測試應用程式 並送交審查。
測試工具會根據 Google 帳戶和應用程式套件名稱建立預覽 (應用程式 ID),因此您可以使用同一組 Google 帳戶。只要每個應用程式的 ID 都不同,您就可以繼續使用同一 Google 帳戶建立預覽和進行測試。如有多個可存取相同應用程式套件的 Google 帳戶,這些帳戶皆可使用測試工具為應用程式建立獨立預覽。
如要建立預覽,請在 Android Studio 中執行下列操作:
- 開啟應用程式動作測試工具。
- 另外可選擇輸入應用程式名稱和語言來進行測試。預設
應用程式名稱和語言代碼為
test app action
和en
。 - 按一下「Create Preview」。看到系統提示時,請詳閱並接受應用程式動作政策和服務條款。預覽建立完成後,測試工具 視窗更新,以便顯示在您的 shortcuts.xml 檔案。
測試工具會使用應用程式名稱建構及模擬 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 檔案,外掛程式會轉譯相對應的 JSON-LD 物件,並提供預設參數值。您可以修改 預設值,使用有意義的參數組合測試應用程式動作 並確保應用程式功能正常運作
參數及參數值通常會遵循屬性或說明的 schema.org
或 schema.googleapis.com
結構。您可以
透過存取
及其較高層級的參數的型別說明。
舉例來說,actions.intent.GET_FOOD_OBSERVATION
BII 支援意圖參數 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
觸發應用程式動作
建立預覽並設定 BII 後,即可觸發 直接在測試工具視窗中顯示測試裝置上的應用程式動作。
如要使用測試工具觸發應用程式動作,請按照下列步驟操作:
- 連結測試裝置。
- 在「Select Target Device」部分,選擇要的裝置 觸發應用程式動作。
- 在「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 連結的虛擬或實體裝置擷取記錄
如要取得裝置的應用程式動作記錄,請按照下列步驟操作:
- 按一下 Android Studio 中的「Logcat」來存取 Logcat 記錄訊息 工具視窗列
- 搜尋包含
ActivityTaskManager
的記錄。
取得支援和其他資源
Google 助理外掛程式提供說明文件、程式碼研究室、 和其他學習資源與測試工具
您可以在 Android Studio 中依序選取「Tools」>「Google Assistant」>「Help」,開啟 Google 助理。
圖 2. Google 助理外掛程式的說明區段。