0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

鸿蒙开发接口应用程序包管理:【Bundle模块(JS端SDK接口)】

jf_46214456 来源:jf_46214456 作者:jf_46214456 2024-05-22 15:20 次阅读

Bundle模块(JS端SDK接口)

icon-note.gif说明: 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 API9 当前为Canary版本,仅供试用,不保证接口可稳定调用。

导入模块

import bundle from '@ohos.bundle';

开发前请熟悉鸿蒙开发指导文档 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

系统能力

SystemCapability.BundleManager.BundleFramework

权限列表

权限权限等级描述
ohos.permission.GET_BUNDLE_INFOnormal仅限查询本应用信息
ohos.permission.GET_BUNDLE_INFO_PRIVILEGEDsystem_basic可查询所有应用信息
ohos.permission.INSTALL_BUNDLEsystem_core可安装、卸载应用

bundle.getApplicationInfo

getApplicationInfo(bundleName: string, bundleFlags: number, userId?: number): Promise

以异步方法根据给定的包名获取ApplicationInfo,使用Promise形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数

名称类型必填描述
bundleNamestring要查询的应用程序包名称。
bundleFlagsnumber用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。
userIdnumber用户ID。默认值:调用方所在用户,取值范围:大于等于0。

返回值:

类型说明
Promise<[ApplicationInfo]>Promise形式返回应用程序信息。

示例:

let bundleName = "com.example.myapplication";
let bundleFlags = 0;
let userId = 100;
bundle.getApplicationInfo(bundleName, bundleFlags, userId)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getApplicationInfo

getApplicationInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback): void

以异步方法根据给定的包名获取ApplicationInfo,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring要查询的应用程序包名称。
bundleFlagsnumber用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。
userIdnumber用户ID。默认值:调用方所在用户,取值范围:大于等于0。
callbackAsyncCallback<[ApplicationInfo]>程序启动作为入参的回调函数,返回应用程序信息。

示例:

let bundleName = "com.example.myapplication";
let bundleFlags = 0;
let userId = 100;
bundle.getApplicationInfo(bundleName, bundleFlags, userId, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
 })

bundle.getApplicationInfo

getApplicationInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback): void

以异步方法根据给定的包名获取ApplicationInfo,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring要查询的应用程序包名称。
bundleFlagsnumber用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。
callbackAsyncCallback<[ApplicationInfo]>程序启动作为入参的回调函数,返回应用程序信息。

示例:

let bundleName = "com.example.myapplication";
let bundleFlags = 0;
bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
 })

bundle.getAllBundleInfo

getAllBundleInfo(bundleFlag: BundleFlag, userId?: number): Promise>

以异步方法获取系统中所有可用的BundleInfo,使用Promise形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleFlagBundleFlag用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。
userIdnumber用户ID。默认值:调用方所在用户,取值范围:大于等于0。

返回值:

类型说明
Promise>Promise形式返回所有可用的BundleInfo

示例:

let bundleFlag = 0;
let userId = 100;
bundle.getAllBundleInfo(bundleFlag, userId)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getAllBundleInfo

getAllBundleInfo(bundleFlag: BundleFlag, callback: AsyncCallback>): void

以异步方法获取系统中所有可用的BundleInfo,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleFlagBundleFlag用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。
callbackAsyncCallback>程序启动作为入参的回调函数,返回所有可用的BundleInfo。

示例:

let bundleFlag = 0;
bundle.getAllBundleInfo(bundleFlag, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
 })

bundle.getAllBundleInfo

getAllBundleInfo(bundleFlag: BundleFlag, userId: number, callback: AsyncCallback>): void

以异步方法获取系统中所有可用的BundleInfo,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleFlagBundleFlag用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。
userIdnumber用户ID。默认值:调用方所在用户,取值范围:大于等于0。
callbackAsyncCallback>程序启动作为入参的回调函数,返回所有可用的BundleInfo。

示例:

let bundleFlag = 0;
let userId = 100;
bundle.getAllBundleInfo(bundleFlag, userId, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
 })

bundle.getBundleInfo

getBundleInfo(bundleName: string, bundleFlags: number, options?: BundleOptions): Promise

以异步方法根据给定的包名获取BundleInfo,使用Promise形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring包名
bundleFlagsnumber用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。
options[BundleOptions]包含userid。

返回值:

类型说明
Promise<[BundleInfo]>返回值为Promise对象,Promise中包含包信息。

示例:

let bundleName = "com.example.myapplication";
let bundleFlags = 1;
let options = {
  "userId" : 100
};
bundle.getBundleInfo(bundleName, bundleFlags, options)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getBundleInfo

getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback): void

以异步方法根据给定的包名获取BundleInfo,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring包名
bundleFlagsnumber用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。
callbackAsyncCallback<[BundleInfo]>程序启动作为入参的回调函数,返回包信息。

