GlanceAppWidget を管理、更新する

以降のセクションでは、GlanceAppWidget を更新してその状態を管理する方法について説明します。

GlanceAppWidget の状態を管理する

提供されている GlanceAppWidget クラスは、ウィジェットが作成されるたび、または更新が必要になるたびにインスタンス化されるため、ステートレスで受動的である必要があります。

状態の概念は、次のように分類できます。

  • アプリの状態: ウィジェットに必要なアプリの状態またはコンテンツ。たとえば、ユーザーが定義した保存済みデスティネーションのリスト（データベースなど）。
  • Glance の状態: アプリ ウィジェットにのみ関連し 、アプリの状態を変更または影響させるとは限らない特定の状態。たとえば、ウィジェットでチェックボックスが選択された場合や、カウンターが増加した場合など。

アプリの状態を使用する

アプリ ウィジェットは受動的である必要があります。各アプリケーションは、データレイヤの管理と、ウィジェット UI に反映されるアイドル、読み込み、エラーなどの状態の処理を担当します。

たとえば、次のコードは、リポジトリ レイヤのインメモリ キャッシュからデスティネーションを取得し、保存されているデスティネーションのリストを提供して、状態に応じて異なる UI を表示します。

class DestinationAppWidget : GlanceAppWidget() {

    // ...

    @Composable
    fun MyContent() {
        val repository = remember { DestinationsRepository.getInstance() }
        // Retrieve the cache data everytime the content is refreshed
        val destinations by repository.destinations.collectAsState(State.Loading)

        when (destinations) {
            is State.Loading -> {
                // show loading content
            }

            is State.Error -> {
                // show widget error content
            }

            is State.Completed -> {
                // show the list of destinations
            }
        }
    }
}

状態またはデータが変更された場合は、アプリがウィジェットに通知して更新する必要があります。詳しくは、GlanceAppWidget を更新するをご覧ください。

GlanceAppWidget を更新する

GlanceAppWidget を使用して、ウィジェット コンテンツの更新をリクエストできます。 で説明したように、状態を管理するGlanceAppWidgetセクションでは、アプリ ウィジェットは別のプロセスでホストされます。Glance はコンテンツを実際の RemoteViews に変換してホストに送信します。コンテンツを更新するには、Glance が RemoteViews を再作成して再度送信する必要があります。

更新を送信するには、GlanceAppWidget インスタンスの update メソッドを呼び出し、context と glanceId を指定します。

MyAppWidget().update(context, glanceId)

glanceId を取得するには、GlanceAppWidgetManager をクエリします。

val manager = GlanceAppWidgetManager(context)
val widget = GlanceSizeModeWidget()
val glanceIds = manager.getGlanceIds(widget.javaClass)
glanceIds.forEach { glanceId ->
    widget.update(context, glanceId)
}

または、GlanceAppWidget update 拡張機能のいずれかを使用します。

// Updates all placed instances of MyAppWidget
MyAppWidget().updateAll(context)

// Iterate over all placed instances of MyAppWidget and update if the state of
// the instance matches the given predicate
MyAppWidget().updateIf<State>(context) { state ->
    state == State.Completed
}

これらのメソッドは、アプリケーションのどの部分からでも呼び出すことができます。suspend 関数であるため、メインスレッドのスコープ外で起動することをおすすめします。次の例では、CoroutineWorker で起動しています。

class DataSyncWorker(
    val context: Context,
    val params: WorkerParameters,
) : CoroutineWorker(context, params) {

    override suspend fun doWork(): Result {
        // Fetch data or do some work and then update all instance of your widget
        MyAppWidget().updateAll(context)
        return Result.success()
    }
}

コルーチンの詳細については、Android での Kotlin コルーチンをご覧ください。

ウィジェットを更新するタイミング

ウィジェットは、即時または定期的に更新します。

アプリが起動している場合は、ウィジェットをすぐに更新できます。例:

  • ユーザーがウィジェットを操作して、アクション、ラムダ呼び出し、アクティビティを起動するインテントをトリガーした場合。
  • ユーザーがフォアグラウンドでアプリを操作している場合、または Firebase Cloud Messaging（FCM）メッセージやブロードキャストに応答してアプリがすでに更新されている場合。

このような場合は、このガイドで説明されているように update メソッドを呼び出します。

アプリが起動していない場合は、ウィジェットを定期的に更新できます。例:

  • updatePeriodMillis を使用して、30 分に 1 回までウィジェットを更新します。
  • WorkManager を使用して、15 分ごとなど、より頻繁な更新をスケジュールします。
  • ブロードキャストに応答してウィジェットを更新します。

リソース

前へ
ウィジェットの指標を追跡する
次へ
Glance で UI を作成する