強化小工具

本指南將詳細說明可選用的小工具強化功能，這些功能實作簡單，可提升使用者的小工具體驗。

為小工具命名

在小工具挑選器中顯示的小工具名稱不得重複。

系統會從 AndroidManifest.xml 檔案中，小工具 receiver 元素的 label 屬性載入小工具名稱。

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

新增小工具的說明

從 Android 12 開始，請提供小工具挑選器顯示的小工具說明。

圖 1：小工具挑選器範例，顯示小工具及其說明。

使用 <appwidget-provider> 元素的 description 屬性，提供小工具的說明：

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

附註： 請簡明扼要。說明沒有字元限制，但說明內容的呈現方式和可用空間可能因裝置而異。

您可以在舊版 Android 上使用 descriptionRes 屬性，但小工具挑選器會忽略該屬性。