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