小部件是自定义用户主屏幕的重要组件。它们通常可以帮助用户通过一键操作完成应用的关键用户旅程,或提供应用最重要的数据摘要。它们还可以自定义以满足用户的需求并针对个人喜好进行调整。
小部件的质量决定了用户参与它的可能性。小部件质量主要分为三类
- 第 3 层:低质量 - 性能低下,过时,且未提供良好的用户体验
- 第 2 层:质量标准 - 满足所有基本需求并提供令人满意的体验
- 第 1 层:差异化 - 超出用户的基本期望并提供最佳的用户体验
第 3 层:低质量
如果小部件不满足标准布局、颜色、发现和内容标准,则被视为低质量。有关超越低质量等级的更多信息,请参阅以下指南。
第 2 层 - 质量标准
要被视为优质,小部件必须满足以下所有布局、颜色、发现和内容标准
布局
- 小部件必须填充启动器网格在主屏幕上放置时设置的边界。如果它不符合以下规范,则归类为第 3 层,低质量。
- 小部件必须正确对齐垂直或水平轴上的其他主屏幕元素,并且不占用不必要的空间
- 小部件必须接触网格的至少两个相对边。换句话说,小部件不必是矩形的,它们可以具有自定义形状,只要形状的边缘接触网格的至少两个边缘即可。
- 如果可调整大小,小部件必须具有适当的最小/最大大小,这可以通过 AppWidgetProviderInfo XML 中的 minWidth、minHeight、maxResizeWidth 和 maxResizeHeight 设置。
- 如果调整小部件的大小只会添加空白空间,则应设置最大大小。
- 应根据小部件仍然提供价值并满足触摸目标要求(48x48)的最小尺寸设置最小大小。
颜色
- 小部件文本和图标按钮必须具有足够的对比度比率以满足辅助功能要求(不包括缩略图和图像)。
发现
- 小部件必须在小部件选择器中具有准确的预览(静态资产可以)。这可以通过 AppWidgetProviderInfo XML 中的 previewImage 和 previewLayout 设置,或通过生成的预览 设置。
- 小部件预览与添加到主屏幕后将提供的功能保持一致。
内容
- 小部件内容不得始终过时或不及时。
- 用户从小部件完成操作后,小部件必须更新。
- 用户在应用内完成相关操作后,小部件必须更新。
- 如果预期数据刷新频率高于 UI,则小部件必须允许用户手动刷新内容。
- 小部件 UI 必须具有功能性,否则内容会被裁剪。
- 当小部件已安装但用户尚未登录时,小部件的零状态和空状态必须是有意的,并且必须显示小部件的价值和/或提供号召性用语。
第 1 层 - 差异化
最佳小部件满足所有第 2 层标准以及以下所有布局、颜色、发现和系统一致性标准。
布局
- 小部件填充边界并正确对齐垂直或水平轴上的其他主屏幕元素,并且不占用不必要的空间。
- 所有形状都必须接触网格边界的全部四个边缘。
小部件支持首选大小。
- 小部件可以调整为至少以下其中一个尺寸:2x2、4x2。
小部件标题已使用并始终应用。
- 如果以下情况,建议使用标题:
- 小部件包含滚动内容(列表、网格等)
- 标题内容提供有用的上下文(待办事项列表的名称)
- 标题在以下情况下是可选的:
- 小部件是全出血图像(照片)
- 空间有限(< 2 行高)
- 标题内容冗余时。
- 如果使用标题,请满足我们的规范。
- 图标、标题、操作。
- 图标始终存在。
- 当有足够的空间时,标题会出现。
- 根据小部件上下文进行操作。
- 高度 48dp,填充 14dp。
- 图标、标题、操作。
- 如果以下情况,建议使用标题:
颜色
- 小部件支持亮色和暗色模式调色板
发现
- 预览包含用户内容和/或应用系统主题(生成预览 API 或 AppWidgetProviderInfo XML 中的 previewLayout)
- 小部件具有名称或描述,帮助用户了解小部件的价值
- 名称长度少于 50 个字符
- 名称和描述在应用内唯一(例如,应用不能有多个名称相同的小部件)
系统一致性
- 矩形小部件必须使用系统提供的圆角(OEM 特定)
- 使用进度指示器显示加载状态(在具有主题颜色或品牌等效项的
initialLayout
中)
- 使用系统配置,而不是自定义小部件设置入口点
- 在进入/退出应用到小部件时使用系统启动过渡
在创建小部件时请记住本指南中提供的提示。您希望提供最佳质量和出色的用户体验。许多质量标准可以通过规范布局来满足。要详细了解质量标准,设计师请参阅Android 小部件模板,开发者请参阅平台示例中的布局代码示例和布局开发者指南。