鸿蒙OS LauncherService

LauncherService

java.lang.Object

|---ohos.bundle.LauncherService

public class LauncherService
extends Object

查询车辆的启动器ability和应用信息。

你可以使用这个类来注册一个回调方法来观察bundle状态的变化。

嵌套类摘要

修饰符和类型	类	描述
static class	LauncherService.BundleStatusCallback	提供在安装、卸载或更新捆绑包后调用的回调方法。

构造函数摘要

构造函数	描述
LauncherService(Context context)	用于创建 LauncherService 实例的构造函数。

方法总结

修饰符和类型	方法	描述
OptionalLauncherAbilityInfo	getAbilityInfo(Intent intent, int userId)	根据给定 Intent 中指定的 ElementName 和 userId 获取启动器ability。
OptionalListLauncherAbilityInfo	getAbilityList(String bundleName, int userId)	根据包含 Intent.ACTION_HOME 和 Intent.ENTITY_HOME 的 Intent 获取启动器ability。
OptionalApplicationInfo	getApplicationInfo(String bundleName, int flags, int userId)	根据给定的包名称、标志和用户 ID 获取有关应用程序的信息。
OptionalListLauncherShortcutInfo	getShortcutInfos(String bundleName)	获取有关应用程序快捷方式的信息。
boolean	isAbilityEnabled(AbilityInfo abilityInfo)	检查ability是否存在并启用。
boolean	isBundleEnabled(String bundleName)	检查捆绑包是否存在并已启用。
void	registerCallback(LauncherService.BundleStatusCallback callback)	注册一个回调方法，用于监控包安装、卸载和更新事件。
void	startShortcut(String shortcutId, String bundleName)	根据给定的快捷方式 ID 和包名称启动快捷方式。
void	unRegisterCallback()	取消注册用于监视捆绑安装、卸载和更新事件的回调方法。

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造函数详细信息

LauncherService

public LauncherService(Context context)

用于创建 LauncherService 实例的构造函数。

您可以使用此实例注册回调方法以监视捆绑包安装、卸载和更新事件。

参数:

参数名称	参数描述
context	表示当前ability的上下文对象。

方法详情

registerCallback

public void registerCallback(LauncherService.BundleStatusCallback callback)

注册一个回调方法，用于监控包安装、卸载和更新事件。

要使用此方法，您需要向系统请求 ohos.permission.LISTEN_BUNDLE_CHANGE 权限。 ohos.permission.LISTEN_BUNDLE_CHANGE 权限属于签名|特权级别。

参数：

参数名称	参数描述
callback	表示要调用的回调方法。

unRegisterCallback

public void unRegisterCallback()

取消注册用于监视捆绑安装、卸载和更新事件的回调方法。

getAbilityList

public OptionalListLauncherAbilityInfo getAbilityList(String bundleName, int userId)

根据包含 Intent.ACTION_HOME 和 Intent.ENTITY_HOME 的 Intent 获取启动器ability。

如果指定了包名称，则返回有关与指定包匹配的启动器ability的信息。 否则，将返回有关与 Intent 匹配的所有启动器ability的信息。

参数：

参数名称	参数描述
bundleName	指示捆绑包名称。
userId	表示用户标识。

返回:

返回 LauncherAbilityInfo 对象的列表。

getAbilityInfo

public OptionalLauncherAbilityInfo getAbilityInfo(Intent intent, int userId)

根据给定 Intent 中指定的 ElementName 和 userId 获取启动器ability。

参数：

参数名称	参数描述
intent	指示包含要查询的应用程序包名称的 Intent。
userId	表示用户标识。

返回:

返回一个 LauncherAbilityInfo 对象。

getApplicationInfo

public OptionalApplicationInfo getApplicationInfo(String bundleName, int flags, int userId)

根据给定的包名称、标志和用户 ID 获取有关应用程序的信息。

参数:

参数名称	参数描述
bundleName	表示要查询的bundle名称。
flags	指示用于指定将返回的 ApplicationInfo 对象中包含的信息的标志。
userId	表示用户标识。

返回:

返回一个 ApplicationInfo 对象。

isBundleEnabled

public boolean isBundleEnabled(String bundleName)

检查捆绑包是否存在并已启用。

参数：

参数名称	参数描述
bundleName	指示捆绑包名称。

返回:

如果启用了捆绑包，则返回 true； 否则返回 false。

isAbilityEnabled

public boolean isAbilityEnabled(AbilityInfo abilityInfo)

检查ability是否存在并启用。

参数：

参数名称	参数描述
abilityInfo	表示有关检查ability的信息。

返回:

如果该ability存在且已启用，则返回 true； 否则返回 false。

getShortcutInfos

public OptionalListLauncherShortcutInfo getShortcutInfos(String bundleName)

获取有关应用程序快捷方式的信息。

要使用此方法，您需要向系统请求 ohos.permission.MANAGE_SHORTCUTS 权限。 ohos.permission.MANAGE_SHORTCUTS 权限属于签名级别。

参数：

参数名称	参数描述
bundleName	指示应用程序的捆绑包名称。

返回:

返回包含有关应用程序的快捷方式信息的 LauncherShortcutInfo 对象列表。

startShortcut

public void startShortcut(String shortcutId, String bundleName)

根据给定的快捷方式 ID 和包名称启动快捷方式。

要使用此方法，您需要向系统请求 ohos.permission.MANAGE_SHORTCUTS 权限。 ohos.permission.MANAGE_SHORTCUTS 权限属于签名级别。

参数：

参数名称	参数描述
shortcutId	指示要启动的快捷方式的 ID。
bundleName	BundleName 表示快捷方式所属的应用程序的包名。