适用于 Android Studio 的 Google 助理插件

该 Google 助理插件用于在 Android Studio 中测试与应用有关的 Action。在开发和测试期间，您可以使用该插件在 Google 助理中针对您的 Google 账号创建与应用有关的 Action 的预览。然后，您可以在提交与应用有关的 Action 进行部署之前，先测试其会如何处理各种参数。

运作方式

Google 助理插件包含与应用有关的 Action 测试工具，这项功能可解析 shortcuts.xml 文件并为单个 Google 账号创建与应用有关的 Action 的预览。这些预览可让 Google 助理在将应用的正式版部署到 Google Play 管理中心之前，识别与应用有关的 Action。

对于 shortcuts.xml 文件中的每个内置 intent (BII)，该工具会呈现对应的 JSON-LD 对象并提供默认参数值。然后，您可以修改这些值，使用具有意义的参数组合测试与应用有关的 Action，并确保它们执行正确的应用功能。在测试工具中创建、更新和删除预览，让您可以在安全的环境中迭代和测试您的与应用有关的 Action。

创建预览后，您可以直接通过测试工具窗口在测试设备上触发与应用有关的 Action。对于可供用户触发的 BII，您可以直接在设备上的 Google 助理中使用 app name 来试用与应用有关的 Action。例如，您可以通过说“Hey Google, start my exercise using Example App”，启动一个使用 actions.intent.START_EXERCISE BII 的与应用有关的 Action。

语言区域支持

在测试工具中，特定语言区域的预览创建方式因 BII 而异。在内置 intent 参考文档中，每个 BII 的页面都提供了对应 BII 可用功能的相关信息，例如测试工具是否支持为特定语言区域创建预览，以及与应用有关的 Action 是否可供用户触发。

获取该插件

Google 助理插件适用于 Android Studio。如需了解如何安装和使用 Android Studio，请参阅 Android Studio 页面。

如需在 Android Studio 中安装 Google 助理插件，请按以下步骤操作：

1. 依次点击 File > Settings（在 MacOS 中，依次点击 Android Studio > Preferences）。
2. 在Plugins部分中，点击 Marketplace，然后搜索“Google Assistant”。
3. 安装该工具，然后重启 Android Studio。

您也可以直接从 JetBrains 公开代码库下载该插件。

设置要求

若要使用 Google 助理插件，您需要完成一些配置步骤，才能成功测试您的与应用有关的 Action。具体而言，您在 Android Studio 中和测试设备上必须使用相同的用户账号，并使用同一账号访问 Google Play 管理中心。

在准备开发环境时，请进行以下配置：

• 登录 Android Studio（4.0 或更高版本）。
• 使用相同的账号登录 Android 测试设备上的 Google 应用。
• 使用相同的账号登录 Play 管理中心，然后访问要测试的已上传应用软件包。
• 在 Android 测试设备上打开 Google 应用，并完成 Google 助理的初始设置流程。
• 在测试设备上启用设备数据同步。

限制

Google 助理插件具有以下限制：

• 无法直接在测试工具中或通过 Android 调试桥 (adb) 命令测试包含网站目录和前台应用调用的与应用有关的 Action。如需测试这类与应用有关的 Action，请先使用测试工具创建预览。然后，在实体设备上通过与 Google 助理互动来触发这类与应用有关的 Action。
• 只能在创建或更新预览后的 6 小时内测试 actions.intent.OPEN_APP_FEATURE BII 的内嵌目录。只要更新测试工具预览和创建新的预览，即会重置 6 小时的时间段。

添加其他测试人员

您可以邀请其他用户加入您的项目，以便对方测试您的与应用有关的 Action 集成。当您想要与开发团队的其他成员共享项目以便他们都可以参与测试时，或当与质量检查 (QA) 测试人员共享项目以准备发布正式版时，这么做会非常有用。测试人员必须在 Google Play 商店中添加为许可测试人员，并获得对 Google Play 管理中心的只读权限。

如需添加其他测试人员，请按以下步骤操作：

1. 登录 Play 管理中心。

2. 按照此 Play 管理中心帮助主题中设置应用许可下面的说明操作。

   

   图 1. 添加许可测试人员。

   注意：此步骤将对 Google 账号授予读取和写入预览的权限。

3. 向许可测试人员的 Google 账号授予对 Google Play 管理中心的只读用户权限。

   1. 依次选择用户和权限 > 邀请新用户 > 添加应用。
   2. 在应用访问权限中，务必取消选中管理员（所有权限）复选框。

注意：测试人员必须接受邀请才能访问预览。

对于每个您想让其能够测试预览的测试人员，您必须使用该用户的 Google 账号单独登录 Android Studio。登录后，请使用 Google 助理插件为该测试用户创建预览。

使用该 Google 助理插件

在 Android Studio 中，只需依次点击 Tools > Google Assistant > App Actions test tool，即可访问与应用有关的 Action 测试工具。当您打开该工具后，视图会根据您是否拥有处于活跃状态的测试工具预览而变化。