示例:

let bundleName = "com.example.myapplication";
let bundleFlags = 1;
bundle.getBundleInfo(bundleName, bundleFlags, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.getBundleInfo

getBundleInfo(bundleName: string, bundleFlags: number, options: BundleOptions, callback: AsyncCallback): void

以异步方法根据给定的包名获取BundleInfo,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring包名
bundleFlagsnumber用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。
options[BundleOptions]包含userid。
callbackAsyncCallback<[BundleInfo]>程序启动作为入参的回调函数,返回包信息。

示例:

let bundleName = "com.example.myapplication";
let bundleFlags = 1;
let options = {
  "userId" : 100
};
bundle.getBundleInfo(bundleName, bundleFlags, options, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.getAllApplicationInfo

getAllApplicationInfo(bundleFlags: number, userId?: number): Promise>

获取指定用户下所有已安装的应用信息,通过Promise获取返回值。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleFlagsnumber用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。
userIdnumber用户ID。默认值:调用方所在用户,取值范围:大于等于0。

返回值:

类型说明
Promise>返回值为Promise对象,Promise中包含应用信息列表。

示例:

let bundleFlags = 8;
let userId = 100;
bundle.getAllApplicationInfo(bundleFlags, userId)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getAllApplicationInfo

getAllApplicationInfo(bundleFlags: number, userId: number, callback: AsyncCallback>): void

获取指定用户下所有已安装的应用信息,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleFlagsnumber用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。
userIdnumber用户ID。默认值:调用方所在用户,取值范围:大于等于0。
callbackAsyncCallback>程序启动作为入参的回调函数,返回应用信息列表。

示例:

let bundleFlags = 8;
let userId = 100;
bundle.getAllApplicationInfo(bundleFlags, userId, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.getAllApplicationInfo

getAllApplicationInfo(bundleFlags: number, callback: AsyncCallback>) : void;

获取指定用户下所有已安装的应用信息,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleFlagsnumber用于指定返回的应用信息对象中包含信息的标记。默认值:0,取值范围:大于等于0。
callbackAsyncCallback>程序启动作为入参的回调函数,返回应用信息列表。

示例:

let bundleFlags = 8;
bundle.getAllApplicationInfo(bundleFlags, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.getBundleInstaller

getBundleInstaller(): Promise;

获取用于安装包的接口

需要权限:

ohos.permission.INSTALL_BUNDLE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

返回值:

类型说明
Promise<[BundleInstaller]>返回值为Promise对象,Promise中包含安装信息。

bundle.getBundleInstaller

getBundleInstaller(callback: AsyncCallback): void;

获取用于安装包的接口

需要权限:

ohos.permission.INSTALL_BUNDLE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

参数:

名称类型必填描述
callbackAsyncCallback<[BundleInstaller]>安装应用程序包。

bundle.getBundleArchiveInfo

getBundleArchiveInfo(hapFilePath: string, bundleFlags: number, callback: AsyncCallback) : void

获取有关ohos能力包(HAP)中包含的应用程序包的信息

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
hapFilePathstring指示存储HAP的路径,路径应该是数据的相对路径。
bundleFlagsnumber指示用于指定要删除的BundleInfo对象中包含的信息的标志。
callbackAsyncCallback<[BundleInfo]>程序启动作为入参的回调函数,返回BundleInfo信息。

bundle.getBundleArchiveInfo

getBundleArchiveInfo(hapFilePath: string, bundleFlags: number) : Promise;

获取有关ohos能力包(HAP)中包含的应用程序包的信息

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
hapFilePathstring指示存储HAP的路径,路径应该是数据的相对路径。
bundleFlagsnumber指示用于指定要删除的BundleInfo对象中包含的信息的标志。

返回值:

类型说明
Promise<[BundleInfo]>返回值为Promise对象,Promise中包含应用包的信息。

bundle.cleanBundleCacheFiles8+

cleanBundleCacheFiles(bundleName: string, callback: AsyncCallback): void;

清除指定应用程序的缓存数据

需要权限:

ohos.permission.REMOVE_CACHE_FILES

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

参数:

名称类型必填描述
bundleNamestring指示要清除其缓存数据的应用程序包名称.
callbackAsyncCallback为返回操作结果而调用的回调。

bundle.cleanBundleCacheFiles8+

cleanBundleCacheFiles(bundleName: string): Promise

清除指定应用程序的缓存数据

需要权限:

ohos.permission.REMOVE_CACHE_FILES

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

参数:

名称类型必填描述
bundleNamestring指示要清除其缓存数据的应用程序包名称.

返回值:

类型说明
Promise返回值为Promise对象,Promise中为空。

bundle.setApplicationEnabled8+

setApplicationEnabled(bundleName: string, isEnable: boolean, callback: AsyncCallback): void;

设置是否启用指定的应用程序

需要权限:

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

参数:

名称类型必填描述
bundleNamestring应用程序包名称。
isEnableboolean指定是否启用应用程序。true表示启用,false禁用。
callbackAsyncCallback为返回操作结果而调用的回调。

bundle.setApplicationEnabled8+

setApplicationEnabled(bundleName: string, isEnable: boolean): Promise

设置是否启用指定的应用程序

需要权限:

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

参数:

名称类型必填描述
bundleNamestring应用程序包名称。
isEnableboolean指定是否启用应用程序。true表示启用,false禁用。

返回值:

类型说明
Promise返回值为Promise对象,Promise中为空。

bundle.setAbilityEnabled8+

setApplicationEnabled(bundleName: string, isEnable: boolean, callback: AsyncCallback): void;

设置是否启用指定的功能

需要权限:

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

参数:

名称类型必填描述
info[AbilityInfo]Ability信息。
isEnableboolean指定是否启用应用程序。true表示启用,false禁用。
callbackAsyncCallback为返回操作结果而调用的回调。

bundle.setAbilityEnabled8+

setAbilityEnabled(info: AbilityInfo, isEnable: boolean): Promise

设置是否启用指定的功能

需要权限:

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

参数:

名称类型必填描述
info[AbilityInfo]Ability信息。
isEnableboolean指定是否启用应用程序。true表示启用,false禁用。

返回值:

类型说明
Promise返回值为Promise对象,Promise中为空。

bundle.getPermissionDef8+

getPermissionDef(permissionName: string, callback: AsyncCallback): void;

按权限名称获取权限的详细信息

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

参数:

名称类型必填描述
permissionNamestring指定权限的名称。
callbackAsyncCallback<[PermissionDef]>程序启动作为入参的回调函数,返回定义的权限信息。

bundle.getPermissionDef8+

getPermissionDef(permissionName: string): Promise

按权限名称获取权限的详细信息

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

参数:

名称类型必填描述
permissionNamestring指定权限的名称。

返回值:

类型说明
Promise<[PermissionDef]>返回值为Promise对象,Promise中包含定义的权限信息对象。

bundle.setModuleUpgradeFlag9+

setModuleUpgradeFlag(bundleName: string, moduleName: string, upgradeFlag: UpgradeFlag, callback: AsyncCallback):void;

设置模块是否需要升级

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

参数:

名称类型必填描述
bundleNamestring应用程序包名称。
moduleNamestring应用程序模块名称。
upgradeFlag[UpgradeFlag]仅供内部系统使用标志位
callbackAsyncCallback为返回操作结果而调用的回调。

bundle.setModuleUpgradeFlag9+

setModuleUpgradeFlag(bundleName: string, moduleName: string, upgradeFlag: UpgradeFlag): Promise

设置模块是否需要升级

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

参数:

名称类型必填描述
bundleNamestring应用程序包名称。
moduleNamestring应用程序模块名称。
upgradeFlag[UpgradeFlag]仅供内部系统使用标志位

返回值:

类型说明
Promise返回值为Promise对象,Promise中为空。

bundle.isModuleRemovable9+

isModuleRemovable(bundleName: string, moduleName: string, callback: AsyncCallback): void;

检查指定模块是否被移除

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

参数:

名称类型必填描述
bundleNamestring应用程序包名称。
moduleNamestring应用程序模块名称。
callbackAsyncCallback程序启动作为入参的回调函数,返回boolean信息。

bundle.isModuleRemovable9+

isModuleRemovable(bundleName: string, moduleName: string): Promise

检查指定模块是否被移除

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

此接口为系统接口,三方应用不支持调用

参数:

名称类型必填描述
bundleNamestring应用程序包名称。
moduleNamestring应用程序模块名称。

返回值:

类型说明
PromisePromise形式返回boolean信息。

bundle.getAbilityInfo

getAbilityInfo(bundleName: string, abilityName: string): Promise

通过包名称和abilityName获取Ability信息,使用Promise形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring应用程序包名。
abilityNamestringAbility名称。

返回值:

类型说明
Promise<[AbilityInfo]>Promise形式返回Ability信息。

示例:

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getAbilityInfo

getAbilityInfo(bundleName: string, abilityName: string, callback: AsyncCallback): void;

通过包名称和abilityName获取Ability信息,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring应用程序包名。
abilityNamestringAbility名称。
callbackAsyncCallback<[AbilityInfo]>程序启动作为入参的回调函数,返回Ability信息。

示例:

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.getAbilityInfo9+

getAbilityInfo(bundleName: string, moduleName: string, abilityName: string): Promise

通过包名称、moduleName和abilityName获取Ability信息,使用Promise形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring应用程序包名。
moduleNamestringModule名称。
abilityNamestringAbility名称。

返回值:

类型说明
Promise<[AbilityInfo]>Promise形式返回Ability信息。

示例:

let bundleName = "com.example.myapplication";
let moduleName = "entry";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, moduleName, abilityName)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getAbilityInfo9+

getAbilityInfo(bundleName: string, moduleName: string, abilityName: string, callback: AsyncCallback): void;

通过包名称、moduleName和abilityName获取Ability信息,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring应用程序包名。
moduleNamestringModule名称。
abilityNamestringAbility名称。
callbackAsyncCallback<[AbilityInfo]>程序启动作为入参的回调函数,返回Ability信息。

示例:

let bundleName = "com.example.myapplication";
let moduleName = "entry";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, moduleName, abilityName, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.getAbilityLabel8+

getAbilityLabel(bundleName: string, abilityName: string): Promise

通过包名称和abilityName获取应用名称,使用Promise形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring应用程序包名。
abilityNamestringAbility名称。

返回值:

类型说明
PromisePromise形式返回应用名称信息。

示例:

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityLabel(bundleName, abilityName)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getAbilityLabel8+

getAbilityLabel(bundleName: string, abilityName: string, callback : AsyncCallback): void

通过包名称和abilityName获取应用名称,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring应用程序包名。
abilityNamestringAbility名称。
callbackAsyncCallback程序启动作为入参的回调函数,返回应用名称信息。

示例:

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityLabel(bundleName, abilityName, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.getAbilityLabel9+

getAbilityLabel(bundleName: string, moduleName: string, abilityName: string): Promise

通过包名称、moduleName和abilityName获取应用名称,使用Promise形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring应用程序包名。
moduleNamestringModule名称。
abilityNamestringAbility名称。

返回值:

类型说明
PromisePromise形式返回应用名称信息。

示例:

let bundleName = "com.example.myapplication";
let moduleName = "entry";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityLabel(bundleName, moduleName, abilityName)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getAbilityLabel9+

getAbilityLabel(bundleName: string, moduleName: string, abilityName: string, callback : AsyncCallback): void

通过包名称、moduleName和abilityName获取应用名称,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring应用程序包名。
moduleNamestringModule名称。
abilityNamestringAbility名称。
callbackAsyncCallback程序启动作为入参的回调函数,返回应用名称信息。

示例:

let bundleName = "com.example.myapplication";
let moduleName = "entry";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityLabel(bundleName, moduleName, abilityName, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.isAbilityEnabled8+

isAbilityEnabled(info: AbilityInfo): Promise

以异步方法根据给定的AbilityInfo查询ability是否已经启用,使用Promise形式返回结果。

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
info[AbilityInfo]Ability的配置信息

返回值:

类型说明
PromisePromise形式返回boolean代表是否启用。

示例:

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)= >{
    bundle.isAbilityEnabled(abilityInfo).then((data) = > {
        console.info('Operation successful. Data: ' + JSON.stringify(data));
    }).catch((error) = > {
        console.error('Operation failed. Cause: ' + JSON.stringify(error));
    })
})

bundle.isAbilityEnabled8+

isAbilityEnabled(info : AbilityInfo, callback : AsyncCallback): void

以异步方法根据给定的AbilityInfo查询ability是否已经启用,使用callback形式返回结果。

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
info[AbilityInfo]Ability的配置信息
callbackAsyncCallback返回boolean代表是否启用

示例:

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)= >{
    bundle.isAbilityEnabled(abilityInfo, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
    })
})

