ListenableFutureUpdateInfoService

Artifact: androidx.security:security-state-provider

Kotlin |Java

public abstract class ListenableFutureUpdateInfoService extends UpdateInfoService

java.lang.Object
↳	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 methods
`final @NonNull List<@NonNull UpdateInfo>`	`fetchUpdates()` Satisfies the base class Coroutine requirement by delegating to the Future-based implementation.
`abstract @NonNull ListenableFuture<@NonNull List<@NonNull UpdateInfo>>`	`fetchUpdatesAsync()` Performs the actual network request to fetch fresh updates from the backend asynchronously.

Inherited methods

From android.content.ComponentCallbacks

`void`	`onConfigurationChanged(@NonNull Configuration newConfig)`
`void`	`onLowMemory()`

From android.content.ComponentCallbacks2

void

onTrimMemory(int level)

From android.content.Context

`boolean`	`bindIsolatedService( @NonNull Intent service, @NonNull Context.BindServiceFlags flags, @NonNull String instanceName, @NonNull Executor executor, @NonNull ServiceConnection conn )`
`boolean`	`bindIsolatedService( @NonNull Intent service, int flags, @NonNull String instanceName, @NonNull Executor executor, @NonNull ServiceConnection conn )`
`boolean`	`bindService( @NonNull Intent service, @NonNull ServiceConnection conn, @NonNull Context.BindServiceFlags flags )`
`boolean`	`bindService( @NonNull Intent service, @NonNull ServiceConnection conn, int flags )`
`boolean`	`bindService( @NonNull Intent service, @NonNull Context.BindServiceFlags flags, @NonNull Executor executor, @NonNull ServiceConnection conn )`
`boolean`	`bindService( @NonNull Intent service, int flags, @NonNull Executor executor, @NonNull ServiceConnection conn )`
`boolean`	`bindServiceAsUser( @NonNull Intent service, @NonNull ServiceConnection conn, @NonNull Context.BindServiceFlags flags, @NonNull UserHandle user )`
`boolean`	`bindServiceAsUser( @NonNull Intent service, @NonNull ServiceConnection conn, int flags, @NonNull UserHandle user )`
`int`	`checkCallingOrSelfPermission(@NonNull String permission)`
`int`	`checkCallingOrSelfUriPermission(@NonNull Uri uri, int modeFlags)`
`@NonNull int[]`	`checkCallingOrSelfUriPermissions( @NonNull List<@NonNull Uri> uris, int modeFlags )`
`int`	`checkCallingPermission(@NonNull String permission)`
`int`	`checkCallingUriPermission(@NonNull Uri uri, int modeFlags)`
`@NonNull int[]`	`checkCallingUriPermissions(@NonNull List<@NonNull Uri> uris, int modeFlags)`
`int`	`checkContentUriPermissionFull( @NonNull Uri uri, int pid, int uid, int modeFlags )`
`int`	`checkPermission(@NonNull String permission, int pid, int uid)`
`int`	`checkSelfPermission(@NonNull String permission)`
`int`	`checkUriPermission(@NonNull Uri uri, int pid, int uid, int modeFlags)`
`int`	`checkUriPermission( @Nullable Uri uri, @Nullable String readPermission, @Nullable String writePermission, int pid, int uid, int modeFlags )`
`@NonNull int[]`	`checkUriPermissions( @NonNull List<@NonNull Uri> uris, int pid, int uid, int modeFlags )`
`void`	`clearWallpaper()` This method is deprecated. Deprecated in Java
`@NonNull Context`	`createAttributionContext(@Nullable String attributionTag)`
`@NonNull Context`	`createConfigurationContext(@NonNull Configuration overrideConfiguration)`
`@NonNull Context`	`createContext(@NonNull ContextParams contextParams)`
`@NonNull Context`	`createContextForSplit(@NonNull String splitName)`
`@NonNull Context`	`createDeviceContext(int deviceId)`
`@NonNull Context`	`createDeviceProtectedStorageContext()`
`@NonNull Context`	`createDisplayContext(@NonNull Display display)`
`@NonNull Context`	`createPackageContext(@NonNull String packageName, int flags)`
`@NonNull Context`	`createWindowContext(int type, @Nullable Bundle options)`
`@NonNull Context`	`createWindowContext( @NonNull Display display, int type, @Nullable Bundle options )`
`@NonNull String[]`	`databaseList()`
`boolean`	`deleteDatabase(@NonNull String name)`
`boolean`	`deleteFile(@NonNull String name)`
`boolean`	`deleteSharedPreferences(@NonNull String name)`
`void`	`enforceCallingOrSelfPermission( @NonNull String permission, @Nullable String message )`
`void`	`enforceCallingOrSelfUriPermission( @NonNull Uri uri, int modeFlags, @NonNull String message )`
`void`	`enforceCallingPermission( @NonNull String permission, @Nullable String message )`
`void`	`enforceCallingUriPermission( @NonNull Uri uri, int modeFlags, @NonNull String message )`
`void`	`enforcePermission( @NonNull String permission, int pid, int uid, @Nullable String message )`
`void`	`enforceUriPermission( @NonNull Uri uri, int pid, int uid, int modeFlags, @NonNull String message )`
`void`	`enforceUriPermission( @Nullable Uri uri, @Nullable String readPermission, @Nullable String writePermission, int pid, int uid, int modeFlags, @Nullable String message )`
`@NonNull String[]`	`fileList()`
`final int`	`getColor(int id)`
`final @NonNull ColorStateList`	`getColorStateList(int id)`
`@NonNull File`	`getDatabasePath(@NonNull String name)`
`@NonNull File`	`getDir(@NonNull String name, int mode)`
`final @Nullable Drawable`	`getDrawable(int id)`
`@Nullable File`	`getExternalFilesDir(@Nullable String type)`
`@NonNull File[]`	`getExternalFilesDirs(@NonNull String type)`
`@NonNull File`	`getFileStreamPath(@NonNull String name)`
`@NonNull SharedPreferences`	`getSharedPreferences(@NonNull String name, int mode)`
`final @NonNull String`	`getString(int resId)`
`final @NonNull String`	`getString(int resId, @NonNull Object... formatArgs)`
`@NonNull Object`	`getSystemService(@NonNull String name)`
`final @NonNull T`	`<T extends Object> getSystemService(@NonNull Class<@NonNull T> serviceClass)`
`String`	`getSystemServiceName(@NonNull Class<@NonNull ?> serviceClass)`
`final @NonNull CharSequence`	`getText(int resId)`
`void`	`grantUriPermission( @NonNull String toPackage, @NonNull Uri uri, int modeFlags )`
`boolean`	`moveDatabaseFrom(@NonNull Context sourceContext, @NonNull String name)`
`boolean`	`moveSharedPreferencesFrom( @NonNull Context sourceContext, @NonNull String name )`
`final @NonNull TypedArray`	`obtainStyledAttributes(@NonNull int[] attrs)`
`final @NonNull TypedArray`	`obtainStyledAttributes(int resid, @NonNull int[] attrs)`
`final @NonNull TypedArray`	`obtainStyledAttributes(@Nullable AttributeSet set, @NonNull int[] attrs)`
`final @NonNull TypedArray`	`obtainStyledAttributes( @Nullable AttributeSet set, @NonNull int[] attrs, int defStyleAttr, int defStyleRes )`
`@NonNull FileInputStream`	`openFileInput(@NonNull String name)`
`@NonNull FileOutputStream`	`openFileOutput(@NonNull String name, int mode)`
`@NonNull SQLiteDatabase`	`openOrCreateDatabase( @NonNull String name, int mode, @NonNull SQLiteDatabase.CursorFactory factory )`
`@NonNull SQLiteDatabase`	`openOrCreateDatabase( @NonNull String name, int mode, @NonNull SQLiteDatabase.CursorFactory factory, @Nullable DatabaseErrorHandler errorHandler )`
`@NonNull Drawable`	`peekWallpaper()` This method is deprecated. Deprecated in Java
`void`	`registerComponentCallbacks(@NonNull ComponentCallbacks callback)`
`void`	`registerDeviceIdChangeListener( @NonNull Executor executor, @NonNull IntConsumer listener )`
`Intent`	`registerReceiver( @Nullable BroadcastReceiver receiver, @NonNull IntentFilter filter )`
`Intent`	`registerReceiver( @Nullable BroadcastReceiver receiver, @NonNull IntentFilter filter, int flags )`
`Intent`	`registerReceiver( @Nullable BroadcastReceiver receiver, @NonNull IntentFilter filter, @Nullable String broadcastPermission, @Nullable Handler scheduler )`
`Intent`	`registerReceiver( @Nullable BroadcastReceiver receiver, @NonNull IntentFilter filter, @Nullable String broadcastPermission, @Nullable Handler scheduler, int flags )`
`void`	`removeStickyBroadcast(@NonNull Intent intent)` This method is deprecated. Deprecated in Java
`void`	`removeStickyBroadcastAsUser( @NonNull Intent intent, @NonNull UserHandle user )` This method is deprecated. Deprecated in Java
`void`	`revokeSelfPermissionOnKill(@NonNull String permName)`
`void`	`revokeSelfPermissionsOnKill( @NonNull Collection<@NonNull String> permissions )`
`void`	`revokeUriPermission(@NonNull Uri uri, int modeFlags)`
`void`	`revokeUriPermission( @NonNull String targetPackage, @NonNull Uri uri, int modeFlags )`
`void`	`sendBroadcast(@NonNull Intent intent)`
`void`	`sendBroadcast(@NonNull Intent intent, @Nullable String receiverPermission)`
`void`	`sendBroadcast( @NonNull Intent intent, @Nullable String receiverPermission, @Nullable Bundle options )`
`void`	`sendBroadcastAsUser(@NonNull Intent intent, @NonNull UserHandle user)`
`void`	`sendBroadcastAsUser( @NonNull Intent intent, @NonNull UserHandle user, String receiverPermission )`
`void`	`sendBroadcastWithMultiplePermissions( @NonNull Intent intent, @NonNull String[] receiverPermissions )`
`void`	`sendOrderedBroadcast( @NonNull Intent intent, @Nullable String receiverPermission )`
`void`	`sendOrderedBroadcast( @NonNull Intent intent, @Nullable String receiverPermission, @Nullable Bundle options )`
`void`	`sendOrderedBroadcast( @NonNull Intent intent, @Nullable String receiverPermission, @Nullable BroadcastReceiver resultReceiver, @Nullable Handler scheduler, int initialCode, @Nullable String initialData, @Nullable Bundle initialExtras )`
`void`	`sendOrderedBroadcast( @NonNull Intent intent, @Nullable String receiverPermission, @Nullable Bundle options, @Nullable BroadcastReceiver resultReceiver, @Nullable Handler scheduler, int initialCode, @Nullable String initialData, @Nullable Bundle initialExtras )`
`void`	`sendOrderedBroadcast( @NonNull Intent intent, @Nullable String receiverPermission, @Nullable String receiverAppOp, @Nullable BroadcastReceiver resultReceiver, @Nullable Handler scheduler, int initialCode, @Nullable String initialData, @Nullable Bundle initialExtras )`
`void`	`sendOrderedBroadcastAsUser( @NonNull Intent intent, @NonNull UserHandle user, @Nullable String receiverPermission, @Nullable BroadcastReceiver resultReceiver, @Nullable Handler scheduler, int initialCode, @Nullable String initialData, @Nullable Bundle initialExtras )`
`void`	`sendStickyBroadcast(@NonNull Intent intent)` This method is deprecated. Deprecated in Java
`void`	`sendStickyBroadcast(@NonNull Intent intent, @Nullable Bundle options)` This method is deprecated. Deprecated in Java
`void`	`sendStickyBroadcastAsUser(@NonNull Intent intent, @NonNull UserHandle user)` This method is deprecated. Deprecated in Java
`void`	`sendStickyOrderedBroadcast( @NonNull Intent intent, @Nullable BroadcastReceiver resultReceiver, @Nullable Handler scheduler, int initialCode, @Nullable String initialData, @Nullable Bundle initialExtras )` This method is deprecated. Deprecated in Java
`void`	`sendStickyOrderedBroadcastAsUser( @NonNull Intent intent, @NonNull UserHandle user, @Nullable BroadcastReceiver resultReceiver, @Nullable Handler scheduler, int initialCode, @Nullable String initialData, @Nullable Bundle initialExtras )` This method is deprecated. Deprecated in Java
`void`	`setTheme(int resid)`
`void`	`setWallpaper(@NonNull Bitmap bitmap)` This method is deprecated. Deprecated in Java
`void`	`setWallpaper(@NonNull InputStream data)` This method is deprecated. Deprecated in Java
`void`	`startActivities(@NonNull Intent[] intents)`
`void`	`startActivities(@NonNull Intent[] intents, @Nullable Bundle options)`
`void`	`startActivity(@NonNull Intent intent)`
`void`	`startActivity(@NonNull Intent intent, @Nullable Bundle options)`
`@Nullable ComponentName`	`startForegroundService(@NonNull Intent service)`
`boolean`	`startInstrumentation( @NonNull ComponentName className, @Nullable String profileFile, @Nullable Bundle arguments )`
`void`	`startIntentSender( @NonNull IntentSender intent, @Nullable Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags )`
`void`	`startIntentSender( @NonNull IntentSender intent, @Nullable Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, @Nullable Bundle options )`
`@Nullable ComponentName`	`startService(@NonNull Intent service)`
`boolean`	`stopService(@NonNull Intent name)`
`void`	`unbindService(@NonNull ServiceConnection conn)`
`void`	`unregisterComponentCallbacks(@NonNull ComponentCallbacks callback)`
`void`	`unregisterDeviceIdChangeListener(@NonNull IntConsumer listener)`
`void`	`unregisterReceiver(@NonNull BroadcastReceiver receiver)`
`void`	`updateServiceGroup( @NonNull ServiceConnection conn, int group, int importance )`

