程序包 ohos.bundle

类 LauncherService

java.lang.Object

ohos.bundle.LauncherService

public class LauncherService
extends Object

Queries launcher ability and application information for vehicles.

You can use this class to register a callback method for observing bundle status changes.

从以下版本开始:

1

嵌套类概要

嵌套类

限定符和类型	类	说明
static class	LauncherService.BundleStatusCallback	Provides callback methods that are called after a bundle is installed, uninstalled, or updated.

构造器概要

构造器

构造器	说明
LauncherService(Context context)	A constructor used to create a LauncherService instance.

方法概要

限定符和类型	方法	说明
Optional<LauncherAbilityInfo>	getAbilityInfo(Intent intent, int userId)	Obtains a launcher ability based on the ElementName and userId specified in the given Intent.
Optional<List<LauncherAbilityInfo>>	getAbilityList(String bundleName, int userId)	Obtains launcher abilities based on the Intent that contains Intent.ACTION_HOME and Intent.ENTITY_HOME.
Optional<ApplicationInfo>	getApplicationInfo(String bundleName, int flags, int userId)	Obtains information about an application based on the given bundle name, flag, and user ID.
Optional<List<LauncherShortcutInfo>>	getShortcutInfos(String bundleName)	Obtains information about the shortcuts of the application.
boolean	isAbilityEnabled(AbilityInfo abilityInfo)	Checks whether an ability exists and is enabled.
boolean	isBundleEnabled(String bundleName)	Checks whether a bundle exists and is enabled.
void	registerCallback(LauncherService.BundleStatusCallback callback)	Registers a callback method for monitoring bundle installation, uninstallation, and update events.
void	startShortcut(String shortcutId, String bundleName)	Starts a shortcut based on the given shortcut ID and bundle name.
void	unRegisterCallback()	Unregisters the callback method for monitoring bundle installation, uninstallation, and update events.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

LauncherService

public LauncherService(Context context)

A constructor used to create a LauncherService instance.

You can use this instance to register callback methods for monitoring bundle installation, uninstallation, and update events.

参数:

context - Indicates the Context object of the current ability.

从以下版本开始:

1

方法详细资料

registerCallback

public void registerCallback(LauncherService.BundleStatusCallback callback)

Registers a callback method for monitoring bundle installation, uninstallation, and update events.

To use this method, you need to request the ohos.permission.LISTEN_BUNDLE_CHANGE permission from the system. The ohos.permission.LISTEN_BUNDLE_CHANGE permission is of the signature|privileged level.

参数:

callback - Indicates the callback method to be called.

从以下版本开始:

1

unRegisterCallback

public void unRegisterCallback()

Unregisters the callback method for monitoring bundle installation, uninstallation, and update events.

从以下版本开始:

1

getAbilityList

public Optional<List<LauncherAbilityInfo>> getAbilityList(String bundleName,
                                                          int userId)

Obtains launcher abilities based on the Intent that contains Intent.ACTION_HOME and Intent.ENTITY_HOME.

If a bundle name is specified, information about launcher abilities matching the specified bundle is returned. Otherwise, information about all launcher abilities that match the Intent is returned.

参数:

bundleName - Indicates the bundle name.

userId - Indicates the user ID.

返回:

Returns a list of LauncherAbilityInfo objects.

从以下版本开始:

1

另请参阅:

Intent.ACTION_HOME, Intent.ENTITY_HOME

getAbilityInfo

public Optional<LauncherAbilityInfo> getAbilityInfo(Intent intent,
                                                    int userId)

Obtains a launcher ability based on the ElementName and userId specified in the given Intent.

参数:

intent - Indicates the Intent containing the application bundle name to be queried.

userId - Indicates the user ID.

返回:

Returns a LauncherAbilityInfo object.

从以下版本开始:

1

getApplicationInfo

public Optional<ApplicationInfo> getApplicationInfo(String bundleName,
                                                    int flags,
                                                    int userId)

Obtains information about an application based on the given bundle name, flag, and user ID.

参数:

bundleName - Indicates the bundle name to be queried.

flags - Indicates the flag used to specify information contained in the ApplicationInfo objects that will be returned.

userId - Indicates the user ID.

返回:

Returns an ApplicationInfo object.

从以下版本开始:

1

另请参阅:

IBundleManager.GET_APPLICATION_INFO_WITH_PERMISSION, IBundleManager.GET_BUNDLE_DEFAULT

isBundleEnabled

public boolean isBundleEnabled(String bundleName)

Checks whether a bundle exists and is enabled.

参数:

bundleName - Indicates the bundle name.

返回:

Returns true if the bundle is enabled; returns false otherwise.

从以下版本开始:

1

isAbilityEnabled

public boolean isAbilityEnabled(AbilityInfo abilityInfo)

Checks whether an ability exists and is enabled.

参数:

abilityInfo - Indicates information about the ability to check.

返回:

Returns true if the ability exists and is enabled; returns false otherwise.

从以下版本开始:

1

getShortcutInfos

public Optional<List<LauncherShortcutInfo>> getShortcutInfos(String bundleName)

Obtains information about the shortcuts of the application.

To use this method, you need to request the ohos.permission.MANAGE_SHORTCUTS permission from the system. The ohos.permission.MANAGE_SHORTCUTS permission is of the signature level.

参数:

bundleName - Indicates the bundle name of the application.

返回:

Returns a list of LauncherShortcutInfo objects containing shortcut information about the application.

从以下版本开始:

3

startShortcut

public void startShortcut(String shortcutId,
                          String bundleName)

Starts a shortcut based on the given shortcut ID and bundle name.

To use this method, you need to request the ohos.permission.MANAGE_SHORTCUTS permission from the system. The ohos.permission.MANAGE_SHORTCUTS permission is of the signature level.

参数:

shortcutId - Indicates the ID of the shortcut to start.

bundleName - BundleName Indicates the bundle name of the application to which the shortcut belongs.

从以下版本开始:

3