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 表示快捷方式所属的应用程序的包名。 |