Android Studio 的历程

为 Android Studio 创建 Journey 可让您使用自然语言描述每个测试（称为 Journey）的步骤和断言，从而轻松编写和维护端到端测试。通过利用 Gemini 的视觉和推理能力，以自然语言编写的步骤会转换为 Gemini 在应用中执行的操作，从而使您能够轻松编写和理解自己的历程。此外，您还可以编写和描述更复杂的断言，Gemini 会根据其在设备上看到的内容评估这些断言，以确定您的测试流程是通过还是失败。

由于 Gemini 会推理出要执行哪些操作才能实现目标，因此即使应用布局或行为发生细微变化，历程也能更可靠地运行，从而在针对不同版本的应用和不同的设备配置运行时，减少测试不稳定的情况。

直接在 Android Studio 中针对任何本地或远程 Android 设备编写和运行历程。IDE 提供全新的编辑器体验，可用于设计用户体验历程，还提供丰富的搜索结果，可帮助您更好地了解 Gemini 的推理过程以及用户体验历程的执行情况。

撰写游记

Android Studio 提供了一个文件模板和全新的编辑器体验，可让您轻松创建和修改旅程。使用 XML 语法编写用户体验历程，以整理用户体验历程说明和步骤。

如需创建并开始修改历程，请执行以下操作：

  1. 在 Android Studio 的 Project 面板中，右键点击要为其编写历程的应用模块。
  2. 依次选择 New > Test > Journey File。
  3. 在随即显示的对话框中，提供用户体验历程的名称和说明。
  4. 点击 OK。Android Studio 会创建一个 XML 文件，其中包含您选择的旅程名称。您可以使用代码视图直接修改 XML，也可以使用设计视图获得更出色的修改体验。
  5. 在设计视图中查看客户转化历程时，请使用文本字段描述客户转化历程的每个步骤。每个步骤都可以包含您希望 Gemini 执行的描述性操作，也可以包含您希望 Gemini 评估的断言。
  6. 按键盘上的 Enter 键，即可在同一旅程中开始新的提示。您可以根据需要，针对要定义的客户转化历程的每个步骤重复此操作。

撰写旅程的技巧

以详细且有条理的方式编写旅程，可以提高 Gemini 以更确定的方式准确运行预期旅程的可能性。以下提示有助于您更有效地编写历程： * 将断言与操作分开：Gemini 会不断评估应用的状态，以确定应用是否处于“正确”状态，从而继续执行历程。不过，您可能需要将更复杂的断言定义为单独的步骤。 此外，请使用“验证”“断言”或“检查”等关键短语开头，让 Gemini 知道此步骤旨在进行断言。 * 通过滑动操作指示 Gemini：除了点按或键盘输入等基本互动方式外，Gemini 还支持需要滑动屏幕才能完成的操作。例如，如需滚动浏览内容或关闭某些界面，只需描述滑动操作的方向和意图即可。默认情况下，Gemini 从屏幕中心滑动，但您可以引导它在设备屏幕的不同部分滑动。 * 避免复杂的互动和配置变更：Gemini 目前不支持所有互动和配置变更，例如多指手势、屏幕旋转或折叠操作。我们的团队正在努力提升 Gemini 的能力。

运行您的旅程

您可以像运行任何其他插桩测试一样，在任何可用的本地或远程设备上运行您的历程，并且 Android Studio 会生成丰富的结果，帮助您了解历程的执行情况。

如需测试转化路径，请执行以下操作：

  1. 从主工具栏中选择目标设备，就像运行插桩测试时一样。
  2. 找到要测试的历程 XML 文件，然后在编辑器中将其打开。
  3. 在编辑器中，执行以下某项操作：
    1. 如果您处于设计视图中，请点击 Run Journey。
    2. 如果您处于代码视图中，请点击 XML 中定义相应历程名称的位置旁边的装订线中的 运行 。

Android Studio 会为您创建 Journeys Test 配置，并在目标设备上运行该配置。在执行过程中，Android Studio 会构建并部署您的应用，并连接到 Gemini 以确定在体验的每个步骤中应采取的操作。

在运行历程时，编辑器中还会显示有限的结果，例如屏幕截图、采取的操作以及在历程中执行每个步骤期间的推理。只需将鼠标悬停在编辑器中的缩略图上，即可查看更多信息。这有助于您在旅程中迭代提示。

查看结果

当 Android Studio 完成对您的旅程的测试后，系统会自动显示测试结果面板，向您展示测试结果。

与您可能在 Android Studio 中运行的其他插桩测试相比，用户历程的结果显示方式存在一些差异。

  • 测试面板会将历程分解为各个离散的步骤。您可以点击每个步骤，详细了解 Gemini 的执行方式。
  • 结果面板会显示丰富的信息，帮助您了解 Gemini 如何理解和推理您的旅程，以及如何执行该旅程。
  • 在步骤中的每个操作中，都会显示发送给 Gemini 的屏幕截图，以提供视觉辅助。
  • 每张屏幕截图旁边都描述了所采取的每项操作以及 Gemini 采取相应操作的原因。
  • 步骤中的每项操作都已编号。

已知问题

  • 测试历程时，系统会默认授予应用的所有权限。
  • 在搭载 Android 15（API 级别 35）的设备上测试某个历程时，您可能会在设备上看到一条警告，指出“AndroidX Crawler”的“不安全应用已被屏蔽”。您可以点击仍要安装以绕过此检查。 或者，您也可以配置设备上的开发者选项，然后停用验证通过 USB 安装的应用选项。
  • 目前，在项目面板的 Android 视图中，不会显示旅程文件。如需查看项目中的历程文件，请使用 Project 视图。
  • 如果一个转化路径中的多个操作共用完全相同的提示，则转化路径编辑器中显示的测试结果可能不正确。具体而言，所有包含重复提示的操作都将显示与该提示的最新更新实例相关联的测试结果。为解决此问题，请确保每个操作都有唯一的提示，例如通过添加不同的前缀或后缀来实现。
  • 在全新模拟器上第二次加载键盘时，会显示触控笔弹出式窗口。此弹出式窗口通常会导致与文本字段互动的测试失败。如果出现这种情况，请关闭弹出式窗口并重新运行相应流程。
  • 应用爬虫工件有时可能会出现在代理推理中。
  • 旅程执行偶尔会失败，并显示 IllegalStateException。发生这种情况时，您可以点击测试结果查看完整错误。

  • 如果未在顶级 build.gradle 文件中定义 Android Gradle 插件 (com.android.application)，则在运行历程时可能会看到以下错误：

    Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'

    如需解决此问题，请确保插件已在顶级 build.gradle 文件中定义。如需了解详情，请参阅配置 Android 构建系统。