ウィジェットを強化する

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

ウィジェットに名前を追加する

ウィジェット ピッカーに表示されるウィジェットには、一意の名前が必要です。

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