GlanceWearWidgetService

abstract class GlanceWearWidgetService : LifecycleService

kotlin.Any
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.Service
			↳	androidx.lifecycle.LifecycleService
				↳	androidx.glance.wear.GlanceWearWidgetService

Service used for communication between the Host and a Widget Provider.

This should be typically used as:

class MyGlanceWearWidgetService : GlanceWearWidgetService() {
    override val widget: GlanceWearWidget = MyGlanceWearWidget()
}

Summary

Constants
`const String`	`ACTION_BIND_WIDGET_PROVIDER` Intent action for binding to a Widget Service.

Public constructors
`GlanceWearWidgetService()`

Public functions
`final IBinder?`	`onBind(intent: Intent)`
`open Unit`	`@CallSuper onCreate()`
`open Unit`	`@CallSuper onDestroy()`
`open Int`	`@CallSuper onStartCommand(intent: Intent?, flags: Int, startId: Int)`

Public properties
`abstract GlanceWearWidget`	`widget` Instance of `GlanceWearWidget` associated with this provider.

Inherited functions

From android.content.Context

`Boolean`	`bindIsolatedService( service: Intent, flags: Context.BindServiceFlags, instanceName: String, executor: Executor, conn: ServiceConnection )`
`Int`	`getColor(id: Int)`
`ColorStateList`	`getColorStateList(id: Int)`
`Drawable?`	`getDrawable(id: Int)`
`String`	`getString(resId: Int)`
`String`	`getString(resId: Int, vararg formatArgs: Any)`
`T`	`<T : Any> getSystemService(serviceClass: Class<T>)`
`CharSequence`	`getText(resId: Int)`
`TypedArray`	`obtainStyledAttributes(attrs: IntArray)`
`TypedArray`	`obtainStyledAttributes(resid: Int, attrs: IntArray)`
`TypedArray`	`obtainStyledAttributes(set: AttributeSet?, attrs: IntArray)`
`TypedArray`	`obtainStyledAttributes( set: AttributeSet?, attrs: IntArray, defStyleAttr: Int, defStyleRes: Int )`
`Unit`	`revokeSelfPermissionOnKill(permName: String)`
`Unit`	`sendBroadcastWithMultiplePermissions( intent: Intent, receiverPermissions: Array<String> )`

From android.content.ContextWrapper

