アプリ ウィジェットは構成可能です。たとえば、時計ウィジェットでは、表示するタイムゾーンをユーザーが設定できます。
ユーザーがウィジェットの設定を構成できるようにするには、ウィジェット構成 Activity を作成します。
構成アクティビティを宣言する
マニフェストで構成アクティビティを宣言し、プロバイダの XML メタデータ内でリンクすることは、ビューベースのアプリ ウィジェットと Glance ベースのアプリ ウィジェットの両方で同じです。
構成アクティビティを宣言する方法については、Glance 構成ドキュメントの Compose ファーストの構成アクティビティを宣言するセクションをご覧ください。
構成アクティビティを実装する
構成アクティビティは、プラットフォーム ランチャーによって呼び出される標準コンポーネントであるため、基本的なライフサイクル コールバックはシステムの戻り値ルールに従う必要があります。
構成アクティビティを実装する方法については、Glance ドキュメントの Compose ファーストの構成アクティビティを実装するセクションをご覧ください。
構成アクティビティからウィジェットを更新する
従来のビューベースのウィジェットでは、構成の完了時に AppWidgetManager と RemoteViews レイアウト インスタンスを使用してウィジェットを更新します。
従来のビューベースのウィジェットを構築していて、RemoteViews レイアウトを更新する必要がある場合は、GitHub の従来のビュー更新サンプルコードをご覧ください。最新の Compose ファースト ウィジェットについては、Glance ドキュメントの構成アクティビティ セクションから更新するをご覧ください。
ウィジェットの構成オプション
ウィジェットの動作（後で再構成できるようにする、初期構成の設定手順を完全にスキップするなど）は、標準の Android 12 フラグを使用してメタデータ属性内に登録されます。
動的ウィジェット オプションを活用する方法については、Glance 構成ドキュメントの Compose ファーストのウィジェット構成オプション セクションをご覧ください。
配置したウィジェットをユーザーが再設定できるようにする
再構成可能なカスタム設定トリガーを追加する方法については、Glance ドキュメントの Compose ファーストのユーザーが配置されたウィジェットを再構成できるようにするセクションをご覧ください。
ウィジェットのデフォルト設定を使用する
デフォルトで構成設定をスキップする方法については、Glance ドキュメントの Compose-first のウィジェットのデフォルト構成セクションを使用するをご覧ください。