微件质量

微件是自定义用户主屏幕的关键组件。通常,用户只需轻按一下微件,即可完成应用的关键用户历程,或快速了解重要更新的摘要。用户还可以自定义微件,使其符合个人偏好。

微件兼容性核对清单

微件质量会影响用户与应用内容和功能的互动。兼容性核对清单定义了一些标准,可帮助您评估微件的质量。层级包括以下几种:

第 3 层级低质量图标

第 3 层级 - 低质量

这些微件未能达到最低质量标准,用户体验较差。如果微件不符合标准布局、颜色、发现和内容标准,则会被视为低质量。

第 2 层级标准图标

第 2 层级 - 标准版

这些微件实用、可用,并提供优质体验。如需被视为标准微件,微件必须符合以下所有布局、颜色、发现和内容标准。

第 1 层级差异化图标

第 1 层级 - 差异化

这些是模范微件,可提供个性化的精彩体验,并帮助用户打造独特且高效的主屏幕。


第 3 层级低质量图标

第 3 层级

低质量微件的特征

如果您的微件符合以下任何描述,则会被视为低质量:

类别 ID 说明
布局 WL-1

微件在主屏幕上放置后,不会填充启动器网格设置的边界。

WL-1.1

微件不会触及网格的至少 2 个相对边缘。换句话说,微件不一定都是矩形,它们可以具有自定义形状,只要形状的边缘触及网格的至少 2 个边缘即可。

颜色 WC-3

微件文本和图标按钮的颜色对比度不足,无法满足无障碍功能要求

发现 WD-4.2

微件设计中未包含微件名称。

WD-4.3

微件没有预览图片。

内容 WT-3

微件内容始终过时或不及时。

WT-3.1

用户在微件中完成操作后,微件不会更新。

WT-3.2

用户在应用内完成相关操作后,微件不会更新。

WT-4

微件界面无法正常运行或内容被裁剪。

第 2 层级标准图标

第 2 层级

标准微件的要求

达到此基准质量标准的微件会被视为标准微件,但不会被视为将展示或推荐的展示微件。

类别 ID 说明
布局 WL-1

微件在垂直或水平轴上与其他主屏幕元素正确对齐,并且不会占用不必要的空间。

WL-1.2

所有形状都应触及网格边界的至少 2 个相对边缘。

WL-4

如果微件可调整大小,则必须具有适当的最小和最大尺寸。

WL-4.1

如果调整微件大小只会添加空白空间,则应设置最大尺寸。

WL-4.2

微件的最小尺寸仍应提供价值并满足触摸目标要求 (48x48)。

发现 WD-4

微件应在微件选择器中提供准确的预览(静态资源)。

内容 WT-1

零状态和空状态是故意的,用于在安装微件但用户尚未登录时显示微件的价值和/或提供号召性用语。

WT-2

如果用户希望数据刷新频率高于界面,微件允许用户手动刷新内容。

提供 48x48 dp 的触摸目标。
触摸目标过小。
确保足够的颜色对比度。
使用颜色对比度不足的颜色。
图 1: 请勿创建预览不准确的微件。

第 1 层级差异化图标

第 1 层级

差异化微件的要求

这些微件支持高级主屏幕自定义,并将作为最佳实践推荐给用户并展示给开发者。差异化微件可提供精彩体验,Android 会利用它们来启发和振兴生态系统。它们符合所有差异化布局、颜色、发现和内容标准。

类别 ID 说明
布局 WL-1

微件在垂直或水平轴上与其他主屏幕元素正确对齐,并且不会占用不必要的空间。

WL-1.1

所有矩形微件都必须触及网格边界的所有四个边缘。所有自定义形状的微件都必须触及方形网格边界的所有 4 个边缘。如果尺寸为 4x1 且包含搜索栏,则允许仅触及 2 个边缘。

WL-2

微件可以调整为以下至少一种尺寸:2x2、4x1、4x2。

WL-3

微件标头已使用并一致应用。

  • 如果出现以下情况,我们建议使用标头:
    • 微件包含滚动内容。
    • 标头内容提供实用的背景信息,例如列表的名称。
  • 在以下情况下,是否使用标头是可选的:
    • 微件是全宽的,例如照片微件。
    • 空间有限。
    • 标头内容是多余的。
  • 如果使用标头,请确保:
    • 图标始终存在
    • 有足够的空间时显示标题
    • 操作基于微件上下文。
颜色 WC-1

微件支持基于设备或应用上下文的颜色主题。

WC-2

微件支持浅色主题和深色主题调色板。

发现 WD-1

预览包含用户内容和/或应用系统主题。

WD-4.4

微件具有说明,可帮助用户了解微件的价值。

WD-4.5

微件名称具有描述性,并且与应用的其他微件不同。

系统一致性 WS-2

矩形微件必须使用系统提供的圆角半径(特定于 OEM)。

WS-3

微件使用加载状态规范。

WS-4

微件使用系统配置,而不是自定义微件设置入口点。

WS-5

从微件进入/退出应用时,微件使用系统启动过渡。

让微件扩展到网格边界的所有 4 个边缘。
创建不填充网格边界的自定义尺寸。
提供符合微件规范的标头。
对尺寸和标题使用自定义规范。
添加简明扼要且独特的说明。
提供通用说明。
使用系统圆角半径。
设置自定义圆角半径。