From android.content.ContextWrapper

`void`	`attachBaseContext(@NonNull Context newBase)`
`@NonNull Context`	`getApplicationContext()`
`@NonNull ApplicationInfo`	`getApplicationInfo()`
`@NonNull AssetManager`	`getAssets()`
`@NonNull AttributionSource`	`getAttributionSource()`
`@Nullable String`	`getAttributionTag()`
`@NonNull Context`	`getBaseContext()`
`@NonNull File`	`getCacheDir()`
`@NonNull ClassLoader`	`getClassLoader()`
`@NonNull File`	`getCodeCacheDir()`
`@NonNull ContentResolver`	`getContentResolver()`
`@NonNull File`	`getDataDir()`
`int`	`getDeviceId()`
`@Nullable Display`	`getDisplay()`
`@Nullable File`	`getExternalCacheDir()`
`@NonNull File[]`	`getExternalCacheDirs()`
`@NonNull File[]`	`getExternalMediaDirs()`
`@NonNull File`	`getFilesDir()`
`@NonNull Executor`	`getMainExecutor()`
`@NonNull Looper`	`getMainLooper()`
`@NonNull File`	`getNoBackupFilesDir()`
`@NonNull File`	`getObbDir()`
`@NonNull File[]`	`getObbDirs()`
`@NonNull String`	`getOpPackageName()`
`@NonNull String`	`getPackageCodePath()`
`@NonNull PackageManager`	`getPackageManager()`
`@NonNull String`	`getPackageName()`
`@NonNull String`	`getPackageResourcePath()`
`@Nullable ContextParams`	`getParams()`
`@NonNull Resources`	`getResources()`
`@NonNull Resources.Theme`	`getTheme()`
`@NonNull Drawable`	`getWallpaper()` This method is deprecated. Deprecated in Java
`int`	`getWallpaperDesiredMinimumHeight()` This method is deprecated. Deprecated in Java
`int`	`getWallpaperDesiredMinimumWidth()` This method is deprecated. Deprecated in Java
`boolean`	`isDeviceProtectedStorage()`
`boolean`	`isRestricted()`
`boolean`	`isUiContext()`
`void`	`sendOrderedBroadcast( @NonNull Intent intent, int initialCode, @Nullable String receiverPermission, @Nullable String receiverAppOp, @Nullable BroadcastReceiver resultReceiver, @Nullable Handler scheduler, @Nullable String initialData, @Nullable Bundle initialExtras, @Nullable Bundle options )`

