Skip to content

Most visited

Recently visited

navigation

PackageInstaller.SessionCallback

public static abstract class PackageInstaller.SessionCallback
extends Object

java.lang.Object
   ↳ android.content.pm.PackageInstaller.SessionCallback


Events for observing session lifecycle.

A typical session lifecycle looks like this:

  • An installer creates a session to indicate pending app delivery. All install details are available at this point.
  • The installer opens the session to deliver APK data. Note that a session may be opened and closed multiple times as network connectivity changes. The installer may deliver periodic progress updates.
  • The installer commits or abandons the session, resulting in the session being finished.

Summary

Public constructors

PackageInstaller.SessionCallback()

Public methods

abstract void onActiveChanged(int sessionId, boolean active)

Active state for session has been changed.

abstract void onBadgingChanged(int sessionId)

Badging details for an existing session has changed.

abstract void onCreated(int sessionId)

New session has been created.

abstract void onFinished(int sessionId, boolean success)

Session has completely finished, either with success or failure.

abstract void onProgressChanged(int sessionId, float progress)

Progress for given session has been updated.

Inherited methods

From class java.lang.Object

Public constructors

PackageInstaller.SessionCallback

added in API level 21
PackageInstaller.SessionCallback ()

Public methods

onActiveChanged

added in API level 21
void onActiveChanged (int sessionId, 
                boolean active)

Active state for session has been changed.

A session is considered active whenever there is ongoing forward progress being made, such as the installer holding an open PackageInstaller.Session instance while streaming data into place, or the system optimizing code as the result of commit(IntentSender).

If the installer closes the PackageInstaller.Session without committing, the session is considered inactive until the installer opens the session again.

Parameters
sessionId int
active boolean

onBadgingChanged

added in API level 21
void onBadgingChanged (int sessionId)

Badging details for an existing session has changed. For example, the app icon or label has been updated.

Parameters
sessionId int

onCreated

added in API level 21
void onCreated (int sessionId)

New session has been created. Details about the session can be obtained from getSessionInfo(int).

Parameters
sessionId int

onFinished

added in API level 21
void onFinished (int sessionId, 
                boolean success)

Session has completely finished, either with success or failure.

Parameters
sessionId int
success boolean

onProgressChanged

added in API level 21
void onProgressChanged (int sessionId, 
                float progress)

Progress for given session has been updated.

Note that this progress may not directly correspond to the value reported by setStagingProgress(float), as the system may carve out a portion of the overall progress to represent its own internal installation work.

Parameters
sessionId int
progress float
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.