未验证 提交 2285f301 编写于 作者: O openharmony_ci 提交者: Gitee

!6874 主干扫描缺陷修改

Merge pull request !6874 from junyi233/myyy
# innerBundleManager模块(JS端SDK接口)
本模块提供内部包的管理
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 8 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
import innerBundleManager from '@ohos.bundle.innerBundleManager';
```
## 系统能力
SystemCapability.BundleManager.BundleFramework
## 权限列表
| 权限 | 权限等级 | 描述 |
| ------------------------------------------ | ------------ | ---------------------------- |
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息 |
| ohos.permission.LISTEN_BUNDLE_CHANGE | system_grant | 允许该应用获取应用变化消息。 |
权限等级参考[权限等级说明](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/accesstoken-overview.md#%E6%9D%83%E9%99%90%E7%AD%89%E7%BA%A7%E8%AF%B4%E6%98%8E)
## innerBundleManager.getLauncherAbilityInfos
getLauncherAbilityInfos(bundleName: string, userId: number, callback: AsyncCallback<Array<LauncherAbilityInfo>>) : void;
以异步方法根据给定的包名获取LauncherAbilityInfos,使用callback形式返回结果。
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| userId | number | 是 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。 |
| callback | AsyncCallback<Array<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数,返回程序信息。 |
## innerBundleManager.getLauncherAbilityInfos
getLauncherAbilityInfos(bundleName: string, userId: number) : Promise&lt;Array&lt;LauncherAbilityInfo&gt;&gt;
以异步方法根据给定的包名获取LauncherAbilityInfos,使用Promise形式返回结果。
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---------- | ------ | ---- | ----------------------------------------------------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| userId | number | 是 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。 |
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------------------ | ------------------------- |
| Promise\<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo.md)> | Promise形式返回程序信息。 |
## innerBundleManager.on
on(type:"BundleStatusChange", bundleStatusCallback : BundleStatusCallback, callback: AsyncCallback&lt;string&gt;) : void;
注册Callback。
**需要权限:**
ohos.permission.LISTEN_BUNDLE_CHANGE
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------------------- | --------------------- | ---- | ---------------------------------------------------- |
| type | "BundleStatusChange" | 是 | 指示应执行命令。 |
| bundleStatusCallback | BundleStatusCallback | 是 | 指示要注册的回调。 |
| callback | AsyncCallback<string> | 是 | 程序启动作为入参的回调函数,返回正确结果或错误信息。 |
## innerBundleManager.on
on(type:"BundleStatusChange", bundleStatusCallback : BundleStatusCallback): Promise&lt;string&gt;
注册Callback。
**需要权限:**
ohos.permission.LISTEN_BUNDLE_CHANGE
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------------------- | -------------------- | ---- | ------------------ |
| type | "BundleStatusChange" | 是 | 指示应执行命令。 |
| bundleStatusCallback | BundleStatusCallback | 是 | 指示要注册的回调。 |
**返回值:**
| 类型 | 说明 |
| --------------- | ----------------------------------- |
| Promise<string> | Promise形式返回正确结果或错误信息。 |
## innerBundleManager.off
off(type:"BundleStatusChange", callback: AsyncCallback&lt;string&gt;) : void;
取消注册Callback。
**需要权限:**
ohos.permission.LISTEN_BUNDLE_CHANGE
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | --------------------- | ---- | ---------------------------------------------------- |
| type | "BundleStatusChange" | 是 | 指示应执行命令。 |
| callback | AsyncCallback<string> | 是 | 程序启动作为入参的回调函数,返回正确结果或错误信息。 |
## innerBundleManager.off
off(type:"BundleStatusChange"): Promise&lt;string&gt;
取消注册Callback。
**需要权限:**
ohos.permission.LISTEN_BUNDLE_CHANGE
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---- | -------------------- | ---- | ---------------- |
| type | "BundleStatusChange" | 是 | 指示应执行命令。 |
**返回值:**
| 类型 | 说明 |
| --------------- | ----------------------------------- |
| Promise<string> | Promise形式返回正确结果或错误信息。 |
## innerBundleManager.getAllLauncherAbilityInfos
getAllLauncherAbilityInfos(userId: number, callback: AsyncCallback&lt;Array&lt;LauncherAbilityInfo&gt;&gt;) : void;
以异步方法根据给定的包名获取所有的LauncherAbilityInfos,使用callback形式返回结果。
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | ------------------------------------------------------------ | ---- | ----------------------------------------------------- |
| userId | number | 是 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。 |
| callback | AsyncCallback<Array<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数,返回程序信息。 |
## innerBundleManager.getAllLauncherAbilityInfos
getAllLauncherAbilityInfos(userId: number) : Promise&lt;Array&lt;LauncherAbilityInfo&gt;&gt;
以异步方法根据给定的包名获取LauncherAbilityInfos,使用Promise形式返回结果。
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ------ | ------ | ---- | ----------------------------------------------------- |
| userId | number | 是 | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。 |
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------------------ | ------------------------- |
| Promise\<[LauncherAbilityInfo](js-apis-bundle-LauncherAbilityInfo.md)> | Promise形式返回程序信息。 |
## innerBundleManager.getShortcutInfos
getShortcutInfos(bundleName :string, callback: AsyncCallback&lt;Array&lt;ShortcutInfo&gt;&gt;) : void;
以异步方法根据给定的包名获取快捷方式信息,使用callback形式返回结果。
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---------- | ------------------------------------------------------------ | ---- | ---------------------------------------------- |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
| callback | AsyncCallback<Array<[ShortcutInfo](js-apis-bundle-ShortcutInfo.md)>> | 是 | 程序启动作为入参的回调函数,返回快捷方式信息。 |
## innerBundleManager.getShortcutInfos
getShortcutInfos(bundleName : string) : Promise&lt;Array&lt;ShortcutInfo&gt;&gt;
以异步方法根据给定的包名获取快捷方式信息,使用Promise形式返回结果。
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---------- | ------ | ---- | ------------------------ |
| bundleName | string | 是 | 要查询的应用程序包名称。 |
**返回值:**
| 类型 | 说明 |
| -------------------------------------------------------- | ----------------------------- |
| Promise\<[ShortcutInfo](js-apis-bundle-ShortcutInfo.md)> | Promise形式返回快捷方式信息。 |
# distributedBundle模块(JS端SDK接口)
本模块提供内部包的管理
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 8 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
## 导入模块
```
import distributedBundle from '@ohos.distributedBundle';
```
## 系统能力
SystemCapability.BundleManager.DistributedBundleFramework
## 权限列表
| 权限 | 权限等级 | 描述 |
| ------------------------------------------ | ------------ | ------------------ |
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息 |
权限等级参考[权限等级说明](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/accesstoken-overview.md#%E6%9D%83%E9%99%90%E7%AD%89%E7%BA%A7%E8%AF%B4%E6%98%8E)
## distributedBundle.getRemoteAbilityInfo
getRemoteAbilityInfo(elementName: ElementName, callback: AsyncCallback&lt;RemoteAbilityInfo&gt;): void;
以异步方法根据给定的包名获取有关远程设备AbilityInfo信息,使用callback形式返回结果。
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力:**
SystemCapability.BundleManager.DistributedBundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ----------- | ------------------------------------------------------------ | ---- | -------------------------------------------------- |
| elementName | [ElementName](js-apis-bundle-ElementName.md) | 是 | 获得的ElementName信息。 |
| callback | AsyncCallback<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo.md)> | 是 | 程序启动作为入参的回调函数,返回远程基本能力信息。 |
## distributedBundle.getRemoteAbilityInfo
getRemoteAbilityInfo(elementName: ElementName): Promise&lt;RemoteAbilityInfo&gt;
以异步方法根据给定的包名获取有关远程设备AbilityInfo信息,使用Promise形式返回结果。
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力:**
SystemCapability.BundleManager.DistributedBundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ----------- | -------------------------------------------- | ---- | ----------------------- |
| elementName | [ElementName](js-apis-bundle-ElementName.md) | 是 | 获得的ElementName信息。 |
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------------------ | --------------------------------- |
| Promise\<[RemoteAbilityInfo]((js-apis-bundle-remoteAbilityInfo.md))> | Promise形式返回远程基本能力信息。 |
## distributedBundle.getRemoteAbilityInfos
getRemoteAbilityInfos(elementNames: Array&lt;ElementName&gt;, callback: AsyncCallback&lt;Array&lt;RemoteAbilityInfo&gt;&gt;): void;
以异步方法根据给定的包名获取有关远程设备AbilityInfos信息,使用callback形式返回结果。
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力:**
SystemCapability.BundleManager.DistributedBundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ------------ | ------------------------------------------------------------ | ---- | -------------------------------------------------- |
| elementNames | Array<[ElementName](js-apis-bundle-ElementName.md)> | 是 | ElementName信息,最大数组长度为10 |
| callback | AsyncCallback< Array<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数,返回远程基本能力信息。 |
## distributedBundle.getRemoteAbilityInfos
getRemoteAbilityInfos(elementNames: Array&lt;ElementName&gt;): Promise&lt;Array&lt;RemoteAbilityInfo&gt;&gt;
以异步方法根据给定的包名获取有关远程设备AbilityInfo信息,使用Promise形式返回结果。
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力:**
SystemCapability.BundleManager.DistributedBundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ------------ | --------------------------------------------------- | ---- | ----------------------- |
| elementNames | Array<[ElementName](js-apis-bundle-ElementName.md)> | 是 | 获得的ElementName信息。 |
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------------------ | --------------------------------- |
| Promise\<Array<[RemoteAbilityInfo]((js-apis-bundle-remoteAbilityInfo.md))>> | Promise形式返回远程基本能力信息。 |
......@@ -374,6 +374,466 @@ bundle.getBundleInfo(bundleName, bundleFlags, options, (err, data) => {
})
```
## bundle.getBundleInstaller
getBundleInstaller(): Promise&lt;BundleInstaller&gt;;
获取用于安装包的接口
**需要权限:**
ohos.permission.INSTALL_BUNDLE
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------------------ | -------------------------------------------- |
| Promise<[BundleInstaller](js-apis-bundle-BundleInstaller.md)> | 返回值为Promise对象,Promise中包含安装信息。 |
## bundle.getBundleInstaller
getBundleInstaller(callback: AsyncCallback&lt;BundleInstaller&gt;): void;
获取用于安装包的接口
**需要权限:**
ohos.permission.INSTALL_BUNDLE
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | ------------------------------------------------------------ | ---- | ---------------- |
| callback | AsyncCallback<[BundleInstaller](js-apis-bundle-BundleInstaller.md)> | 是 | 安装应用程序包。 |
## bundle.cleanBundleCacheFiles<sup>8+</sup>
cleanBundleCacheFiles(bundleName: string, callback: AsyncCallback&lt;void&gt;): void;
清除指定应用程序的缓存数据
**需要权限:**
ohos.permission.REMOVE_CACHE_FILES
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---------- | ------------------- | ---- | ------------------------------------- |
| bundleName | string | 是 | 指示要清除其缓存数据的应用程序包名称. |
| callback | AsyncCallback<void> | 是 | 为返回操作结果而调用的回调。 |
## bundle.cleanBundleCacheFiles<sup>8+</sup>
cleanBundleCacheFiles(bundleName: string): Promise&lt;void&gt;
清除指定应用程序的缓存数据
**需要权限:**
ohos.permission.REMOVE_CACHE_FILES
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---------- | ------ | ---- | ------------------------------------- |
| bundleName | string | 是 | 指示要清除其缓存数据的应用程序包名称. |
**返回值:**
| 类型 | 说明 |
| ------------- | ------------------------------------ |
| Promise<void> | 返回值为Promise对象,Promise中为空。 |
## bundle.setApplicationEnabled<sup>8+</sup>
setApplicationEnabled(bundleName: string, isEnable: boolean, callback: AsyncCallback&lt;void&gt;): void;
设置是否启用指定的应用程序
**需要权限:**
ohos.permission.CHANGE_ABILITY_ENABLED_STATE
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---------- | ------------------- | ---- | ----------------------------------------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用,false禁用。 |
| callback | AsyncCallback<void> | 是 | 为返回操作结果而调用的回调。 |
## bundle.setApplicationEnabled<sup>8+</sup>
setApplicationEnabled(bundleName: string, isEnable: boolean): Promise&lt;void&gt;
设置是否启用指定的应用程序
**需要权限:**
ohos.permission.CHANGE_ABILITY_ENABLED_STATE
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---------- | ------- | ---- | ----------------------------------------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用,false禁用。 |
**返回值:**
| 类型 | 说明 |
| ------------- | ------------------------------------ |
| Promise<void> | 返回值为Promise对象,Promise中为空。 |
## bundle.setAbilityEnabled<sup>8+</sup>
setApplicationEnabled(bundleName: string, isEnable: boolean, callback: AsyncCallback&lt;void&gt;): void;
设置是否启用指定的功能
**需要权限:**
ohos.permission.CHANGE_ABILITY_ENABLED_STATE
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | -------------------------------------------- | ---- | ----------------------------------------------- |
| info | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是 | Ability信息。 |
| isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用,false禁用。 |
| callback | AsyncCallback<void> | 是 | 为返回操作结果而调用的回调。 |
## bundle.setAbilityEnabled<sup>8+</sup>
setAbilityEnabled(info: AbilityInfo, isEnable: boolean): Promise&lt;void&gt;
设置是否启用指定的功能
**需要权限:**
ohos.permission.CHANGE_ABILITY_ENABLED_STATE
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | -------------------------------------------- | ---- | ----------------------------------------------- |
| info | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是 | Ability信息。 |
| isEnable | boolean | 是 | 指定是否启用应用程序。true表示启用,false禁用。 |
**返回值:**
| 类型 | 说明 |
| ------------- | ------------------------------------ |
| Promise<void> | 返回值为Promise对象,Promise中为空。 |
## bundle.getPermissionDef<sup>8+</sup>
getPermissionDef(permissionName: string, callback: AsyncCallback&lt;PermissionDef&gt;): void;
按权限名称获取权限的详细信息
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------ |
| permissionName | string | 是 | 指定权限的名称。 |
| callback | AsyncCallback<[PermissionDef](js-apis-bundle-PermissionDef)> | 是 | 程序启动作为入参的回调函数,返回定义的权限信息。 |
## bundle.getPermissionDef<sup>8+</sup>
getPermissionDef(permissionName: string): Promise&lt;PermissionDef&gt;
按权限名称获取权限的详细信息
**需要权限:**
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------------- | ------ | ---- | ---------------- |
| permissionName | string | 是 | 指定权限的名称。 |
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------------ | ------------------------------------------------------ |
| Promise<[PermissionDef](js-apis-bundle-PermissionDef)> | 返回值为Promise对象,Promise中包含定义的权限信息对象。 |
## bundle.setModuleUpgradeFlag<sup>9+</sup>
setModuleUpgradeFlag(bundleName: string, moduleName: string, upgradeFlag: UpgradeFlag, callback: AsyncCallback&lt;void&gt;):void;
设置模块是否需要升级
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ----------- | --------------------------- | ---- | ---------------------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| moduleName | string | 是 | 应用程序模块名称。 |
| upgradeFlag | [UpgradeFlag](#upgradeflag) | 是 | 仅供内部系统使用标志位 |
| callback | AsyncCallback<void> | 是 | 为返回操作结果而调用的回调。 |
## bundle.setModuleUpgradeFlag<sup>9+</sup>
setModuleUpgradeFlag(bundleName: string, moduleName: string, upgradeFlag: UpgradeFlag): Promise&lt;void&gt;
设置模块是否需要升级
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ----------- | --------------------------- | ---- | ---------------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| moduleName | string | 是 | 应用程序模块名称。 |
| upgradeFlag | [UpgradeFlag](#upgradeflag) | 是 | 仅供内部系统使用标志位 |
**返回值:**
| 类型 | 说明 |
| ------------- | ------------------------------------ |
| Promise<void> | 返回值为Promise对象,Promise中为空。 |
## bundle.isModuleRemovable<sup>9+</sup>
isModuleRemovable(bundleName: string, moduleName: string, callback: AsyncCallback&lt;boolean&gt;): void;
检查指定模块是否被移除
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---------- | ---------------------- | ---- | --------------------------------------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| moduleName | string | 是 | 应用程序模块名称。 |
| callback | AsyncCallback<boolean> | 是 | 程序启动作为入参的回调函数,返回boolean信息。 |
## bundle.isModuleRemovable<sup>9+</sup>
isModuleRemovable(bundleName: string, moduleName: string): Promise&lt;boolean&gt;
检查指定模块是否被移除
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---------- | ------ | ---- | ------------------ |
| bundleName | string | 是 | 应用程序包名称。 |
| moduleName | string | 是 | 应用程序模块名称。 |
**返回值:**
| 类型 | 说明 |
| ---------------- | ---------------------------- |
| Promise<boolean> | Promise形式返回boolean信息。 |
## bundle.getBundlePackInfo<sup>9+</sup>
getBundlePackInfo(bundleName: string, bundlePackFlag : pack.BundlePackFlag, callback: AsyncCallback&lt;pack.BundlePackInfo&gt;): void;
基于bundleName和bundleFlags获取bundlePackInfo
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------------- | ---------------------------------- | ---- | ---------------------------------------------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| bundlePackFlag | pack.BundlePackFlag | 是 | 指示要查询的应用包标志 |
| callback | AsyncCallback<pack.BundlePackInfo> | 是 | 程序启动作为入参的回调函数,返回BundlePackInfo信息。 |
## bundle.getBundlePackInfo<sup>9+</sup>
getBundlePackInfo(bundleName: string, bundlePackFlag : pack.BundlePackFlag): Promise&lt;pack.BundlePackInfo&gt;;
基于bundleName和bundleFlags获取bundlePackInfo
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------------- | ------------------- | ---- | ---------------------- |
| bundleName | string | 是 | 应用程序包名称。 |
| bundlePackFlag | pack.BundlePackFlag | 是 | 指示要查询的应用包标志 |
**返回值:**
| 类型 | 说明 |
| ---------------------------- | ----------------------------------- |
| Promise<pack.BundlePackInfo> | Promise形式返回BundlePackInfo信息。 |
## bundle.getDispatcherVersion<sup>9+</sup>
getDispatcherVersion(callback: AsyncCallback&lt;DispatchInfo&gt;): void;
获取有关dispatcher版本的信息
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| -------- | ------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| callback | AsyncCallback<[DispatchInfo](js-apis-dispatchInfo.md)> | 是 | 程序启动作为入参的回调函数,返回[DispatchInfo](js-apis-dispatchInfo.md)信息。 |
## bundle.getDispatcherVersion<sup>9+</sup>
getDispatcherVersion(): Promise&lt;DispatchInfo&gt;;
获取有关dispatcher版本的信息
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**系统API:**
此接口为系统接口,三方应用不支持调用
**返回值:**
| 类型 | 说明 |
| ------------------------------------------------ | ------------------------------------------------------------ |
| Promise<[DispatchInfo](js-apis-dispatchInfo.md)> | Promise形式返回[DispatchInfo](js-apis-dispatchInfo.md)信息。 |
## bundle.getAllApplicationInfo
......@@ -1693,6 +2153,8 @@ setDisposedStatus(bundleName: string, status: number, callback: AsyncCallback\<v
**系统能力:** SystemCapability.BundleManager.BundleFramework
**系统API:** 此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
......@@ -1723,6 +2185,8 @@ setDisposedStatus(bundleName: string, status: number): Promise\<void>;
**系统能力:** SystemCapability.BundleManager.BundleFramework
**系统API:** 此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
......@@ -1753,12 +2217,12 @@ bundle.setDisposedStatus(bundleName, status).then(data=>{
getDisposedStatus(bundleName: string, callback: AsyncCallback\<number>): void;
此接口为系统接口,以异步方法根据给定的bundleName来获取对应应用的处置状态,使用callback形式返回结果。
**需要权限:** ohos.permission.MANAGE_DISPOSED_APP_STATUS
**系统能力:** SystemCapability.BundleManager.BundleFramework
**系统API:** 此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
......@@ -1787,6 +2251,8 @@ getDisposedStatus(bundleName: string): Promise\<number>;
**系统能力:** SystemCapability.BundleManager.BundleFramework
**系统API:** 此接口为系统接口,三方应用不支持调用
**参数:**
| 名称 | 类型 | 必填 | 描述 |
......@@ -1897,15 +2363,15 @@ Ability类型
| LANDSCAPE | 无 | 屏幕方向--横屏 |
| PORTRAIT | 无 | 屏幕方向--竖屏 |
| FOLLOW_RECENT | 无 | 屏幕方向--紧跟上一个组件 |
| LANDSCAPE_INVERTED |无 | 屏幕方向--反向横屏 |
| PORTRAIT_INVERTED |无 | 屏幕方向--反向竖屏 |
| AUTO_ROTATION |无 | 屏幕方向--随传感器旋转 |
| AUTO_ROTATION_LANDSCAPE |无 | 屏幕方向--传感器横屏旋转,包括了横屏和反向横屏 |
| AUTO_ROTATION_PORTRAIT |无 | 屏幕方向--传感器竖屏旋转,包括了竖屏和反向竖屏 |
| AUTO_ROTATION_RESTRICTED |无 | 屏幕方向--传感器开关打开,方向可随传感器旋转 |
| AUTO_ROTATION_LANDSCAPE_RESTRICTED |无 | 屏幕方向--传感器开关打开,方向可随传感器旋转为横屏, 包括了横屏和反向横屏 |
| AUTO_ROTATION_PORTRAIT_RESTRICTED |无 | 屏幕方向--传感器开关打开,方向随可传感器旋转为竖屏, 包括了横屏和反向横屏 |
| LOCKED |无 | 屏幕方向--传感器开关关闭,方向锁定 |
| LANDSCAPE_INVERTED<sup>9+</sup> |无 | 屏幕方向--反向横屏 |
| PORTRAIT_INVERTED<sup>9+</sup> |无 | 屏幕方向--反向竖屏 |
| AUTO_ROTATION<sup>9+</sup> |无 | 屏幕方向--随传感器旋转 |
| AUTO_ROTATION_LANDSCAPE<sup>9+</sup> |无 | 屏幕方向--传感器横屏旋转,包括了横屏和反向横屏 |
| AUTO_ROTATION_PORTRAIT<sup>9+</sup> |无 | 屏幕方向--传感器竖屏旋转,包括了竖屏和反向竖屏 |
| AUTO_ROTATION_RESTRICTED<sup>9+</sup> |无 | 屏幕方向--传感器开关打开,方向可随传感器旋转 |
| AUTO_ROTATION_LANDSCAPE_RESTRICTED<sup>9+</sup> |无 | 屏幕方向--传感器开关打开,方向可随传感器旋转为横屏, 包括了横屏和反向横屏 |
| AUTO_ROTATION_PORTRAIT_RESTRICTED<sup>9+</sup> |无 | 屏幕方向--传感器开关打开,方向随可传感器旋转为竖屏, 包括了横屏和反向横屏 |
| LOCKED<sup>9+</sup> |无 | 屏幕方向--传感器开关关闭,方向锁定 |
## LaunchMode
启动模式
......@@ -1945,7 +2411,8 @@ ExtensionAbility的类型
| FILE_SHARE<sup>9+</sup> | 6 | ExtensionAbility的类型包括文件共享 |
| STATIC_SUBSCRIBER<sup>9+</sup> | 7 | ExtensionAbility的类型包括订阅者 |
| WALLPAPER<sup>9+</sup> | 8 | ExtensionAbility的类型包括墙纸 |
| BACKUP<sup>9+</sup> | 9 | ExtensionAbility的类型包括数据备份恢复 |
| BACKUP<sup>9+</sup> | 9 | ExtensionAbility的类型包括数据备份恢复 |
| WINDOW<sup>9+</sup> | 10 | ExtensionAbility的类型包括窗口类型扩展信息 |
| ENTERPRISE_ADMIN<sup>9+</sup> | 11 | ExtensionAbility的类型包括企业管理员 |
| UNSPECIFIED<sup>9+</sup> | 20 | ExtensionAbility未指定类型 |
......@@ -1994,6 +2461,20 @@ ExtensionAbility的类型
| 名称 | 类型 | 说明 |
| ------------------ | ---- | ---- |
| FULLSCREEN | 无 | 全屏模式 |
| SPLIT | 无 | 分屏模式 |
| FLOATING | 无 | 悬浮模式 |
| FULL_SCREEN<sup>9+</sup> | 0 | 全屏模式 |
| SPLIT<sup>9+</sup> | 1 | 分屏模式 |
| FLOATING<sup>9+</sup> | 2 | 悬浮模式 |
## UpgradeFlag
此项仅供内部系统使用
**系统API:**此接口为系统接口,三方应用不支持调用
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 值 | 说明 |
| ----------------------------- | ---- | ---------------- |
| NOT_UPGRADE<sup>9+</sup> | 0 | 模块无需升级 |
| SINGLE_UPGRADE<sup>9+</sup> | 1 | 单个模块需要升级 |
| RELATION_UPGRADE<sup>9+</sup> | 2 | 关系模块需要升级 |
......@@ -9,7 +9,7 @@
Ability信息
## AbilityInfo
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
......
# BundleInstaller
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
在设备上安装、升级和删除捆绑包
## 系统能力
SystemCapability.BundleManager.BundleFramework
## BundleInstaller.install
install(bundleFilePaths: Array&lt;string&gt;, param: InstallParam, callback: AsyncCallback&lt;InstallStatus&gt;): void;
以异步方法在HAP中安装应用程序,使用callback形式返回结果。
**需要权限:**
ohos.permission.INSTALL_BUNDLE
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| --------------- | ---------------------------------------------------- | ---- | ------------------------------------------------------------ |
| bundleFilePaths | Array&lt;string&gt; | 是 | 指示存储应用程序包的路径。路径应该是当前应用程序的数据目录的相对路径。 |
| param | [InstallParam](#installparam) | 是 | 指定安装所需的其他参数。 |
| callback | AsyncCallback&lt;[InstallStatus](#installstatus)&gt; | 是 | 程序启动作为入参的回调函数,返回安装状态信息。 |
## BundleInstaller.uninstall
uninstall(bundleName: string, param: InstallParam, callback: AsyncCallback&lt;InstallStatus&gt;): void;
以异步方法卸载应用程序,使用callback形式返回结果。
**需要权限:**
ohos.permission.INSTALL_BUNDLE
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- |
| bundleName | string | 是 | 包名 |
| param | [InstallParam](#installparam) | 是 | 指定安装所需的其他参数。 |
| callback | AsyncCallback&lt;[InstallStatus](#installstatus)&gt; | 是 | 程序启动作为入参的回调函数,返回安装状态信息。 |
## BundleInstaller.recover
recover(bundleName: string, param: InstallParam, callback: AsyncCallback&lt;InstallStatus&gt;): void;
以异步方法恢复一个应用程序,使用callback形式返回结果。
**需要权限:**
ohos.permission.INSTALL_BUNDLE
**系统能力:**
SystemCapability.BundleManager.BundleFramework
**参数:**
| 名称 | 类型 | 必填 | 描述 |
| ---------- | ---------------------------------------------------- | ---- | ---------------------------------------------- |
| bundleName | string | 是 | 包名 |
| param | [InstallParam](#installparam) | 是 | 指定安装所需的其他参数。 |
| callback | AsyncCallback&lt;[InstallStatus](#installstatus)&gt; | 是 | 程序启动作为入参的回调函数,返回安装状态信息。 |
## InstallParam
应用程序安装卸载信息
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 说明 |
| ----------- | ------- | ------------------ |
| userId | number | 指示用户id |
| installFlag | number | 指示安装标志 |
| isKeepData | boolean | 指示参数是否有数据 |
## InstallStatus
应用程序安装状态
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------ |
| status | bundle.[InstallErrorCode](js-apis-Bundle.md#installerrorcode) | 是 | 否 | 表示安装或卸载错误状态码 |
| statusMessage | string | 是 | 否 | 表示安装或卸载的字符串结果信息 |
\ No newline at end of file
......@@ -2,17 +2,17 @@
**说明:**
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
ElementName信息
## ElementName
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------------- | ---------| ---- | ---- | ------------------------- |
| deviceId | string | 是 | 是 | 设备id |
......
# LauncherAbilityInfo
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 8 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
LauncherAbilityInfo信息
## LauncherAbilityInfo
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| --------------- | ---------------------------------------------------- | ---- | ---- | ------------------------------------ |
| applicationInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | 是 | 否 | launcher ability的应用程序的配置信息 |
| elementName | [ElementName](js-apis-bundle-ElementName.md) | 是 | 否 | launcher ability的ElementName信息 |
| labelId | number | 是 | 否 | launcher ability的标签ID |
| iconId | number | 是 | 否 | launcher ability的图标ID |
| userId | number | 是 | 否 | launcher ability的用户ID |
| installTime | number | 是 | 否 | launcher ability的安装时间 |
\ No newline at end of file
# PermissionDef
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 8 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
配置文件中定义的权限详细信息
## **PermissionDef**
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| -------------- | ------ | ---- | ---- | -------------- |
| permissionName | string | 是 | 否 | 用户权限名称 |
| grantMode | number | 是 | 否 | 权限的授予模式 |
| labelId | number | 是 | 否 | 权限的标签ID |
| descriptionId | number | 是 | 否 | 描述权限的ID |
\ No newline at end of file
# ShortcutInfo
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
配置文件中定义的权限详细信息
## ShortcutWant
获取有关快捷方式将启动的功能和目标的信息
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ------------------------- | ------ | ---- | ---- | -------------------- |
| targetBundle | string | 是 | 否 | 快捷方式的目标捆绑包 |
| targetModule<sup>9+</sup> | string | 是 | 否 | 快捷方式的目标模块 |
| targetClass | string | 是 | 否 | 快捷方式所需的目标类 |
## ShortcutInfo
获取有关快捷方式将启动的功能和目标的信息
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------------------- | ------------------------------------------ | ---- | ---- | ---------------------------- |
| id | string | 是 | 否 | 快捷方式所属应用程序的Id |
| bundleName | string | 是 | 否 | 包含快捷方式的包名称 |
| hostAbility | string | 是 | 否 | 快捷方式的本地Ability信息 |
| icon | string | 是 | 否 | 快捷方式的图标 |
| iconId<sup>8+</sup> | number | 是 | 否 | 快捷方式的图标Id |
| label | string | 是 | 否 | 快捷方式的标签 |
| labelId<sup>8+</sup> | number | 是 | 否 | 快捷方式的标签Id |
| disableMessage | string | 是 | 否 | 快捷方式的禁用消息 |
| wants | Array&lt;[ShortcutWant](#shortcutwant)&gt; | 是 | 否 | 快捷方式所需要的信息 |
| isStatic | boolean | 是 | 否 | 快捷方式是否为静态 |
| isHomeShortcut | boolean | 是 | 否 | 快捷方式是否为主页面快捷方式 |
| isEnabled | boolean | 是 | 否 | 是否启用快捷方式 |
| moduleName<sup>9+</sup> | string | 是 | 否 | 快捷方式的模块名 |
\ No newline at end of file
......@@ -96,7 +96,7 @@ getDefaultApplication(type: string, userId?: number): Promise\<BundleInfo>
**系统能力:** SystemCapability.BundleManager.BundleFramework
**System API:** 此接口为系统接口
**系统API:** 此接口为系统接口,三方应用不支持调用
**参数:**
......@@ -141,7 +141,7 @@ getDefaultApplication(type: string, userId: number, callback: AsyncCallback\<Bun
**系统能力:** SystemCapability.BundleManager.BundleFramework
**System API:** 此接口为系统接口
**系统API:** 此接口为系统接口,三方应用不支持调用
**参数:**
......@@ -181,7 +181,7 @@ getDefaultApplication(type: string, callback: AsyncCallback\<BundleInfo>) : void
**系统能力:** SystemCapability.BundleManager.BundleFramework
**System API:** 此接口为系统接口
**系统API:** 此接口为系统接口,三方应用不支持调用
**参数:**
......@@ -220,7 +220,7 @@ setDefaultApplication(type: string, elementName: ElementName, userId?: number):
**系统能力:** SystemCapability.BundleManager.BundleFramework
**System API:** 此接口为系统接口
**系统API:** 此接口为系统接口,三方应用不支持调用
**参数:**
......@@ -268,7 +268,7 @@ setDefaultApplication(type: string, elementName: ElementName, userId: number, ca
**系统能力:** SystemCapability.BundleManager.BundleFramework
**System API:** 此接口为系统接口
**系统API:** 此接口为系统接口,三方应用不支持调用
**参数:**
......@@ -317,7 +317,7 @@ setDefaultApplication(type: string, elementName: ElementName, callback: AsyncCal
**系统能力:** SystemCapability.BundleManager.BundleFramework
**System API:** 此接口为系统接口
**系统API:** 此接口为系统接口,三方应用不支持调用
**参数:**
......@@ -365,7 +365,7 @@ resetDefaultApplication(type: string, userId?: number): Promise\<void>
**系统能力:** SystemCapability.BundleManager.BundleFramework
**System API:** 此接口为系统接口
**系统API:** 此接口为系统接口,三方应用不支持调用
**参数:**
......@@ -404,7 +404,7 @@ resetDefaultApplication(type: string, userId: number, callback: AsyncCallback\<v
**系统能力:** SystemCapability.BundleManager.BundleFramework
**System API:** 此接口为系统接口
**系统API:** 此接口为系统接口,三方应用不支持调用
**参数:**
......@@ -444,7 +444,7 @@ resetDefaultApplication(type: string, callback: AsyncCallback\<void>) : void;
**系统能力:** SystemCapability.BundleManager.BundleFramework
**System API:** 此接口为系统接口
**系统API:** 此接口为系统接口,三方应用不支持调用
**参数:**
......
# RemoteAbilityInfo
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 8 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
包含基本远程能力信息
## RemoteAbilityInfo
**系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | -------------------------------------------- | ---- | ---- | ----------------------- |
| elementName | [ElementName](js-apis-bundle-ElementName.md) | 是 | 否 | 指明的ability信息 |
| label | string | 是 | 否 | 指明ability的标签信息 |
| icon | string | 是 | 否 | 指明的ability的图标信息 |
# DispatchInfo
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
调度信息类
## DispatchInfo
**系统能力**: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
| 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | ------ | ---- | ---- | ------------------------ |
| verison | string | 是 | 否 | 包含dispatchInfo版本信息 |
| dispatchAPI | string | 是 | 否 | 包含免安装接口版本号 |
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册