`Boolean`	`bindIsolatedService( service: Intent, flags: Int, instanceName: String, executor: Executor, conn: ServiceConnection )`
`Boolean`	`bindService( service: Intent, conn: ServiceConnection, flags: Context.BindServiceFlags )`
`Boolean`	`bindService(service: Intent, conn: ServiceConnection, flags: Int)`
`Boolean`	`bindService( service: Intent, flags: Context.BindServiceFlags, executor: Executor, conn: ServiceConnection )`
`Boolean`	`bindService( service: Intent, flags: Int, executor: Executor, conn: ServiceConnection )`
`Boolean`	`bindServiceAsUser( service: Intent, conn: ServiceConnection, flags: Context.BindServiceFlags, user: UserHandle )`
`Boolean`	`bindServiceAsUser( service: Intent, conn: ServiceConnection, flags: Int, user: UserHandle )`
`Int`	`checkCallingOrSelfPermission(permission: String)`
`Int`	`checkCallingOrSelfUriPermission(uri: Uri, modeFlags: Int)`
`IntArray`	`checkCallingOrSelfUriPermissions(uris: MutableList<Uri>, modeFlags: Int)`
`Int`	`checkCallingPermission(permission: String)`
`Int`	`checkCallingUriPermission(uri: Uri, modeFlags: Int)`
`IntArray`	`checkCallingUriPermissions(uris: MutableList<Uri>, modeFlags: Int)`
`Int`	`checkContentUriPermissionFull(uri: Uri, pid: Int, uid: Int, modeFlags: Int)`
`Int`	`checkPermission(permission: String, pid: Int, uid: Int)`
`Int`	`checkSelfPermission(permission: String)`
`Int`	`checkUriPermission(uri: Uri, pid: Int, uid: Int, modeFlags: Int)`
`Int`	`checkUriPermission( uri: Uri?, readPermission: String?, writePermission: String?, pid: Int, uid: Int, modeFlags: Int )`
`IntArray`	`checkUriPermissions( uris: MutableList<Uri>, pid: Int, uid: Int, modeFlags: Int )`
`Unit`	`clearWallpaper()`
`Context`	`createAttributionContext(attributionTag: String?)`
`Context`	`createConfigurationContext(overrideConfiguration: Configuration)`
`Context`	`createContext(contextParams: ContextParams)`
`Context`	`createContextForSplit(splitName: String)`
`Context`	`createDeviceContext(deviceId: Int)`
`Context`	`createDeviceProtectedStorageContext()`
`Context`	`createDisplayContext(display: Display)`
`Context`	`createPackageContext(packageName: String, flags: Int)`
`Context`	`createWindowContext(type: Int, options: Bundle?)`
`Context`	`createWindowContext(display: Display, type: Int, options: Bundle?)`
`Array<String>`	`databaseList()`
`Boolean`	`deleteDatabase(name: String)`
`Boolean`	`deleteFile(name: String)`
`Boolean`	`deleteSharedPreferences(name: String)`
`Unit`	`enforceCallingOrSelfPermission(permission: String, message: String?)`
`Unit`	`enforceCallingOrSelfUriPermission( uri: Uri, modeFlags: Int, message: String )`
`Unit`	`enforceCallingPermission(permission: String, message: String?)`
`Unit`	`enforceCallingUriPermission(uri: Uri, modeFlags: Int, message: String)`
`Unit`	`enforcePermission(permission: String, pid: Int, uid: Int, message: String?)`
`Unit`	`enforceUriPermission( uri: Uri, pid: Int, uid: Int, modeFlags: Int, message: String )`
`Unit`	`enforceUriPermission( uri: Uri?, readPermission: String?, writePermission: String?, pid: Int, uid: Int, modeFlags: Int, message: String? )`
`Array<String>`	`fileList()`
`File`	`getDatabasePath(name: String)`
`File`	`getDir(name: String, mode: Int)`
`File?`	`getExternalFilesDir(type: String?)`
`Array<File>`	`getExternalFilesDirs(type: String)`
`File`	`getFileStreamPath(name: String)`
`SharedPreferences`	`getSharedPreferences(name: String, mode: Int)`
`Any`	`getSystemService(name: String)`
`String?`	`getSystemServiceName(serviceClass: Class<*>)`
`Unit`	`grantUriPermission(toPackage: String, uri: Uri, modeFlags: Int)`
`Boolean`	`moveDatabaseFrom(sourceContext: Context, name: String)`
`Boolean`	`moveSharedPreferencesFrom(sourceContext: Context, name: String)`
`FileInputStream`	`openFileInput(name: String)`
`FileOutputStream`	`openFileOutput(name: String, mode: Int)`
`SQLiteDatabase`	`openOrCreateDatabase( name: String, mode: Int, factory: SQLiteDatabase.CursorFactory )`
`SQLiteDatabase`	`openOrCreateDatabase( name: String, mode: Int, factory: SQLiteDatabase.CursorFactory, errorHandler: DatabaseErrorHandler? )`
`Drawable`	`peekWallpaper()`
`Unit`	`rebindService(conn: ServiceConnection, flags: Context.BindServiceFlags)`
`Unit`	`registerComponentCallbacks(callback: ComponentCallbacks)`
`Unit`	`registerDeviceIdChangeListener(executor: Executor, listener: IntConsumer)`
`Intent?`	`registerReceiver(receiver: BroadcastReceiver?, filter: IntentFilter)`
`Intent?`	`registerReceiver( receiver: BroadcastReceiver?, filter: IntentFilter, flags: Int )`
`Intent?`	`registerReceiver( receiver: BroadcastReceiver?, filter: IntentFilter, broadcastPermission: String?, scheduler: Handler? )`
`Intent?`	`registerReceiver( receiver: BroadcastReceiver?, filter: IntentFilter, broadcastPermission: String?, scheduler: Handler?, flags: Int )`
`Unit`	`removeStickyBroadcast(intent: Intent)`
`Unit`	`removeStickyBroadcastAsUser(intent: Intent, user: UserHandle)`
`Unit`	`revokeSelfPermissionsOnKill(permissions: MutableCollection<String>)`
`Unit`	`revokeUriPermission(uri: Uri, modeFlags: Int)`
`Unit`	`revokeUriPermission(targetPackage: String, uri: Uri, modeFlags: Int)`
`Unit`	`sendBroadcast(intent: Intent)`
`Unit`	`sendBroadcast(intent: Intent, receiverPermission: String?)`
`Unit`	`sendBroadcast(intent: Intent, receiverPermission: String?, options: Bundle?)`
`Unit`	`sendBroadcastAsUser(intent: Intent, user: UserHandle)`
`Unit`	`sendBroadcastAsUser( intent: Intent, user: UserHandle, receiverPermission: String? )`
`Unit`	`sendOrderedBroadcast(intent: Intent, receiverPermission: String?)`
`Unit`	`sendOrderedBroadcast( intent: Intent, receiverPermission: String?, options: Bundle? )`
`Unit`	`sendOrderedBroadcast( intent: Intent, receiverPermission: String?, resultReceiver: BroadcastReceiver?, scheduler: Handler?, initialCode: Int, initialData: String?, initialExtras: Bundle? )`
`Unit`	`sendOrderedBroadcast( intent: Intent, receiverPermission: String?, options: Bundle?, resultReceiver: BroadcastReceiver?, scheduler: Handler?, initialCode: Int, initialData: String?, initialExtras: Bundle? )`
`Unit`	`sendOrderedBroadcast( intent: Intent, receiverPermission: String?, receiverAppOp: String?, resultReceiver: BroadcastReceiver?, scheduler: Handler?, initialCode: Int, initialData: String?, initialExtras: Bundle? )`
`Unit`	`sendOrderedBroadcast( intent: Intent, initialCode: Int, receiverPermission: String?, receiverAppOp: String?, resultReceiver: BroadcastReceiver?, scheduler: Handler?, initialData: String?, initialExtras: Bundle?, options: Bundle? )`
`Unit`	`sendOrderedBroadcastAsUser( intent: Intent, user: UserHandle, receiverPermission: String?, resultReceiver: BroadcastReceiver?, scheduler: Handler?, initialCode: Int, initialData: String?, initialExtras: Bundle? )`
`Unit`	`sendStickyBroadcast(intent: Intent)`
`Unit`	`sendStickyBroadcast(intent: Intent, options: Bundle?)`
`Unit`	`sendStickyBroadcastAsUser(intent: Intent, user: UserHandle)`
`Unit`	`sendStickyOrderedBroadcast( intent: Intent, resultReceiver: BroadcastReceiver?, scheduler: Handler?, initialCode: Int, initialData: String?, initialExtras: Bundle? )`
`Unit`	`sendStickyOrderedBroadcastAsUser( intent: Intent, user: UserHandle, resultReceiver: BroadcastReceiver?, scheduler: Handler?, initialCode: Int, initialData: String?, initialExtras: Bundle? )`
`Unit`	`setTheme(resid: Int)`
`Unit`	`setWallpaper(bitmap: Bitmap)`
`Unit`	`setWallpaper(data: InputStream)`
`Unit`	`startActivities(intents: Array<Intent>)`
`Unit`	`startActivities(intents: Array<Intent>, options: Bundle?)`
`Unit`	`startActivity(intent: Intent)`
`Unit`	`startActivity(intent: Intent, options: Bundle?)`
`ComponentName?`	`startForegroundService(service: Intent)`
`Boolean`	`startInstrumentation( className: ComponentName, profileFile: String?, arguments: Bundle? )`
`Unit`	`startIntentSender( intent: IntentSender, fillInIntent: Intent?, flagsMask: Int, flagsValues: Int, extraFlags: Int )`
`Unit`	`startIntentSender( intent: IntentSender, fillInIntent: Intent?, flagsMask: Int, flagsValues: Int, extraFlags: Int, options: Bundle? )`
`ComponentName?`	`startService(service: Intent)`
`Boolean`	`stopService(name: Intent)`
`Unit`	`unbindService(conn: ServiceConnection)`
`Unit`	`unregisterComponentCallbacks(callback: ComponentCallbacks)`
`Unit`	`unregisterDeviceIdChangeListener(listener: IntConsumer)`
`Unit`	`unregisterReceiver(receiver: BroadcastReceiver)`
`Unit`	`updateServiceBindings( params: MutableCollection<Context.UpdateBindingParams> )`
`Unit`	`updateServiceGroup(conn: ServiceConnection, group: Int, importance: Int)`

