Skip to content

Most visited

Recently visited

navigation

LauncherApps.Callback

public static abstract class LauncherApps.Callback
extends Object

java.lang.Object
   ↳ android.content.pm.LauncherApps.Callback


Callbacks for package changes to this and related managed profiles.

Summary

Public constructors

LauncherApps.Callback()

Public methods

abstract void onPackageAdded(String packageName, UserHandle user)

Indicates that a package was added to the specified profile.

abstract void onPackageChanged(String packageName, UserHandle user)

Indicates that a package was modified in the specified profile.

abstract void onPackageRemoved(String packageName, UserHandle user)

Indicates that a package was removed from the specified profile.

abstract void onPackagesAvailable(String[] packageNames, UserHandle user, boolean replacing)

Indicates that one or more packages have become available.

void onPackagesSuspended(String[] packageNames, UserHandle user)

Indicates that one or more packages have been suspended.

abstract void onPackagesUnavailable(String[] packageNames, UserHandle user, boolean replacing)

Indicates that one or more packages have become unavailable.

void onPackagesUnsuspended(String[] packageNames, UserHandle user)

Indicates that one or more packages have been unsuspended.

void onShortcutsChanged(String packageName, List<ShortcutInfo> shortcuts, UserHandle user)

Indicates that one or more shortcuts of any kind (dynamic, pinned, or manifest) have been added, updated or removed.

Inherited methods

From class java.lang.Object

Public constructors

LauncherApps.Callback

added in API level 21
LauncherApps.Callback ()

Public methods

onPackageAdded

added in API level 21
void onPackageAdded (String packageName, 
                UserHandle user)

Indicates that a package was added to the specified profile. If a package is added while being updated then onPackageChanged will be called instead.

Parameters
packageName String: The name of the package that was added.
user UserHandle: The UserHandle of the profile that generated the change.

onPackageChanged

added in API level 21
void onPackageChanged (String packageName, 
                UserHandle user)

Indicates that a package was modified in the specified profile. This can happen, for example, when the package is updated or when one or more components are enabled or disabled.

Parameters
packageName String: The name of the package that has changed.
user UserHandle: The UserHandle of the profile that generated the change.

onPackageRemoved

added in API level 21
void onPackageRemoved (String packageName, 
                UserHandle user)

Indicates that a package was removed from the specified profile. If a package is removed while being updated onPackageChanged will be called instead.

Parameters
packageName String: The name of the package that was removed.
user UserHandle: The UserHandle of the profile that generated the change.

onPackagesAvailable

added in API level 21
void onPackagesAvailable (String[] packageNames, 
                UserHandle user, 
                boolean replacing)

Indicates that one or more packages have become available. For example, this can happen when a removable storage card has reappeared.

Parameters
packageNames String: The names of the packages that have become available.
user UserHandle: The UserHandle of the profile that generated the change.
replacing boolean: Indicates whether these packages are replacing existing ones.

onPackagesSuspended

added in API level 24
void onPackagesSuspended (String[] packageNames, 
                UserHandle user)

Indicates that one or more packages have been suspended. For example, this can happen when a Device Administrator suspends an applicaton.

Parameters
packageNames String: The names of the packages that have just been suspended.
user UserHandle: The UserHandle of the profile that generated the change.

onPackagesUnavailable

added in API level 21
void onPackagesUnavailable (String[] packageNames, 
                UserHandle user, 
                boolean replacing)

Indicates that one or more packages have become unavailable. For example, this can happen when a removable storage card has been removed.

Parameters
packageNames String: The names of the packages that have become unavailable.
user UserHandle: The UserHandle of the profile that generated the change.
replacing boolean: Indicates whether the packages are about to be replaced with new versions.

onPackagesUnsuspended

added in API level 24
void onPackagesUnsuspended (String[] packageNames, 
                UserHandle user)

Indicates that one or more packages have been unsuspended. For example, this can happen when a Device Administrator unsuspends an applicaton.

Parameters
packageNames String: The names of the packages that have just been unsuspended.
user UserHandle: The UserHandle of the profile that generated the change.

onShortcutsChanged

added in API level 25
void onShortcutsChanged (String packageName, 
                List<ShortcutInfo> shortcuts, 
                UserHandle user)

Indicates that one or more shortcuts of any kind (dynamic, pinned, or manifest) have been added, updated or removed.

Only the applications that are allowed to access the shortcut information, as defined in hasShortcutHostPermission(), will receive it.

Parameters
packageName String: The name of the package that has the shortcuts.
shortcuts List: All shortcuts from the package (dynamic, manifest and/or pinned). Only "key" information will be provided, as defined in hasKeyFieldsOnly().
user UserHandle: The UserHandle of the profile that generated the change.

See also:

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.