ウィジェットを強化する

このガイドでは、実装が簡単で、ユーザーのウィジェット エクスペリエンスを向上させる、オプションのウィジェット拡張機能について詳しく説明します。

ウィジェットに名前を付ける

ウィジェットをウィジェット選択ツールに表示するには、一意の名前を付ける必要があります。

ウィジェットの名前は、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 属性を使用することはできますが、ウィジェット選択ツールでは無視されます。