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.Context

`boolean`	`bindIsolatedService( @NonNull Intent service, @NonNull Context.BindServiceFlags flags, @NonNull String instanceName, @NonNull Executor executor, @NonNull ServiceConnection conn )`
`final int`	`getColor(int id)`
`final @NonNull ColorStateList`	`getColorStateList(int id)`
`final Drawable`	`getDrawable(int id)`
`final @NonNull String`	`getString(int resId)`
`final @NonNull String`	`getString(int resId, @NonNull Object... formatArgs)`
`final @NonNull T`	`<T extends Object> getSystemService(@NonNull Class<@NonNull T> serviceClass)`
`final @NonNull CharSequence`	`getText(int resId)`
`@NonNull Context.BindServiceFlags`	`getUpdateableFlags()`
`final @NonNull TypedArray`	`obtainStyledAttributes(@NonNull int[] attrs)`
`final @NonNull TypedArray`	`obtainStyledAttributes(int resid, @NonNull int[] attrs)`
`final @NonNull TypedArray`	`obtainStyledAttributes(AttributeSet set, @NonNull int[] attrs)`
`final @NonNull TypedArray`	`obtainStyledAttributes( AttributeSet set, @NonNull int[] attrs, int defStyleAttr, int defStyleRes )`
`void`	`revokeSelfPermissionOnKill(@NonNull String permName)`
`void`	`sendBroadcastWithMultiplePermissions( @NonNull Intent intent, @NonNull String[] receiverPermissions )`

From android.content.ContextWrapper