From androidx.lifecycle.LifecycleService

open Unit

@CallSuper
onStart(intent: Intent?, startId: Int)

This function is deprecated. Deprecated in Java

From android.app.Service

`Unit`	`attachBaseContext(newBase: Context)`
`Unit`	`dump(fd: FileDescriptor, writer: PrintWriter, args: Array<String>)`
`Unit`	`onConfigurationChanged(newConfig: Configuration)`
`Unit`	`onLowMemory()`
`Unit`	`onRebind(intent: Intent)`
`Unit`	`onTaskRemoved(rootIntent: Intent)`
`Unit`	`onTimeout(startId: Int)`
`Unit`	`onTimeout(startId: Int, fgsType: Int)`
`Unit`	`onTrimMemory(level: Int)`
`Boolean`	`onUnbind(intent: Intent)`
`Unit`	`startForeground(id: Int, notification: Notification)`
`Unit`	`startForeground( id: Int, notification: Notification, foregroundServiceType: Int )`
`Unit`	`stopForeground(notificationBehavior: Int)`
`Unit`	`stopForeground(removeNotification: Boolean)`
`Unit`	`stopSelf()`
`Unit`	`stopSelf(startId: Int)`
`Boolean`	`stopSelfResult(startId: Int)`

Inherited properties

From android.content.Context

