強化小工具

本指南包含選用小工具強化功能的詳細資料，這些功能可輕鬆導入，並改善使用者的小工具體驗。

為小工具命名

小工具在小工具挑選器中顯示時，必須有不重複的名稱。

系統會從 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 屬性，但小工具挑選器會忽略該屬性。