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