Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

微件质量

微件是自定义用户主屏幕的关键组件。通常，用户只需点按一下，即可通过微件完成应用的关键用户历程，或快速查看重要更新摘要。用户还可以自定义微件，以满足个人偏好。

微件兼容性核对清单

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

第 3 层级 - 质量欠佳

这些 widget 无法满足最低质量标准，并且会提供糟糕的用户体验。如果微件不符合标准布局、颜色、发现和内容标准，则会被视为低质量。

第 2 层级 - 标准版

这些微件实用、易用，可提供优质体验。如要被视为标准微件，微件必须满足以下所有布局、颜色、发现和内容条件。

第 1 层级 - 差异化

这些都是典范级微件，可提供个性化的核心体验，并帮助用户打造独特且高效的主屏幕。

第 3 层级

低质量 widget 的特征

如果您的 widget 属于以下任何一种情况，则会被视为低质量：

类别	ID	说明
布局	WL-1	当用户将 widget 放置在宿主界面上时，widget 不会填满宿主网格的边界。
布局	WL-1.1	微件未触及网格的至少 2 个对边。换句话说，微件不一定都是矩形，它们可以具有自定义形状，只要形状的边缘至少接触网格的 2 个边缘即可。
颜色	WC-3	微件文本和图标按钮的颜色对比度不足，无法满足无障碍要求。
发现	WD-4.2	微件设计中不包含微件名称。
发现	WD-4.3	微件没有预览图片。
内容	WT-3	微件内容始终过时或不及时。
	WT-3.1	用户通过微件完成操作后，微件未更新。
	WT-3.2	用户在应用内完成相关操作后，微件未更新。
	WT-4	微件界面无法正常运行或内容被剪裁。

第 2 层级

标准微件要求

符合此基准质量标准的小组件会被视为标准小组件，但不会被视为精选小组件，因此不会被推荐或展示。

类别	ID	说明
布局	WL-1	该 widget 会在垂直或水平轴上与其他宿主元素对齐，并且不会占用额外空间。
	WL-1.2	所有形状都应至少触及网格边界的 2 个相对边缘。
	WL-4	如果微件可调整大小，请定义大小下限和上限。重新排列布局，以便在微件变大时显示更多内容。请勿线性缩放文本和图标。
	WL-4.1	如果较大的微件尺寸只会增加空白空间，请设置最大宽度或高度。如果较大的 widget 会显示更多内容（例如较高的滚动列表），请允许无限制地调整大小。
	WL-4.2	微件的最小尺寸必须足够大，以便清晰展示用例，并满足 48x48 dp 的触摸目标要求。系统可以针对桌面设备或车载屏幕缩放触摸目标。
发现	WD-4	微件应在微件选择器中提供准确的预览（静态资源）。
内容	WT-1	零状态和空状态必须能够缩放到更大的微件边界，而不会出现稀疏区域。如果用户在登录前安装了该微件，则该微件必须显示一个独特的用例或号召性用语。
内容	WT-2	如果用户希望数据刷新频率高于界面刷新频率，则可以通过微件手动刷新内容。

正确做法

提供 48x48 dp 的触摸目标。

错误做法

触摸目标过小。

正确做法

确保色彩对比度足够高。

错误做法

使用色彩对比度不足的颜色。

图 1： 请勿创建预览不准确的 widget。

第 1 层级

差异化微件要求

这些微件支持高级主屏幕自定义，并将作为最佳实践推荐给用户并向开发者展示。差异化微件可提供核心体验，并被 Android 用于激发和活跃生态系统。它们符合所有差异化布局、颜色、发现和内容标准。

类别	ID	说明
布局	WL-1	该 widget 会在垂直或水平轴上与其他宿主元素对齐，并且不会占用额外空间。
	WL-1.1	所有矩形微件都必须触及网格边界的所有四个边缘。所有自定义形状微件都必须触及方形网格边界的所有 4 个边缘。如果尺寸为 4x1 且包含搜索栏，则允许仅触及 2 个边缘。
	WL-2	用户可以将该微件的大小调整为 2x1 以及以下尺寸中的至少两种：1x1、2x2、4x2、4x4。
	WL-3	使用微件标题，且应用方式保持一致。在以下情况下，我们建议使用标头：该 widget 包含滚动内容。标题内容提供有用的上下文，例如列表的名称。在以下情况下，您可以选择是否使用标头：该 widget 为全出血，例如照片 widget。名额有限。标头内容重复。如果使用标头，请确保：图标始终存在标题会在空间充足时显示操作基于 widget 上下文。
	WL-5	集合和信息流 widget 支持垂直滚动容器。在 4x2 和 4x4 等较大尺寸下，这些微件会显示更多内容，并会显示每项内容的更多详情。
颜色	WC-1	微件支持根据设备或应用上下文进行色彩主题设置。
颜色	WC-2	微件支持浅色主题和深色主题调色板。
发现	WD-1	预览会显示目标设备类型的布局比例，并包含用户内容、应用系统主题或两者兼而有之。
	WD-4.4	微件有说明，可帮助用户了解微件的价值。
	WD-4.5	微件名称具有描述性，且与应用的其他微件不同。
系统连贯性	WS-2	矩形微件必须使用系统提供的圆角半径（因 OEM 而异）。
	WS-3	该 widget 使用加载状态规范，并直接在 widget 界面上显示错误。
	WS-4	微件使用系统配置，而不是自定义微件设置入口点。
	WS-5	从微件进入/退出应用时，微件会使用系统启动过渡效果。