`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( Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags )`
`@NonNull int[]`	`checkUriPermissions( @NonNull List<@NonNull Uri> uris, int pid, int uid, int modeFlags )`
`void`	`clearWallpaper()`
`@NonNull Context`	`createAttributionContext(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, Bundle options)`
`@NonNull Context`	`createWindowContext(@NonNull Display display, int type, 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, String message )`
`void`	`enforceCallingOrSelfUriPermission( @NonNull Uri uri, int modeFlags, @NonNull String message )`
`void`	`enforceCallingPermission(@NonNull String permission, String message)`
`void`	`enforceCallingUriPermission( @NonNull Uri uri, int modeFlags, @NonNull String message )`
`void`	`enforcePermission( @NonNull String permission, int pid, int uid, String message )`
`void`	`enforceUriPermission( @NonNull Uri uri, int pid, int uid, int modeFlags, @NonNull String message )`
`void`	`enforceUriPermission( Uri uri, String readPermission, String writePermission, int pid, int uid, int modeFlags, String message )`
`@NonNull String[]`	`fileList()`
`@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()`
`@NonNull File`	`getDatabasePath(@NonNull String name)`
`int`	`getDeviceId()`
`@NonNull File`	`getDir(@NonNull String name, int mode)`
`@Nullable Display`	`getDisplay()`
`@Nullable File`	`getExternalCacheDir()`
`@NonNull File[]`	`getExternalCacheDirs()`
`File`	`getExternalFilesDir(String type)`
`@NonNull File[]`	`getExternalFilesDirs(@NonNull String type)`
`@NonNull File[]`	`getExternalMediaDirs()`
`@NonNull File`	`getFileStreamPath(@NonNull String name)`
`@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 SharedPreferences`	`getSharedPreferences(@NonNull String name, int mode)`
`@NonNull Object`	`getSystemService(@NonNull String name)`
`String`	`getSystemServiceName(@NonNull Class<@NonNull ?> serviceClass)`
`@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
`void`	`grantUriPermission( @NonNull String toPackage, @NonNull Uri uri, int modeFlags )`
`boolean`	`isDeviceProtectedStorage()`
`boolean`	`isRestricted()`
`boolean`	`isUiContext()`
`boolean`	`moveDatabaseFrom(@NonNull Context sourceContext, @NonNull String name)`
`boolean`	`moveSharedPreferencesFrom( @NonNull Context sourceContext, @NonNull String name )`
`@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, DatabaseErrorHandler errorHandler )`
`@NonNull Drawable`	`peekWallpaper()`
`void`	`rebindService( @NonNull ServiceConnection conn, @NonNull Context.BindServiceFlags flags )`
`void`	`registerComponentCallbacks(@NonNull ComponentCallbacks callback)`
`void`	`registerDeviceIdChangeListener( @NonNull Executor executor, @NonNull IntConsumer listener )`
`Intent`	`registerReceiver( BroadcastReceiver receiver, @NonNull IntentFilter filter )`
`Intent`	`registerReceiver( BroadcastReceiver receiver, @NonNull IntentFilter filter, int flags )`
`Intent`	`registerReceiver( BroadcastReceiver receiver, @NonNull IntentFilter filter, String broadcastPermission, Handler scheduler )`
`Intent`	`registerReceiver( BroadcastReceiver receiver, @NonNull IntentFilter filter, String broadcastPermission, Handler scheduler, int flags )`
`void`	`removeStickyBroadcast(@NonNull Intent intent)`
`void`	`removeStickyBroadcastAsUser( @NonNull Intent intent, @NonNull UserHandle user )`
`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, String receiverPermission)`
`void`	`sendBroadcast( @NonNull Intent intent, String receiverPermission, Bundle options )`
`void`	`sendBroadcastAsUser(@NonNull Intent intent, @NonNull UserHandle user)`
`void`	`sendBroadcastAsUser( @NonNull Intent intent, @NonNull UserHandle user, String receiverPermission )`
`void`	`sendOrderedBroadcast(@NonNull Intent intent, String receiverPermission)`
`void`	`sendOrderedBroadcast( @NonNull Intent intent, String receiverPermission, Bundle options )`
`void`	`sendOrderedBroadcast( @NonNull Intent intent, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras )`
`void`	`sendOrderedBroadcast( @NonNull Intent intent, String receiverPermission, Bundle options, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras )`
`void`	`sendOrderedBroadcast( @NonNull Intent intent, String receiverPermission, String receiverAppOp, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras )`
`void`	`sendOrderedBroadcast( @NonNull Intent intent, int initialCode, String receiverPermission, String receiverAppOp, BroadcastReceiver resultReceiver, Handler scheduler, String initialData, Bundle initialExtras, Bundle options )`
`void`	`sendOrderedBroadcastAsUser( @NonNull Intent intent, @NonNull UserHandle user, String receiverPermission, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras )`
`void`	`sendStickyBroadcast(@NonNull Intent intent)`
`void`	`sendStickyBroadcast(@NonNull Intent intent, Bundle options)`
`void`	`sendStickyBroadcastAsUser(@NonNull Intent intent, @NonNull UserHandle user)`
`void`	`sendStickyOrderedBroadcast( @NonNull Intent intent, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras )`
`void`	`sendStickyOrderedBroadcastAsUser( @NonNull Intent intent, @NonNull UserHandle user, BroadcastReceiver resultReceiver, Handler scheduler, int initialCode, String initialData, Bundle initialExtras )`
`void`	`setTheme(int resid)`
`void`	`setWallpaper(@NonNull Bitmap bitmap)`
`void`	`setWallpaper(@NonNull InputStream data)`
`void`	`startActivities(@NonNull Intent[] intents)`
`void`	`startActivities(@NonNull Intent[] intents, Bundle options)`
`void`	`startActivity(@NonNull Intent intent)`
`void`	`startActivity(@NonNull Intent intent, Bundle options)`
`ComponentName`	`startForegroundService(@NonNull Intent service)`
`boolean`	`startInstrumentation( @NonNull ComponentName className, String profileFile, Bundle arguments )`
`void`	`startIntentSender( @NonNull IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags )`
`void`	`startIntentSender( @NonNull IntentSender intent, Intent fillInIntent, int flagsMask, int flagsValues, int extraFlags, Bundle options )`
`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`	`updateServiceBindings( @NonNull Collection<@NonNull Context.UpdateBindingParams> params )`
`void`	`updateServiceGroup( @NonNull ServiceConnection conn, int group, int importance )`

From android.app.Service

`void`	`attachBaseContext(@NonNull Context newBase)`
`final @NonNull Application`	`getApplication()`
`final int`	`getForegroundServiceType()`
`void`	`onConfigurationChanged(@NonNull Configuration newConfig)`
`void`	`onCreate()`
`void`	`onDestroy()`
`void`	`onLowMemory()`
`void`	`onRebind(@NonNull Intent intent)`
`void`	`onStart(@NonNull Intent intent, int startId)`
`int`	`onStartCommand(@NonNull Intent intent, int flags, int startId)`
`void`	`onTaskRemoved(@NonNull Intent rootIntent)`
`void`	`onTimeout(int startId)`
`void`	`onTimeout(int startId, int fgsType)`
`void`	`onTrimMemory(int level)`
`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)`
`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.