微件质量

微件是自定义用户主屏幕的关键组件。通常,用户可以通过微件单击一下即可实现应用的关键用户历程,或快速获取重要更新的摘要。用户还可以自定义微件以根据个人偏好进行调整。

微件兼容性核对清单

微件质量会影响用户对应用内容和功能的参与度。兼容性核对清单定义了有助于您评估微件质量的标准。等级包括以下几项:

第 3 级 - 低质量

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

第 2 级 - 标准

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

第 1 级 - 差异化

这些是模范微件,可提供个性化的重要体验,并帮助用户创建独特且富有成效的主屏幕。


Tier 3 icon

第 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

微件界面不功能或内容被裁剪。

Tier 2 icon

第 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:不要创建预览不准确的微件。

Tier 1 icon

第 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 个边缘。
创建一个未填满网格边界的自定义尺寸。
提供符合微件规范的标题。
使用自定义规范设置尺寸和标题。
包含独特简洁的描述。
提供通用描述。
使用系统圆角。
设置自定义圆角。