DevicePolicyManager.InstallSystemUpdateCallback

public static abstract class DevicePolicyManager.InstallSystemUpdateCallback
extends Object

java.lang.Object
   ↳ android.app.admin.DevicePolicyManager.InstallSystemUpdateCallback


Callback used in DevicePolicyManager.installSystemUpdate(ComponentName, Uri, Executor, InstallSystemUpdateCallback) to indicate that there was an error while trying to install an update.

Summary

Constants

int UPDATE_ERROR_BATTERY_LOW

Represents the battery being too low to apply an update.

int UPDATE_ERROR_FILE_NOT_FOUND

Represents that the file could not be found.

int UPDATE_ERROR_INCORRECT_OS_VERSION

Represents the update file being intended for different OS version.

int UPDATE_ERROR_UNKNOWN

Represents an unknown error while trying to install an update.

int UPDATE_ERROR_UPDATE_FILE_INVALID

Represents the update file being wrong; e.g. payloads are mismatched, or the wrong compression method is used.

Public constructors

InstallSystemUpdateCallback()

Public methods

void onInstallUpdateError(int errorCode, String errorMessage)

Method invoked when there was an error while installing an update.

Inherited methods

Constants

UPDATE_ERROR_BATTERY_LOW

Added in API level 29
public static final int UPDATE_ERROR_BATTERY_LOW

Represents the battery being too low to apply an update.

Constant Value: 5 (0x00000005)

UPDATE_ERROR_FILE_NOT_FOUND

Added in API level 29
public static final int UPDATE_ERROR_FILE_NOT_FOUND

Represents that the file could not be found.

Constant Value: 4 (0x00000004)

UPDATE_ERROR_INCORRECT_OS_VERSION

Added in API level 29
public static final int UPDATE_ERROR_INCORRECT_OS_VERSION

Represents the update file being intended for different OS version.

Constant Value: 2 (0x00000002)

UPDATE_ERROR_UNKNOWN

Added in API level 29
public static final int UPDATE_ERROR_UNKNOWN

Represents an unknown error while trying to install an update.

Constant Value: 1 (0x00000001)

UPDATE_ERROR_UPDATE_FILE_INVALID

Added in API level 29
public static final int UPDATE_ERROR_UPDATE_FILE_INVALID

Represents the update file being wrong; e.g. payloads are mismatched, or the wrong compression method is used.

Constant Value: 3 (0x00000003)

Public constructors

InstallSystemUpdateCallback

public InstallSystemUpdateCallback ()

Public methods

onInstallUpdateError

Added in API level 29
public void onInstallUpdateError (int errorCode, 
                String errorMessage)

Method invoked when there was an error while installing an update.

The given error message is not intended to be user-facing. It is intended to be reported back to the IT admin to be read.

Parameters
errorCode int: Value is UPDATE_ERROR_UNKNOWN, UPDATE_ERROR_INCORRECT_OS_VERSION, UPDATE_ERROR_UPDATE_FILE_INVALID, UPDATE_ERROR_FILE_NOT_FOUND, or UPDATE_ERROR_BATTERY_LOW

errorMessage String: This value cannot be null.