GlanceAppWidgetReceiver

Artifact: androidx.glance:glance-appwidget

Added in 1.0.0

abstract class GlanceAppWidgetReceiver : AppWidgetProvider

kotlin.Any
↳	android.content.BroadcastReceiver
	↳	android.appwidget.AppWidgetProvider
		↳	androidx.glance.appwidget.GlanceAppWidgetReceiver

AppWidgetProvider using the given GlanceAppWidget to generate the remote views when needed.

This should typically used as:

class MyGlanceAppWidgetProvider : GlanceAppWidgetProvider() {
  override val glanceAppWidget: GlanceAppWidget()
    get() = MyGlanceAppWidget()
}

Note: If you override any of the AppWidgetProvider methods, ensure you call their super-class implementation.

Important: if you override any of the methods of this class, you must call the super implementation, and you must not call AppWidgetProvider.goAsync, as it will be called by the super implementation. This means your processing time must be short.

Summary

Constants
`const String`	`ACTION_DEBUG_UPDATE` Action for a broadcast intent that will try to update all instances of a Glance App Widget for debugging.

Public constructors
`GlanceAppWidgetReceiver()`

Public functions
`open Unit`	`@CallSuper onAppWidgetOptionsChanged( context: Context, appWidgetManager: AppWidgetManager, appWidgetId: Int, newOptions: Bundle )`
`open Unit`	`@CallSuper onDeleted(context: Context, appWidgetIds: IntArray)`
`open Unit`	`onReceive(context: Context, intent: Intent)`
`open Unit`	`@CallSuper onUpdate( context: Context, appWidgetManager: AppWidgetManager, appWidgetIds: IntArray )`

Public properties
`open CoroutineContext`	`@ExperimentalGlanceApi coroutineContext` Override `coroutineContext` to provide custom `CoroutineContext` in which to run update requests.
`abstract GlanceAppWidget`	`glanceAppWidget` Instance of the `GlanceAppWidget` to use to generate the App Widget and send it to the `AppWidgetManager`

Inherited functions

From android.appwidget.AppWidgetProvider

`open Unit`	`onDisabled(p0: Context)`
`open Unit`	`onEnabled(p0: Context)`
`open Unit`	`onRestored(p0: Context, p1: IntArray, p2: IntArray)`

From android.content.BroadcastReceiver

`Unit`	`abortBroadcast()`
`Unit`	`clearAbortBroadcast()`
`Boolean`	`getAbortBroadcast()`
`Boolean`	`getDebugUnregister()`
`Int`	`getResultCode()`
`String`	`getResultData()`
`Bundle`	`getResultExtras(p0: Boolean)`
`open String?`	`getSentFromPackage()`
`open Int`	`getSentFromUid()`
`BroadcastReceiver.PendingResult`	`goAsync()`
`Boolean`	`isInitialStickyBroadcast()`
`Boolean`	`isOrderedBroadcast()`
`open IBinder`	`peekService(p0: Context, p1: Intent)`
`Unit`	`setDebugUnregister(p0: Boolean)`
`Unit`	`setOrderedHint(p0: Boolean)`
`Unit`	`setResult(p0: Int, p1: String, p2: Bundle)`
`Unit`	`setResultCode(p0: Int)`
`Unit`	`setResultData(p0: String)`
`Unit`	`setResultExtras(p0: Bundle)`

Constants

ACTION_DEBUG_UPDATE

const val ACTION_DEBUG_UPDATE: String

Action for a broadcast intent that will try to update all instances of a Glance App Widget for debugging.

adb shell am broadcast -a androidx.glance.appwidget.action.DEBUG_UPDATE -n APP/COMPONENT

where APP/COMPONENT is the manifest component for the GlanceAppWidgetReceiver subclass. This only works if the Receiver is exported (or the target device has adb running as root), and has androidx.glance.appwidget.DEBUG_UPDATE in its intent-filter. This should only be done for debug builds and disabled for release.

Public constructors