改进 widget

本指南详细介绍了可选 widget 增强功能，这些功能易于实现，可改善用户的 widget 体验。

为微件添加名称

微件在微件选择器中显示时，需要具有唯一的名称。

微件的名称是从 AndroidManifest.xml 文件中微件的 receiver 元素的 label 属性加载的。

<receiver
    ….
   android:label="Memories">
     ….
</receiver>

为微件添加说明

从 Android 12 开始，请为 widget 选择器提供说明，以便为您的 widget 显示。

图 1. 显示 widget 及其说明的示例 widget 选择器。

使用 <appwidget-provider> 元素的 description 属性为微件提供说明：

<appwidget-provider
    android:description="@string/my_widget_description">
</appwidget-provider>

注意： 应简明扼要。没有字符数限制，但说明的呈现方式和可用空间可能会因设备而异。

您可以在旧版 Android 上使用 descriptionRes 属性，但微件选择器会忽略该属性。