Most visited

Recently visited

Results for

Added in API level 21

Summary: Nested Classes | Methods | Inherited Methods | [Expand All]

LauncherApps

public class LauncherApps
extends Object

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

Class for retrieving a list of launchable activities for the current user and any associated managed profiles. This is mainly for use by launchers. Apps can be queried for each user profile. Since the PackageManager will not deliver package broadcasts for other profiles, you can register for package changes here.

To watch for managed profiles being added or removed, register for the following broadcasts: ACTION_MANAGED_PROFILE_ADDED and ACTION_MANAGED_PROFILE_REMOVED.

You can retrieve the list of profiles associated with this user with getUserProfiles().

Summary

Nested classes
`class`	`LauncherApps.Callback` Callbacks for package changes to this and related managed profiles.

Public methods
`List<LauncherActivityInfo>`	`getActivityList(String packageName, UserHandle user)` Retrieves a list of launchable activities that match `ACTION_MAIN` and `CATEGORY_LAUNCHER`, for a specified user.
`boolean`	`isActivityEnabled(ComponentName component, UserHandle user)` Checks if the activity exists and it enabled for a profile.
`boolean`	`isPackageEnabled(String packageName, UserHandle user)` Checks if the package is installed and enabled for a profile.
`void`	`registerCallback(LauncherApps.Callback callback, Handler handler)` Registers a callback for changes to packages in current and managed profiles.
`void`	`registerCallback(LauncherApps.Callback callback)` Registers a callback for changes to packages in current and managed profiles.
`LauncherActivityInfo`	`resolveActivity(Intent intent, UserHandle user)` Returns the activity info for a given intent and user handle, if it resolves.
`void`	`startAppDetailsActivity(ComponentName component, UserHandle user, Rect sourceBounds, Bundle opts)` Starts the settings activity to show the application details for a package in the specified profile.
`void`	`startMainActivity(ComponentName component, UserHandle user, Rect sourceBounds, Bundle opts)` Starts a Main activity in the specified profile.
`void`	`unregisterCallback(LauncherApps.Callback callback)` Unregisters a callback that was previously registered.

Inherited methods

From class


  
    java.lang.Object

`Object`	`clone()` Creates and returns a copy of this object.
`boolean`	`equals(Object obj)` Indicates whether some other object is "equal to" this one.
`void`	`finalize()` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
`final Class<?>`	`getClass()` Returns the runtime class of this `Object`.
`int`	`hashCode()` Returns a hash code value for the object.
`final void`	`notify()` Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()` Wakes up all threads that are waiting on this object's monitor.
`String`	`toString()` Returns a string representation of the object.
`final void`	`wait(long millis, int nanos)` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
`final void`	`wait(long millis)` Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.
`final void`	`wait()` Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.

Public methods

getActivityList

Added in API level 21

List<LauncherActivityInfo> getActivityList (String packageName, 
                UserHandle user)

Retrieves a list of launchable activities that match ACTION_MAIN and CATEGORY_LAUNCHER, for a specified user.

Parameters
`packageName`	`String`: The specific package to query. If null, it checks all installed packages in the profile.
`user`	`UserHandle`: The UserHandle of the profile.

Returns
`List<LauncherActivityInfo>`	List of launchable activities. Can be an empty list but will not be null.

isActivityEnabled

Added in API level 21

boolean isActivityEnabled (ComponentName component, 
                UserHandle user)

Checks if the activity exists and it enabled for a profile.

Parameters
`component`	`ComponentName`: The activity to check.
`user`	`UserHandle`: The UserHandle of the profile.

Returns
`boolean`	true if the activity exists and is enabled.

isPackageEnabled

Added in API level 21

boolean isPackageEnabled (String packageName, 
                UserHandle user)

Checks if the package is installed and enabled for a profile.

Parameters
`packageName`	`String`: The package to check.
`user`	`UserHandle`: The UserHandle of the profile.

Returns
`boolean`	true if the package exists and is enabled.

registerCallback

Added in API level 21

void registerCallback (LauncherApps.Callback callback, 
                Handler handler)

Registers a callback for changes to packages in current and managed profiles.

Parameters
`callback`	`LauncherApps.Callback`: The callback to register.
`handler`	`Handler`: that should be used to post callbacks on, may be null.

registerCallback

Added in API level 21

void registerCallback (LauncherApps.Callback callback)

Registers a callback for changes to packages in current and managed profiles.

Parameters
`callback`	`LauncherApps.Callback`: The callback to register.

resolveActivity

Added in API level 21

LauncherActivityInfo resolveActivity (Intent intent, 
                UserHandle user)

Returns the activity info for a given intent and user handle, if it resolves. Otherwise it returns null.

Parameters
`intent`	`Intent`: The intent to find a match for.
`user`	`UserHandle`: The profile to look in for a match.

Returns
`LauncherActivityInfo`	An activity info object if there is a match.

startAppDetailsActivity

Added in API level 21

void startAppDetailsActivity (ComponentName component, 
                UserHandle user, 
                Rect sourceBounds, 
                Bundle opts)

Starts the settings activity to show the application details for a package in the specified profile.

Parameters
`component`	`ComponentName`: The ComponentName of the package to launch settings for.
`user`	`UserHandle`: The UserHandle of the profile
`sourceBounds`	`Rect`: The Rect containing the source bounds of the clicked icon
`opts`	`Bundle`: Options to pass to startActivity

startMainActivity

Added in API level 21

void startMainActivity (ComponentName component, 
                UserHandle user, 
                Rect sourceBounds, 
                Bundle opts)

Starts a Main activity in the specified profile.

Parameters
`component`	`ComponentName`: The ComponentName of the activity to launch
`user`	`UserHandle`: The UserHandle of the profile
`sourceBounds`	`Rect`: The Rect containing the source bounds of the clicked icon
`opts`	`Bundle`: Options to pass to startActivity

unregisterCallback

Added in API level 21

void unregisterCallback (LauncherApps.Callback callback)

Unregisters a callback that was previously registered.

Parameters
`callback`	`LauncherApps.Callback`: The callback to unregister.

See also:

registerCallback(Callback)

Most visited

Recently visited

Results for

LauncherApps

Summary

Nested classes

Public methods

Inherited methods

Public methods

getActivityList

isActivityEnabled

isPackageEnabled

registerCallback

registerCallback

resolveActivity

startAppDetailsActivity

startMainActivity

unregisterCallback