Zarządzanie aplikacją GlanceAppWidget i ich aktualizowanie

W sekcjach poniżej opisano, jak aktualizować GlanceAppWidget i zarządzać jego stanem.

Zarządzaj stanem GlanceAppWidget

Podana klasa GlanceAppWidget jest tworzona za każdym razem, gdy widżet jest tworzony lub wymaga aktualizacji, więc powinna być bezstanowa i pasywna.

Koncepcję stanu można podzielić na:

  • Stan aplikacji: stan lub zawartość aplikacji wymagana przez widżet. Na przykład lista zapisanych miejsc docelowych (czyli baza danych) zdefiniowana przez użytkownika.
  • Stan Glance: konkretny stan, który dotyczy tylko widżetu aplikacji i nie musi modyfikować ani wpływać na stan aplikacji. Na przykład w widżecie zaznaczono pole wyboru lub zwiększono wartość licznika.

Używanie stanu aplikacji

Widżety aplikacji powinny być pasywne. Każda aplikacja odpowiada za zarządzanie warstwą danych i obsługę stanów, takich jak bezczynność, wczytywanie i błąd, które są odzwierciedlane w interfejsie widżetu.

Na przykład ten kod pobiera miejsca docelowe z pamięci podręcznej pamięci RAM z warstwy repozytorium, udostępnia zapisaną listę miejsc docelowych i wyświetla inny interfejs w zależności od stanu:

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
            }
        }
    }
}

Za każdym razem, gdy stan lub dane ulegną zmianie, aplikacja musi powiadomić i zaktualizować widżet. Więcej informacji znajdziesz w sekcji Aktualizowanie GlanceAppWidget.

Aktualizacja reguły GlanceAppWidget

Możesz poprosić o zaktualizowanie treści widżetu za pomocą GlanceAppWidget. Jak wyjaśniono w sekcji Zarządzanie stanem GlanceAppWidget, widżety aplikacji są hostowane w innym procesie. Glance tłumaczy treści na rzeczywiste RemoteViews i wysyła je do hosta. Aby zaktualizować treść, Glance musi ponownie utworzyć RemoteViews i wysłać je jeszcze raz.

Aby wysłać aktualizację, wywołaj metodę update instancji GlanceAppWidget, podając context i glanceId:

MyAppWidget().update(context, glanceId)

Aby uzyskać glanceId, wyślij zapytanie do GlanceAppWidgetManager:

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

Możesz też użyć jednego z tych rozszerzeń 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
}

Te metody można wywoływać z dowolnej części aplikacji. Ponieważ są to funkcje suspend, zalecamy uruchamianie ich poza zakresem wątku głównego. W tym przykładzie są one uruchamiane w 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()
    }
}

Więcej informacji o współprogramach znajdziesz w artykule Współprogramy Kotlin na Androidzie.

Kiedy aktualizować widżety

Aktualizuj widżety natychmiast lub okresowo.

Widżet może się aktualizować natychmiast, gdy aplikacja jest aktywna. Przykład:

  • gdy użytkownik wchodzi w interakcję z widżetem, wywołując działanie, wywołanie lambda lub zamiar uruchomienia aktywności;
  • gdy użytkownik wchodzi w interakcję z aplikacją na pierwszym planie lub gdy aplikacja jest już aktualizowana w odpowiedzi na wiadomość lub komunikat z Komunikacji w chmurze Firebase (FCM).

W takich przypadkach wywołaj metodę update zgodnie z opisem w tym przewodniku.

Widżet może okresowo się aktualizować, gdy aplikacja nie jest aktywna. Przykład:

  • Użyj updatePeriodMillis, aby aktualizować widżet maksymalnie raz na 30 minut.
  • Użyj WorkManager, aby zaplanować częstsze aktualizacje, np. co 15 minut.
  • Zaktualizuj widżet w odpowiedzi na transmisję.

Zasoby

Wstecz
Śledzenie danych widżetu
Dalej
Tworzenie interfejsu użytkownika za pomocą Glance