测试 Health Connect 的顶级用例

您有责任测试您的应用并确保用户获得积极且一致的体验。Health Connect 建议使用一系列测试用例，这些测试用例旨在符合最佳实践和用户体验指南。

如果您使用跟踪器来监控测试周期中的进度，您可以在列表中添加它们，并根据您的应用需求进行自定义。

01：通过入门流程请求权限

详细信息
说明每次用户首次安装健康和健身应用时，他们必须完成入门流程以将应用与 Health Connect 集成。
需求手机上必须安装 Health Connect 应用。
备注如果您的应用可以显示与 Health Connect 的集成状态，您可以从那里查看它。
参考 新 Health Connect 用户

步骤

  1. 打开您的应用。
  2. 转到宣传卡、模态框、设置屏幕或类似的屏幕，这些屏幕允许用户首次与 Health Connect 集成。
  3. 按照应用中指示的步骤打开入门屏幕。
  4. 在入门屏幕上，点击开始。
  5. 在理由屏幕上，切换允许所有以启用为您的应用列出的权限。
  6. 点击允许授予权限。

预期结果

Onboarding flow

通过和失败条件

通过 如果满足以下所有条件

  • 用户将被带到理由屏幕，其中包含所有必需的读写权限。
  • 授予的权限在 Health Connect 应用中正确反映。

失败 由于以下任何原因

  • 用户未被带到理由页面，其中包含所有必需的读写权限。
  • 授予的权限未在 Health Connect 应用中正确反映。

02-01：尝试在卸载时与 Health Connect 集成

详细信息
说明当用户决定将数据同步到 Health Connect，但 Health Connect 应用被卸载时，应用必须有一种方法来告知用户如何安装 Health Connect 应用。最好是让应用直接在 Google Play 商店中加载 Health Connect 页面以安装它。
需求手机上必须没有安装 Health Connect 应用。

步骤

  1. 打开您的应用。
  2. 导航到应用的设置屏幕（或类似的屏幕），其中包含与 Health Connect 集成的选项。
  3. 选择安装 Health Connect。

预期结果

Attempt to integrate with Health Connect while uninstalled

通过和失败条件

通过 如果满足以下所有条件

  • 应用的设置屏幕（或类似的屏幕）必须有一个与 Health Connect 集成的功能。
  • 用户必须被带到 Google Play 商店中的 Health Connect 页面。

失败 由于以下任何原因

  • 在应用的设置屏幕或任何类似的屏幕中都没有与 Health Connect 集成的途径。
  • 用户未被带到 Google Play 商店中的 Health Connect 页面。

02-02：通过您的应用与 Health Connect 集成

详细信息
说明当用户决定将数据同步到 Health Connect 且 Health Connect 应用程序已安装时，应用程序必须提供一种方法来告知用户如何与 Health Connect 集成。它必须引导用户进入 Health Connect 应用程序。
需求手机上必须安装 Health Connect 应用。

步骤

  1. 打开您的应用。
  2. 导航到应用的设置屏幕（或类似的屏幕），其中包含与 Health Connect 集成的选项。
  3. 选择与 Health Connect 集成。

预期结果

Integrate with Health Connect through your app

通过和失败条件

通过 如果满足以下所有条件

  • 应用的设置屏幕（或类似的屏幕）必须有一个与 Health Connect 集成的功能。
  • 点击与 Health Connect 集成的选项必须引导您进入 Health Connect 应用程序。

失败 由于以下任何原因

  • 应用程序的 **设置** 屏幕或任何类似屏幕中没有与 Health Connect 集成的功能。
  • 点击与 Health Connect 集成的选项不会引导您进入 Health Connect 应用程序。

02-03：通过您的应用程序从 Health Connect 解除链接

详细信息
说明当用户决定停止使用 Health Connect 时，应用程序必须提供一种方法来从 Health Connect 解除链接。

它必须通过应用程序撤销所有权限，有效地从 Health Connect 中移除集成。

需求手机上必须安装 Health Connect 应用。
参考 PermissionController.revokeAllPermissions

步骤

  1. 打开您的应用。
  2. 导航到应用程序的 **设置** 屏幕（或类似屏幕），其中它有从 Health Connect 解除链接的选项。
  3. 选择从 Health Connect 解除链接。

预期结果

Unlink from Health Connect through your app

通过和失败条件

通过 如果满足以下所有条件

  • 应用程序的 **设置** 屏幕（或类似屏幕）必须具有从 Health Connect 解除链接的功能。
  • 在您的应用程序下列出的所有权限都必须被撤销。

失败 由于以下任何原因

  • 在应用程序的 **设置** 屏幕或任何类似屏幕中没有办法从 Health Connect 解除链接。
  • 在您的应用程序下列出的至少一项权限没有被撤销。

03：通过您的应用程序设置访问 Health Connect 应用程序

详细信息
说明当用户决定管理 Health Connect 时，应用程序必须提供一种方法来引导用户进入 Health Connect 应用程序。
需求

  • 手机上必须安装 Health Connect 应用。
  • 您的应用程序必须与 Health Connect 集成。