bundle.isApplicationEnabled8+

isApplicationEnabled(bundleName: string): Promise

以异步方法根据给定的包名查询指定应用程序是否已经启用,使用Promise形式返回结果。

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring要查询的应用程序包名称。

返回值:

类型说明
PromisePromise形式返回boolean代表是否启用。

示例:

let bundleName = "com.example.myapplication";
bundle.isApplicationEnabled(bundleName)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.isApplicationEnabled8+

isApplicationEnabled(bundleName: string, callback : AsyncCallback): void

以异步方法根据给定的包名查询指定应用程序是否已经启用,使用callback形式返回结果。

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring要查询的应用程序包名称。
callbackAsyncCallback返回boolean代表是否启用

示例:

let bundleName = "com.example.myapplication";
bundle.isApplicationEnabled(bundleName, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.queryAbilityByWant

queryAbilityByWant(want: Want, bundleFlags: number, userId?: number): Promise>

以异步方法根据给定的意图获取Ability信息,使用Promise形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
want[Want]包含要查询的应用程序包名称的意图。
bundleFlagsnumber用于指定返回abilityInfo信息。默认值:0,取值范围:大于等于0。
userIdnumber用户ID。默认值:调用方所在用户,取值范围:大于等于0

返回值:

类型说明
Promise>Promise形式返回Ability信息。

示例:

let bundleFlags = 0;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};
bundle.queryAbilityByWant(want, bundleFlags, userId)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.queryAbilityByWant

