微件是自定义主屏幕的一个重要方面。您可以将它们视为应用最重要的数据和功能的“一览”视图，用户可以直接在主屏幕上访问这些视图。用户可以在其主屏幕面板间移动微件，如果系统支持，用户还可以调整微件的大小，按照他们的偏好量身定制微件中的信息量。
本文档介绍了您可以创建的各种不同类型的微件以及要遵循的设计原则。如需使用 Remote View API 和 XML 布局构建应用微件，请参阅创建简单微件。如需使用 Kotlin 和 Compose 样式的 API 构建微件，请参阅 Jetpack Glance。
微件类型
在规划微件时，请考虑要构建哪种类型的微件。微件通常属于以下某个类别：
信息微件
信息微件通常会显示关键信息元素，并跟踪该信息随时间变化的情况。信息微件的示例包括天气微件、时钟微件或体育比分跟踪微件。轻触信息微件通常会启动关联的应用，并打开微件信息的详细视图。
集合微件
集合微件专门显示同一类型的多个元素，如相册应用中的一系列图片、新闻应用中的一系列报道或通信应用中的一系列电子邮件或消息。集合微件可以垂直滚动。
集合微件通常侧重于以下用例：
- 浏览集合。
- 在关联的应用中将集合的元素打开到其详细视图。
- 与元素互动，例如将元素标记为已完成 - 在 Android 12（API 级别 31）中支持复合按钮。
控制微件
控制微件的主要目的是显示常用功能，以便用户无需打开应用即可从主屏幕触发这些功能。您可以将它们视为应用的遥控器。控制微件的一个示例是家居控制微件，可让用户打开或关闭家中的灯。
与控制微件互动可能会在应用中打开关联的详细视图。这取决于控制微件的功能是否输出任何数据，例如搜索微件。
混合微件
虽然某些微件代表前面部分中的一种类型（信息、集合或控制），但许多微件是将不同类型的元素组合在一起的混合微件。例如，音乐播放器微件主要是一个控制微件，但它也会像信息微件一样向用户显示当前正在播放的曲目。
在规划微件时，请围绕其中一种基本类型进行设计，并根据需要添加其他类型的元素。
将微件与 Google 助理集成
Google 助理可以显示任何类型的微件，以响应用户语音指令。您可以将微件配置为执行与应用有关的 App Action，让用户能够在 Google 助理界面上获得快速解答和互动式应用体验，例如 Android 和 Android Auto。 如需详细了解 Google 助理的微件执行，请参阅将与应用有关的 Action 与 Android 微件集成。
微件限制
虽然您可以将微件理解为“迷你应用”，但在设计微件之前，务必了解一些限制。
手势
由于微件位于主屏幕上，因此它们必须与在主屏幕上建立的导航共存。与全屏应用相比，这限制了微件中可用的手势支持。虽然应用可能会让用户在屏幕之间横向导航，但该手势已在主屏幕上用于在主屏幕之间导航。
只能对微件使用以下手势：轻触 和垂直滑动 。
元素
鉴于微件可用的手势存在限制，一些依赖于受限手势的界面构建基块不适用于微件。如需查看支持的构建基块的完整列表并详细了解布局限制， 请参阅 创建微件布局和提供灵活的微件 布局。
设计准则
微件内容
微件是一种很好的方式，可以“宣传”您的应用中有哪些新鲜有趣的内容，从而吸引用户使用您的应用。
就像报纸头版上的宣传语一样，微件会整合和浓缩应用的信息，并提供与应用中更丰富的详情的连接。您可以说微件是信息“零食”，而应用则是“大餐”。 请确保您的应用显示的信息项的详细程度高于微件显示的信息项。
微件导航
除了纯信息内容之外，您还可以考虑让微件提供常用应用区域的导航链接。这样不仅能让用户更快地完成任务，而且还能将应用的功能覆盖面扩展到主屏幕。
微件上导航链接的合适候选对象如下：
生成性功能 ：这些功能可让用户为应用创建新内容，如创建新文档或新消息。
在顶层打开应用 ：轻触信息元素通常会将用户导航到较低级别的详细信息屏幕。提供对应用顶层的访问可以提高导航的灵活性，并且可以取代用户用来从主屏幕导航到应用的专用应用快捷方式。如果显示的数据不明确，使用应用图标来实现此功能还可以为微件提供清晰的身份。
微件大小调整
轻触并按住可调整大小的微件，然后释放，即可将微件设为大小调整模式。用户可以通过拖动手柄或微件的角设置所需的大小。
大小调整允许用户在主屏幕放置网格的限制范围内调整微件的高度和宽度。您可以决定微件是可以自由调整大小，还是仅限于在水平或垂直方向上改变大小。如果微件本来就大小固定，则您不必支持大小调整。
允许用户调整微件的大小具有以下重要优势：
- 他们可以微调要在每个微件上看到多少信息。
- 他们可以更好地改变其主屏幕面板上的微件和快捷方式的布局。
根据您要创建的微件类型，规划微件的大小调整策略。基于列表或网格的集合微件通常很简单，因为调整微件的大小只会扩展或收缩垂直滚动区域。无论微件的大小如何，用户仍然可以将所有信息元素滚动到视图中。
信息微件需要多一点实操规划，因为它们不可滚动，并且给定的大小必须容纳得下所有内容。您必须将微件的内容和布局动态调整到用户通过大小调整操作定义的大小。
在以下示例中，用户可以通过三个步骤调整天气微件的大小，随着微件的增大，会显示有关当前位置天气的更丰富的信息。
对于每个微件大小，确定要显示的应用信息量。 对于较小的大小，请专注于基本信息，然后随着微件在水平和垂直方向上增大，添加上下文信息。
布局注意事项
您往往倾向于根据您开发时用到的设备的放置网格尺寸来布置微件。这可以作为有用的初始近似值，但请注意以下几点：
- 如果您根据不同的“大小范围”（而不是可变网格尺寸）规划微件大小调整策略，将能够获得最可靠的结果。
- 单元格的数量、大小和间距因设备而异。因此，您的微件必须灵活，并且能够容纳比预期更多或更少的空间，这一点非常重要。
- 当用户调整微件的大小时，系统会以一个 dp 大小范围（微件可以在此范围内自行重新绘制）做出响应。
- 从 Android 12 开始，您可以提供更精细的大小属性和更灵活的布局。其中包括：
- 指定微件大小 限制。例如，您可以指定微件的目标大小（以网格单元格为单位）以及最大可能大小。
- 提供自适应布局， 这些布局会根据微件的大小而变化。
- 提供 精确大小的布局，这些布局 可让启动器响应手机的竖屏和横屏 模式的大小选项，或可折叠设备的四种大小。
- 使用更新后的指南和新的 API来确定微件的合适大小 。
用户配置微件
有时，用户需要先设置微件，然后才能使用它。 以电子邮件微件为例，用户需要先选择邮件文件夹，然后才能显示收件箱；再以静态照片微件为例，用户必须指定要从图库中显示的图片。用户将 Android 微件放到主屏幕上之后，微件会立即显示其配置选项。
微件设计核对清单
- 在微件上重点显示小部分一目了然的信息。在应用中扩充信息。
- 根据用途选择合适的微件类型。
- 规划微件的内容如何适应不同的大小。
- 通过确保布局能够拉伸和收缩，使微件布局与屏幕方向和设备无关。
- 考虑微件是否需要任何其他配置。