备注这是一个可选的用户界面功能，因为用户也可以通过手机的 **设置**、配置后的 **快速设置** 或通过 Google Play 商店直接访问 Health Connect。
参考 您设置菜单中的选项

步骤

  1. 打开您的应用。
  2. 导航到应用程序的 **设置** 屏幕（或类似屏幕），其中它有访问 Health Connect 应用程序的选项。
  3. 选择访问或管理 Health Connect。

预期结果

Access Health Connect from your app's settings

通过和失败条件

通过 如果满足以下所有条件

  • 应用程序的 **设置** 屏幕（或类似屏幕）必须提供一种方法来访问 Health Connect 应用程序。

失败 由于以下任何原因

  • 在应用程序的 **设置** 屏幕或任何类似屏幕中没有办法访问 Health Connect 应用程序。

04-01：拒绝权限

详细信息
说明当用户撤销权限时，应用程序不得读取或写入 Health Connect 的特定记录。
需求

  • 手机上必须安装 Health Connect 应用。
  • 所有权限必须在测试之前授予。

备注

  • 如果您的应用程序有办法反映被拒绝的权限，请从那里也进行检查。
  • 如果您的应用程序仍然可以从 Health Connect 读取数据，则应用程序在调用 ReadRecordsRequest 时必须使用 dataOriginFilter。

步骤

  1. 打开 Health Connect 应用程序。
  2. 转到 **应用程序权限**。
  3. 选择您的应用程序。
  4. 切换 **允许全部** 开关以拒绝权限。
  5. 当对话框出现时，选择 **移除全部**。

预期结果

Deny permissions through the Health Connect app

通过和失败条件

通过 如果满足以下所有条件

  • 在 **应用程序权限** 下，您的应用程序必须出现在 **不允许访问** 下。
  • 没有授予权限。
  • 这些权限更改在您的应用程序中生效。
  • 您的应用程序没有崩溃。

失败 由于以下任何原因

  • 在 **应用程序权限** 下，您的应用程序没有出现在 **不允许访问** 下，仍然在 **允许访问** 下。
  • 至少一项权限仍然被授予。
  • 这些权限更改没有在您的应用程序中生效。
  • 您的应用程序崩溃了。

04-02：允许权限

详细信息
说明当用户授予权限时，应用程序必须读取或写入 Health Connect 的特定记录。
需求

  • 手机上必须安装 Health Connect 应用。
  • 所有权限必须在测试之前撤销。

备注如果您的应用程序有办法反映允许的权限，请从那里也进行检查。

步骤

  1. 打开 Health Connect 应用程序。
  2. 转到 **应用程序权限**。
  3. 选择您的应用程序。
  4. 切换 **允许全部** 开关以允许权限。

预期结果

Allow permissions through the Health Connect app

通过和失败条件

通过 如果满足以下所有条件

  • 在 **应用程序权限** 下，您的应用程序必须出现在 **允许访问** 下。
  • 所有权限都已授予。
  • 这些权限更改在您的应用程序中生效。
  • 您的应用程序没有崩溃。

失败 由于以下任何原因

  • 在 **应用程序权限** 下，您的应用程序没有出现在 **允许访问** 下，仍然在 **不允许访问** 下。
  • 至少一项权限仍然被撤销。
  • 这些权限更改没有在您的应用程序中生效。
  • 您的应用程序崩溃了。

05：将数据写入 Health Connect

详细信息
说明常见工作流程的一部分是将数据写入 Health Connect 数据存储。
需求对于您的应用程序，必须授予所需数据类型的 **写入权限**。
参考 写入数据

步骤

  1. 使用您的应用程序记录所需数据类型的值。
  2. 打开 Health Connect 应用程序。
  3. 选择 **数据和访问**。
  4. 选择所需数据类型所属的类别。
  5. 选择所需数据类型。
  6. 在 **管理数据** 下，选择 **查看所有条目**。

预期结果

Write data through your app

通过和失败条件

通过 如果满足以下所有条件

  • 新数据反映在 Health Connect 应用程序中。

失败 由于以下任何原因

  • 新数据没有反映在 Health Connect 应用程序中。

06：从 Health Connect 读取数据

详细信息
说明常见工作流程的一部分是从 Health Connect 数据存储读取数据。
需求

  • 您已安装了 Health Connect 工具箱应用程序。
  • 对于 Health Connect 工具箱应用程序，必须授予所需数据类型的 **写入权限**。
  • 对于您的应用程序，必须授予所需数据类型的 **读取权限**，除非您正在为您的 dataOriginFilter 使用您的应用程序包名。

参考 读取原始数据

步骤

  1. 使用 Health Connect 工具箱应用程序记录所需数据类型的值。
  2. 检查 Health Connect 应用程序以查看是否反映了它。
    1. 打开 Health Connect 应用程序。
    2. 选择 **数据和访问**。
    3. 选择所需数据类型所属的类别。
    4. 选择所需数据类型。
    5. 在 **管理数据** 下，选择 **查看所有条目**。
  3. 使用您的应用程序读取数据。