queryAbilityByWant(want: Want, bundleFlags: number, userId: number, callback: AsyncCallback>): void

以异步方法根据给定的意图获取Ability信息,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
want[Want]指示包含要查询的应用程序包名称的意图。
bundleFlagsnumber用于指定返回abilityInfo信息。默认值:0,取值范围:大于等于0。
userIdnumber用户ID。默认值:调用方所在用户,取值范围:大于等于0
callbackAsyncCallback>程序启动作为入参的回调函数,返回Ability信息。

示例:

let bundleFlags = 0;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};
bundle.queryAbilityByWant(want, bundleFlags, userId, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.queryAbilityByWant

queryAbilityByWant(want: Want, bundleFlags: number, callback: AsyncCallback>): void;

以异步方法根据给定的意图获取Ability信息,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
want[Want]指示包含要查询的应用程序包名称的意图。
bundleFlagsnumber用于指定返回abilityInfo信息。默认值:0,取值范围:大于等于0。
callbackAsyncCallback>程序启动作为入参的回调函数,返回Ability信息。

示例:

let bundleFlags = 0;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};
bundle.queryAbilityByWant(want, bundleFlags, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.getLaunchWantForBundle

getLaunchWantForBundle(bundleName: string): Promise

以异步方法查询拉起指定应用的want对象,使用Promise形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring要查询的应用程序包名称。

返回值:

类型说明
Promise<[Want]>返回值为Promise对象,Promise中包含拉起指定应用的Want对象。

示例:

let bundleName = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getLaunchWantForBundle

getLaunchWantForBundle(bundleName: string, callback: AsyncCallback): void;

以异步方法查询拉起指定应用的want对象,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring要查询的应用程序包名称。
callbackAsyncCallback<[Want]>程序启动作为入参的回调函数,返回拉起指定应用的want对象。

示例:

let bundleName = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.getNameForUid8+

getNameForUid(uid: number): Promise

以异步方法通过uid获取对应的包名,使用Promise形式返回结果。

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
uidnumber要查询的uid。

返回值:

类型说明
Promise返回值为Promise对象,Promise中包含指定uid的包名。

示例:

let uid = 20010005;
bundle.getNameForUid(uid)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getNameForUid8+

getNameForUid(uid: number, callback: AsyncCallback) : void

以异步方法通过uid获取对应的包名,使用callback形式返回结果。

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
uidnumber要查询的uid。
callbackAsyncCallback程序启动作为入参的回调函数,返回指定uid的包名。

示例:

let uid = 20010005;
bundle.getNameForUid(uid, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.getAbilityIcon8+

getAbilityIcon(bundleName: string, abilityName: string): Promise;

以异步方法通过bundleName和abilityName获取对应Icon的[PixelMap],使用Promise形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring要查询的bundleName。
abilityNamestring要查询的abilityName。

返回值:

类型说明
Promise返回值为[PixelMap]。

示例:

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityIcon(bundleName, abilityName)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getAbilityIcon8+

getAbilityIcon(bundleName: string, abilityName: string, callback: AsyncCallback): void;

以异步方法通过bundleName和abilityName获取对应Icon的[PixelMap],使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring要查询的bundleName。
abilityNamestring要查询的abilityName。
callbackAsyncCallback程序启动作为入参的回调函数,返回指定[PixelMap]。

示例:

let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityIcon(bundleName, abilityName, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.getAbilityIcon9+

getAbilityIcon(bundleName: string, moduleName: string, abilityName: string): Promise;

以异步方法通过bundleName、moduleName和abilityName获取对应Icon的[PixelMap],使用Promise形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring要查询的bundleName。
moduleNamestringmoduleName。
abilityNamestring要查询的abilityName。

返回值:

类型说明
Promise返回值为[PixelMap]。

示例:

let bundleName = "com.example.myapplication";
let moduleName = "entry";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityIcon(bundleName, moduleName, abilityName)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getAbilityIcon9+

getAbilityIcon(bundleName: string, moduleName: string, abilityName: string, callback: AsyncCallback): void;

以异步方法通过bundleName、moduleName和abilityName获取对应Icon的[PixelMap],使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring要查询的bundleName。
moduleNamestringmoduleName。
abilityNamestring要查询的abilityName。
callbackAsyncCallback程序启动作为入参的回调函数,返回指定[PixelMap]。

示例:

let bundleName = "com.example.myapplication";
let moduleName = "entry";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityIcon(bundleName, moduleName, abilityName, (err, data) = > {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.queryExtensionAbilityInfos9+

queryExtensionAbilityInfos(want: Want, extensionType: number, extensionFlags: number, userId?: number): Promise>

以异步方法根据给定的意图获取ExtensionAbility信息,使用Promise形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
want[Want]包含要查询的应用程序包名称的意图。
extensionTypenumber用于指定查找的extensionAbilityInfo的类型。 默认值:0,取值范围:枚举值: [ExtensionAbilityType]
extensionFlagsnumber用于指定返回ExtensionAbilityInfo信息。默认值:0,取值范围:枚举值: [ExtensionFlags]
userIdnumber用户ID。默认值:调用方所在用户,取值范围:大于等于0

返回值:

类型说明
Promise>Promise形式返回ExtensionAbility信息。

示例:

let extensionType = 0;
let extensionFlags = 0;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};
bundle.queryExtensionAbilityInfos(want, extensionType, extensionFlags, userId)
.then((data) = > {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) = > {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.queryExtensionAbilityInfos9+

queryExtensionAbilityInfos(want: Want, extensionType: number, extensionFlags: number, userId: number, callback: AsyncCallback>): void

以异步方法根据给定的意图获取ExtensionAbility信息,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
want[Want]指示包含要查询的应用程序包名称的意图。
extensionTypenumber用于指定查找的extensionAbilityInfo的类型。 默认值:0,取值范围:枚举值: [ExtensionAbilityType]
extensionFlagsnumber用于指定返回ExtensionAbilityInfo信息。默认值:0,取值范围:枚举值: [ExtensionFlags]
userIdnumber用户ID。默认值:调用方所在用户,取值范围:大于等于0
callbackAsyncCallback>程序启动作为入参的回调函数,返回ExtensionAbility信息。

示例:

let extensionType = 0;
let extensionFlags = 0;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};
const receiver = function onReceive(err, data) {
    var errValue = JSON.stringify(err)
    var dataValue = JSON.stringify(data)
    console.error('Operation failed. Cause: ' + errValue);
    console.error('Operation failed. Cause: ' + dataValue);
}
bundle.queryExtensionAbilityInfos(want, extensionType, extensionFlags, userId, receiver)

bundle.queryExtensionAbilityInfos9+

queryExtensionAbilityInfos(want: Want, extensionType: number, extensionFlags: number, callback: AsyncCallback>): void;

以异步方法根据给定的意图获取ExtensionAbility信息,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
want[Want](指示包含要查询的应用程序包名称的意图。
extensionTypenumber用于指定查找的extensionAbilityInfo的类型。 默认值:0,取值范围:枚举值: [ExtensionAbilityType]
extensionFlagsnumber用于指定返回ExtensionAbilityInfo信息。默认值:0,取值范围:枚举值: [ExtensionFlags]
callbackAsyncCallback>程序启动作为入参的回调函数,返回ExtensionAbility信息。

示例:

let extensionType = 0;
let extensionFlags = 0;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};
const receiver = function onReceive(err, data) {
    var errValue = JSON.stringify(err)
    var dataValue = JSON.stringify(data)
    console.error('Operation failed. Cause: ' + errValue);
    console.error('Operation failed. Cause: ' + dataValue);
}
bundle.queryExtensionAbilityInfos(want, extensionType, extensionFlags, receiver)

InstallErrorCode

系统能力: SystemCapability.BundleManager.BundleFramework

名称默认值说明
SUCCESS0安装成功
STATUS_INSTALL_FAILURE1安装失败(不存在安装的应用)
STATUS_INSTALL_FAILURE_ABORTED2安装中止
STATUS_INSTALL_FAILURE_INVALID3安装参数无效
STATUS_INSTALL_FAILURE_CONFLICT4安装冲突 (常见于升级和已有应用基本信息不一致)
STATUS_INSTALL_FAILURE_STORAGE5存储包信息失败
STATUS_INSTALL_FAILURE_INCOMPATIBLE6安装不兼容(常见于版本降级安装或者签名信息错误)
STATUS_UNINSTALL_FAILURE7卸载失败 (不存在卸载的应用)
STATUS_UNINSTALL_FAILURE_BLOCKED8卸载中止 (没有使用)
STATUS_UNINSTALL_FAILURE_ABORTED9卸载中止 (参数无效导致)
STATUS_UNINSTALL_FAILURE_CONFLICT10卸载冲突 (卸载系统应用失败, 结束应用进程失败)
STATUS_INSTALL_FAILURE_DOWNLOAD_TIMEOUT0x0B安装失败 (下载超时)
STATUS_INSTALL_FAILURE_DOWNLOAD_FAILED0x0C安装失败 (下载失败)
STATUS_RECOVER_FAILURE_INVALID8+0x0D恢复预置应用失败
STATUS_ABILITY_NOT_FOUND0x40Ability未找到
STATUS_BMS_SERVICE_ERROR0x41BMS服务错误
STATUS_FAILED_NO_SPACE_LEFT8+0x42设备空间不足
STATUS_GRANT_REQUEST_PERMISSIONS_FAILED8+0x43应用授权失败
STATUS_INSTALL_PERMISSION_DENIED8+0x44安装权限拒绝
STATUS_UNINSTALL_PERMISSION_DENIED8+0x45卸载权限拒绝

BundleFlag

包的标志

系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework

名称默认值说明
GET_BUNDLE_DEFAULT0x00000000获取默认的应用信息
GET_BUNDLE_WITH_ABILITIES0x00000001获取包括Ability信息的包信息
GET_ABILITY_INFO_WITH_PERMISSION0x00000002获取包括权限的Ability信息
GET_ABILITY_INFO_WITH_APPLICATION0x00000004获取包括应用的Ability信息
GET_APPLICATION_INFO_WITH_PERMISSION0x00000008获取包括权限的应用信息
GET_BUNDLE_WITH_REQUESTED_PERMISSION0x00000010获取包括所需权限的包信息
GET_ABILITY_INFO_WITH_METADATA8+0x00000020获取ability的元数据信息
GET_BUNDLE_WITH_EXTENSION_ABILITY9+0x00000020获取包括Ability信息的扩展包信息
GET_APPLICATION_INFO_WITH_METADATA8+0x00000040获取应用的元数据信息
GET_ABILITY_INFO_SYSTEMAPP_ONLY8+0x00000080获取仅包括系统应用的ability信息
GET_ABILITY_INFO_WITH_DISABLE8+0x00000100获取包括被禁用的ability信息
GET_APPLICATION_INFO_WITH_DISABLE8+0x00000200获取包括被禁用的应用信息
GET_ALL_APPLICATION_INFO0xFFFF0000获取应用所有的信息

BundleOptions

包的选项

系统能力: SystemCapability.BundleManager.BundleFramework

名称类型可读可写说明
userIdnumber用户ID。默认值:调用方所在用户,取值范围:大于等于0。

AbilityType

Ability类型

系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework

名称类型说明
UNKNOWN未知Ability类型
PAGEAbility有一个UI界面
SERVICEAbility没有UI界面
DATAAbility用于提供数据访问服务

DisplayOrientation

屏幕显示方向

系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework

名称类型说明
UNSPECIFIED屏幕方向--不指定
LANDSCAPE屏幕方向--横屏
PORTRAIT屏幕方向--竖屏
FOLLOW_RECENT屏幕方向--紧跟上一个组件

LaunchMode

启动模式

系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework

名称类型说明
SINGLETON0Ability只有一个示例
STANDARD1Ability有多个示例

AbilitySubType

Ability的子类型

系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework

名称类型说明
UNSPECIFIED0未定义Ability子类型
CA1Ability子类型是带有 UI 的服务

ExtensionAbilityType9+

ExtensionAbility的类型

系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework

名称类型说明
FORM9+0ExtensionAbility的类型包括卡片
WORK_SCHEDULER9+1ExtensionAbility的类型包括行程安排
INPUT_METHOD9+2ExtensionAbility的类型包括输入法
SERVICE9+3ExtensionAbility的类型包括服务
ACCESSIBILITY9+4ExtensionAbility的类型包括无障碍
DATA_SHARE9+5ExtensionAbility的类型包括数据共享
FILE_SHARE9+6ExtensionAbility的类型包括文件共享
STATIC_SUBSCRIBER9+7ExtensionAbility的类型包括订阅者
WALLPAPER9+8ExtensionAbility的类型包括墙纸
BACKUP9+9ExtensionAbility的类型包括数据备份恢复
WINDOW9+10ExtensionAbility的窗口类型扩展信息
UNSPECIFIED9+20ExtensionAbility未指定类型

ExtensionFlag9+

扩展标志

系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework

名称默认值说明
GET_EXTENSION_INFO_DEFAULT9+0x00000000获取默认的extensionAbilityInfo
GET_EXTENSION_INFO_WITH_PERMISSION9+0x00000002获取携带权限信息的extensionAbilityInfo
GET_EXTENSION_INFO_WITH_APPLICATION9+0x00000004获取携带应用信息的extensionAbilityInfo
GET_EXTENSION_INFO_WITH_METADATA9+0x00000020获取携带元数据信息的extensionAbilityInfo

ColorMode

颜色模式

系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework

名称类型说明
AUTO_MODE-1自动模式
DARK_MODE0黑色模式
LIGHT_MODE1亮度模式

GrantStatus

授予状态

系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework

名称HarmonyOSOpenHarmony鸿蒙文档籽料:mau123789是v直接拿类型说明
PERMISSION_DENIED-1拒绝许可
PERMISSION_GRANTED0批准

搜狗高速浏览器截图20240326151344.png

UpgradeFlag

此项仅供内部系统使用

系统API:

此接口为系统接口,三方应用不支持调用

系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework

名称说明
NOT_UPGRADE9+0模块无需升级
SINGLE_UPGRADE9+1单个模块需要升级
RELATION_UPGRADE9+2关系模块需要升级

审核编辑 黄宇

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 接口
    +关注

    关注

    33

    文章

    8432

    浏览量

    150681
  • bundled
    +关注

    关注

    0

    文章

    4

    浏览量

    9083
  • bms
    bms
    +关注

    关注

    106

    文章

    965

    浏览量

    65607
  • 鸿蒙
    +关注

    关注

    57

    文章

    2301

    浏览量

    42668
收藏 人收藏

    评论

    相关推荐

    鸿蒙开发接口Ability框架:【DataAbilityHelper模块(JSSDK接口)】

    模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
    的头像 发表于 05-13 16:29 567次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b>Ability框架:【DataAbilityHelper<b class='flag-5'>模块</b>(<b class='flag-5'>JS</b><b class='flag-5'>端</b><b class='flag-5'>SDK</b><b class='flag-5'>接口</b>)】

    鸿蒙开发接口应用程序包管理:【@ohos.bundleState (设备使用信息统计)】

    模块提供设备使用信息统计能力。
    的头像 发表于 05-25 16:34 1494次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>应用程序包管理</b>:【@ohos.bundleState (设备使用信息统计)】

    鸿蒙开发接口应用程序包管理:【@ohos.zlib (Zip模块)】

    模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
    的头像 发表于 05-25 16:38 1527次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>应用程序包管理</b>:【@ohos.zlib (Zip<b class='flag-5'>模块</b>)】

    鸿蒙开发接口应用程序包管理:【ApplicationInfo】

    模块首批接口从API version 7 开始支持。后续版本的新增 接口,采用上角标单独标记接口的起始版本。
    的头像 发表于 05-25 16:40 1713次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>应用程序包管理</b>:【ApplicationInfo】

    鸿蒙开发接口应用程序包管理:【BundleInfo】

    模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
    的头像 发表于 05-25 16:43 1802次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>应用程序包管理</b>:【BundleInfo】

    鸿蒙JS开发接口请求loading怎么解决?

    鸿蒙JS开发接口请求loading?
    发表于 05-10 10:24

    OpenHarmony应用程序包整体说明

    ,便于应用市场对应用程序包的分发管理。 应用软件所包含的功能多种多样,将不同的功能特性按模块来划分和管理是一种良好的设计方式。OpenHarmony提供了同一
    发表于 09-20 15:34

    如何使用Xilinx SDK创建Linux应用程序,并进行开发和调试

    了解如何使用Xilinx SDK创建Linux应用程序。 我们还将重点介绍和演示支持Linux应用程序开发和调试的不同方面的SDK功能。
    的头像 发表于 11-20 07:03 1w次阅读

    鸿蒙开发接口应用程序包管理:【AbilityInfo】

    模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
    的头像 发表于 05-23 18:02 470次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>应用程序包管理</b>:【AbilityInfo】

    鸿蒙开发接口应用程序包管理:【CustomizeData】

    模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
    的头像 发表于 05-24 16:14 274次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>应用程序包管理</b>:【CustomizeData】

    鸿蒙开发接口应用程序包管理:【ExtensionAbilityInfo】

    模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
    的头像 发表于 05-25 16:46 1464次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>应用程序包管理</b>:【ExtensionAbilityInfo】

    鸿蒙开发接口应用程序包管理:【HapModuleInfo】

    模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本
    的头像 发表于 05-25 16:49 1529次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>应用程序包管理</b>:【HapModuleInfo】

    鸿蒙开发接口应用程序包管理:【Metadata】

    模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
    的头像 发表于 05-26 21:34 223次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>应用程序包管理</b>:【Metadata】

    鸿蒙开发接口应用程序包管理:【ModuleInfo】

    模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
    的头像 发表于 05-26 22:28 287次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>接口</b><b class='flag-5'>应用程序包管理</b>:【ModuleInfo】

    鸿蒙开发文件管理:【@ohos.statfs (statfs)】

    模块提供文件系统相关存储信息的功能,向应用程序提供获取文件系统总字节数、空闲字节数的JS接口
    的头像 发表于 06-13 09:46 238次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>文件<b class='flag-5'>管理</b>:【@ohos.statfs (statfs)】