From android.app.Service

`final @NonNull Application`	`getApplication()`
`final int`	`getForegroundServiceType()`
`void`	`onCreate()`
`void`	`onDestroy()`
`void`	`onRebind(@NonNull Intent intent)`
`void`	`onStart(@NonNull Intent intent, int startId)` This method is deprecated. Deprecated in Java
`int`	`onStartCommand(@NonNull Intent intent, int flags, int startId)`
`void`	`onTaskRemoved(@NonNull Intent rootIntent)`
`void`	`onTimeout(int startId)`
`void`	`onTimeout(int startId, int fgsType)`
`final void`	`startForeground(int id, @NonNull Notification notification)`
`final void`	`startForeground( int id, @NonNull Notification notification, int foregroundServiceType )`
`final void`	`stopForeground(int notificationBehavior)`
`final void`	`stopForeground(boolean removeNotification)` This method is deprecated. Deprecated in Java
`final void`	`stopSelf()`
`final void`	`stopSelf(int startId)`
`final boolean`	`stopSelfResult(int startId)`

From androidx.security.state.provider.UpdateInfoService

`void`	`dump(FileDescriptor fd, PrintWriter writer, String[] args)` Dumps the state of the service for debugging (e.g. `adb shell dumpsys activity service`).
`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.
`void`	`onClientConnected(@NonNull String packageName, int callerUid)` Called when a client successfully establishes a session with the update provider.
`void`	`onClientDisconnected(@NonNull String packageName, int callerUid)` Called when a client explicitly closes its session or its process terminates unexpectedly.
`void`	`onFetchFailed(@NonNull Exception e)` Callback for handling exceptions that occur during the update check process.
`void`	`onRequestCompleted(@NonNull UpdateCheckTelemetry telemetry)` 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.
`boolean`	`shouldFetchUpdates()` Determines if the local cache is stale and a refresh should be attempted.
`boolean`	`shouldThrottle()` Checks if the update check operation should be throttled.

Public constructors

ListenableFutureUpdateInfoService

Added in 1.0.0-beta01

public ListenableFutureUpdateInfoService()

Protected methods

fetchUpdates

protected final @NonNull List<@NonNull UpdateInfo> fetchUpdates()

Satisfies the base class Coroutine requirement by delegating to the Future-based implementation.

fetchUpdatesAsync

Added in 1.0.0-beta01

protected abstract @NonNull ListenableFuture<@NonNull List<@NonNull UpdateInfo>> fetchUpdatesAsync()

Performs the actual network request to fetch fresh updates from the backend asynchronously.

Template Method: This method is implemented by the host application (e.g., the System Updater) and invoked by the base class on a background thread. The base class handles concurrency, caching, and rate-limiting.

Preconditions: This method is only called if shouldFetchUpdates returns true and shouldThrottle returns false (the rate limiter allows the request).

Returns
`@NonNull ListenableFuture<@NonNull List<@NonNull UpdateInfo>>`	A `ListenableFuture` containing a list of `UpdateInfo` objects currently available for the device.