预期结果

Read data from your app

通过和失败条件

通过 如果满足以下所有条件

  • 新数据必须反映在 Health Connect 应用程序和您的应用程序中。

失败 由于以下任何原因

  • 新数据没有反映在 Health Connect 应用程序或您的应用程序中。

07：从 Health Connect 读取聚合数据

详细信息
说明常见工作流程的一部分是从 Health Connect 数据存储读取数据。

在大多数应用程序中，数据被聚合以用于显示统计信息或图表等目的。

需求

  • 您已安装了 Health Connect 工具箱应用程序。
  • 对于 Health Connect 工具箱应用程序，必须授予所需数据类型的 **写入权限**。
  • 对于您的应用程序，必须授予所需数据类型的 **读取权限**，除非您正在为您的 dataOriginFilter 使用您的应用程序包名。

备注聚合数据可能因 timeRangeFilter 和 dataOriginFilter 中使用的值而异。
参考 读取聚合数据

步骤

  1. 在 Health Connect 工具箱应用程序中记录所需数据类型的多个值。
  2. 检查 Health Connect 应用程序以查看是否反映了它们。
    1. 打开 Health Connect 应用程序。
    2. 选择 **数据和访问**。
    3. 选择所需数据类型所属的类别。
    4. 选择所需数据类型。
    5. 在 **管理数据** 下，选择 **查看所有条目**。
  3. 使用您的应用程序读取和聚合数据。

预期结果

Read aggregated data from your app

通过和失败条件

通过 如果满足以下所有条件

  • 新值反映在 Health Connect 应用程序中。
  • 聚合值反映在您的应用程序中。

失败 由于以下任何原因

  • 新值没有反映在 Health Connect 应用程序中。
  • 聚合值没有反映在您的应用程序中。

08：从 Health Connect 更新数据

详细信息
说明常见工作流程的一部分是从 Health Connect 数据存储更新数据。

更新对于同步和导入数据等场景是必要的。

需求对于您的应用程序，必须授予所需数据类型的 **写入权限**。
参考 更新数据

步骤

  1. 使用您的应用程序更新所需数据类型的值。
  2. 打开 Health Connect 应用程序。
  3. 选择 **数据和访问**。
  4. 选择所需数据类型所属的类别。
  5. 选择所需数据类型。
  6. 在 **管理数据** 下，选择 **查看所有条目**。

预期结果

Update data through your app

通过和失败条件

通过 如果满足以下所有条件

  • 更新的值反映在 Health Connect 应用程序中。

失败 由于以下任何原因

  • 更新的值没有反映在 Health Connect 应用程序中。

09：显示来自 Health Connect 的更新数据

详细信息
说明常见工作流程的一部分是从 Health Connect 数据存储更新数据。

有一些查看应用程序可以显示来自其他源应用程序的数据。源应用程序将数据存储在 Health Connect 中，而查看应用程序从那里提取数据。

需求

  • 您已安装了 Health Connect 工具箱应用程序。
  • 对于 Health Connect 工具箱应用程序，必须授予所需数据类型的 **写入权限**。
  • 对于您的应用程序，必须授予所需数据类型的 **读取权限**，除非您正在为您的 dataOriginFilter 使用您的应用程序包名。

步骤

  1. 使用 Health Connect 工具箱应用程序更新您选择的数据类型的值。
  2. 检查 Health Connect 应用程序以查看是否反映了它们。
    1. 打开 Health Connect 应用程序。
    2. 选择 **数据和访问**。
    3. 选择所需数据类型所属的类别。
    4. 选择所需数据类型。
    5. 在 **管理数据** 下，选择 **查看所有条目**。
  3. 使用您的应用程序读取数据。

预期结果

Display updated data from your app

通过和失败条件

通过 如果满足以下所有条件

  • 更新的值反映在 Health Connect 应用程序和您的应用程序中。

失败 由于以下任何原因

  • 更新的值没有反映在 Health Connect 应用程序或您的应用程序中。

10：从 Health Connect 删除数据

详细信息
说明常见工作流程的一部分是从 Health Connect 数据存储删除数据。
需求对于您的应用程序，必须授予所需数据类型的 **写入权限**。
参考 删除数据

步骤

  1. 使用您的应用程序删除所需数据类型的值。
  2. 打开 Health Connect 应用程序。
  3. 选择 **数据和访问**。
  4. 选择所需数据类型所属的类别。
  5. 选择所需数据类型。
  6. 在 **管理数据** 下，选择 **查看所有条目**。

预期结果

Delete data through your app

通过和失败条件

通过 如果满足以下所有条件

  • 删除的值没有反映在 Health Connect 应用程序中。

失败 由于以下任何原因

  • 删除的值仍然反映在 Health Connect 应用程序中。