ListenableFutureUpdateInfoService

Artifact: androidx.security:security-state-provider

Added in 1.0.0

Kotlin |Java

abstract class ListenableFutureUpdateInfoService : UpdateInfoService

kotlin.Any
↳	android.content.Context
	↳	android.content.ContextWrapper
		↳	android.app.Service
			↳	androidx.security.state.provider.UpdateInfoService
				↳	androidx.security.state.provider.ListenableFutureUpdateInfoService

ListenableFuture-based compatibility wrapper around UpdateInfoService's suspending APIs.

This class is designed for Java consumers who need to implement an UpdateInfoService but prefer using Guava's ListenableFuture over Kotlin Coroutines. By extending this class, host applications can provide the actual network logic by implementing the fetchUpdatesAsync method.

Host Implementation

Host applications (such as the System Updater, Google Play Store, or OEM-specific updaters) written in Java must extend this class and implement the fetchUpdatesAsync method to provide the actual update check logic.

Kotlin consumers should generally prefer extending UpdateInfoService directly to leverage native suspending functions.

Summary

Public constructors
`ListenableFutureUpdateInfoService()`

Protected functions
`final suspend List<UpdateInfo>`	`fetchUpdates()` Satisfies the base class Coroutine requirement by delegating to the Future-based implementation.
`abstract ListenableFuture<List<UpdateInfo>>`	`fetchUpdatesAsync()` Performs the actual network request to fetch fresh updates from the backend asynchronously.

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 android.app.Service

`Unit`	`attachBaseContext(newBase: Context)`
`Unit`	`onConfigurationChanged(newConfig: Configuration)`
`Unit`	`onCreate()`
`Unit`	`onDestroy()`
`Unit`	`onLowMemory()`
`Unit`	`onRebind(intent: Intent)`
`Unit`	`onStart(intent: Intent, startId: Int)`
`Int`	`onStartCommand(intent: Intent, flags: Int, startId: Int)`
`Unit`	`onTaskRemoved(rootIntent: Intent)`
`Unit`	`onTimeout(startId: Int)`
`Unit`	`onTimeout(startId: Int, fgsType: Int)`
`Unit`	`onTrimMemory(level: Int)`
`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)`

From androidx.security.state.provider.UpdateInfoService

`open Unit`	`dump(fd: FileDescriptor?, writer: PrintWriter?, args: Array<String>?)` Dumps the state of the service for debugging (e.g. `adb shell dumpsys activity service`).
`open Int`	`getCallerUid()` Retrieves the UID of the calling process.
`final IBinder?`	`onBind(intent: Intent?)` Called by the system when a client binds to the service.
`open Unit`	`onClientConnected(packageName: String, callerUid: Int)` Called when a client successfully establishes a session with the update provider.
`open Unit`	`onClientDisconnected(packageName: String, callerUid: Int)` Called when a client explicitly closes its session or its process terminates unexpectedly.
`open Unit`	`onFetchFailed(e: Exception)` Callback for handling exceptions that occur during the update check process.
`open Unit`	`onRequestCompleted(telemetry: UpdateCheckTelemetry)` Called when a request completes.
`final Boolean`	`onUnbind(intent: Intent?)` Called by the system when all clients have disconnected from the service's factory interface.
`open Boolean`	`shouldFetchUpdates()` Determines if the local cache is stale and a refresh should be attempted.
`open Boolean`	`shouldThrottle()` Checks if the update check operation should be throttled.

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 android.app.Service

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

Public constructors