创建、更新和删除预览

您可以使用应用的草稿版本进行测试。如需了解详情，请参阅准备工作和发布版本。在提交应用以供审核之前，先在草稿模式下进行测试。

注意：在 Android Studio 中，使用“与应用有关的 Action“”测试工具时，请搭配使用已安装在您的设备上的应用版本。

该测试工具会根据您的 Google 账号和应用软件包名称（应用 ID）创建预览，以便您可以使用同一个 Google 账号测试多个应用。只要每个应用的应用 ID 各不相同，您就可以继续使用同一 Google 账号创建预览并进行测试。若有多个 Google 账号有权访问同一应用软件包，则每个账号都可使用测试工具为该应用创建单独的预览。

注意：如果您没有处于活跃状态的预览，就必须先创建一个，然后才能使用该插件测试与应用有关的 Action。

如需创建预览，请在 Android Studio 中执行以下操作：

1. 打开与应用有关的 Action 测试工具。
2. （可选）输入应用名称和语言区域进行测试。默认的应用名称和语言区域分别为 test app action 和 en。
3. 点击 Create Preview。如果出现提示，请查看并接受与应用有关的 Action 政策和服务条款。预览创建后，测试工具窗口即会更新，以显示在您的 shortcuts.xml 文件中找到的 BII 相关信息。

测试工具使用应用名称为与应用有关的 Action 构建和模拟 Google 助理查询。已部署的与应用有关的 Action 会使用您的 Play 商店应用名称进行调用，但您可以在测试工具中使用任何调用名称。 不过，建议您在测试工具中使用应用名称作为调用名称。

您提供的语言区域必须与测试设备上的 Google 助理语言相符，并且一次只能在一个语言区域中创建预览。例如，如果 Google 助理的语言是英语（美国），则可以输入 en-US，但不能输入 en-**、en-GB 或 en-US, en-GB。您可以使用根语言区域（例如 en），以同时包含 en-GB 和 en-US。

如需更改现有预览的应用名称或所选语言区域，请点击测试工具中的 Delete 按钮。然后，输入所需的应用名称和语言区域，然后再创建新的预览。

如需更新现有的预览来匹配您的 shortcuts.xml 文件，请点击测试工具中的 Update 按钮。有关当前预览的信息，请参阅测试工具窗口的 Test App Action 部分。

注意：您对 shortcuts.xml 文件做出地更改不会自动传播到现有地预览中。您必须先在测试工具中更新预览，然后才能测试新的更改。

配置 BII

为应用创建预览后，您可以在插件中测试 BII 的各种参数值。对于 shortcuts.xml 文件中的每个 BII，该插件会呈现对应的 JSON-LD 对象并提供默认参数值。您可以修改这些默认值，使用具有意义的参数组合测试与应用有关的 Action，并确保它们执行正确的应用功能。

参数及其值通常遵循属性和说明的 schema.org 或 schema.googleapis.com 结构。您可以查找任何 BII 参数的相关信息，方法是访问参数及其更高级别参数的架构类型说明。

例如，actions.intent.GET_FOOD_OBSERVATION BII 支持 intent 参数 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

触发与应用有关的 Action

创建预览并配置 BII 后，您可以直接通过测试工具窗口在测试设备上触发与应用有关的 Action。

如需使用测试工具触发与应用有关的 Action，请执行以下操作：

1. 连接您的测试设备。
2. 在 Select Target Device 部分中，选择您想在哪个设备上触发与应用有关的 Action。
3. 在 Test App Action 部分中，点击 Run App Action 按钮。

在测试工具中触发的与应用有关的 Action 会使用显示的 Android 调试桥 (adb) 命令。生成的 adb shell 命令包含 Google 应用执行 BII 所需的所有元数据。此方法会模仿 Google 助理从查询中提取关键信息后与应用有关的 Action 的行为。

Android Studio 日志记录

Android Studio 日志文件（而非 Logcat 输出）中提供了测试工具所特有的日志。直接在工作站上运行的进程会生成 Android Studio 日志。您可以使用它们对测试工具操作进行故障排除，例如创建、更新或删除预览。

如需访问 Android Studio 日志文件，请依次点击 Help > Show log in explorer（在 MacOS 中，依次点击 Help > Show log in finder）。

Logcat 为应用提供了与应用有关的 Action 的相关日志，并且会从连接到 Android Studio 的虚拟设备或实体设备中捕获日志。

如需获取设备的与应用有关的 Action 日志，请按以下步骤操作：

1. 点击 Android Studio 工具窗口栏中的 Logcat，以访问您的 Logcat 日志消息。
2. 搜索包含 ActivityTaskManager 的日志。

获得支持和其他资源

Google 助理插件提供了各种指向文档、Codelab 和其他资源的链接，供您了解如何使用测试工具以及获取相关帮助。

您可以在 Android Studio 中依次选择 Tools > Google Assistant > Help，以打开 Google 助理。

图 2. Google 助理插件的帮助部分。