open Context.BindServiceFlags

updateableFlags

From android.content.ContextWrapper

`open Context`	`applicationContext`
`open ApplicationInfo`	`applicationInfo`
`open AssetManager`	`assets`
`open AttributionSource`	`attributionSource`
`open String?`	`attributionTag`
`open Context`	`baseContext`
`open File`	`cacheDir`
`open ClassLoader`	`classLoader`
`open File`	`codeCacheDir`
`open ContentResolver`	`contentResolver`
`open File`	`dataDir`
`open Int`	`deviceId`
`open Display`	`display`
`open File?`	`externalCacheDir`
`open Array<File>`	`externalCacheDirs`
`open Array<File>`	`externalMediaDirs`
`open File`	`filesDir`
`open Boolean`	`isDeviceProtectedStorage`
`open Boolean`	`isRestricted`
`open Boolean`	`isUiContext`
`open Executor`	`mainExecutor`
`open Looper`	`mainLooper`
`open File`	`noBackupFilesDir`
`open File`	`obbDir`
`open Array<File>`	`obbDirs`
`open String`	`opPackageName`
`open String`	`packageCodePath`
`open PackageManager`	`packageManager`
`open String`	`packageName`
`open String`	`packageResourcePath`
`open ContextParams?`	`params`
`open Resources`	`resources`
`open Resources.Theme`	`theme`
`open Drawable`	`wallpaper`
`open Int`	`wallpaperDesiredMinimumHeight`
`open Int`	`wallpaperDesiredMinimumWidth`

From androidx.lifecycle.LifecycleService

open Lifecycle

lifecycle

From android.app.Service

`Application`	`application`
`Int`	`foregroundServiceType`

Constants

ACTION_BIND_WIDGET_PROVIDER

const val ACTION_BIND_WIDGET_PROVIDER: String

Intent action for binding to a Widget Service.

Public constructors

GlanceWearWidgetService

Added in 1.0.0-alpha18

GlanceWearWidgetService()

Public functions

onBind

Added in 1.0.0-alpha18

final fun onBind(intent: Intent): IBinder?

onCreate

@CallSuper
open fun onCreate(): Unit

onDestroy

@CallSuper
open fun onDestroy(): Unit

onStartCommand

@CallSuper
open fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int

Public properties

Added in 1.0.0-alpha18

abstract val widget: GlanceWearWidget

Instance of GlanceWearWidget associated with this provider.

Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Last updated 2026-09-09 UTC.