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

 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>

以异步方法根据给定的包名获取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<ApplicationInfo>): 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<ApplicationInfo>): 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<Array<BundleInfo>>

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

返回值:

类型说明
Promise<Array<[BundleInfo]>>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<Array<BundleInfo>>): void

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

以异步方法根据给定的包名获取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<BundleInfo>): 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<BundleInfo>): 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<Array<ApplicationInfo>>

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

返回值:

类型说明
Promise<Array<[ApplicationInfo]>>返回值为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<Array<ApplicationInfo>>): void

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

示例:

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<Array<ApplicationInfo>>) : void;

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

示例:

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<BundleInstaller>;

获取用于安装包的接口

需要权限:

ohos.permission.INSTALL_BUNDLE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

返回值:

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

bundle.getBundleInstaller

getBundleInstaller(callback: AsyncCallback<BundleInstaller>): void;

获取用于安装包的接口

需要权限:

ohos.permission.INSTALL_BUNDLE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

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

bundle.getBundleArchiveInfo

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

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

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

bundle.getBundleArchiveInfo

getBundleArchiveInfo(hapFilePath: string, bundleFlags: number) : Promise<BundleInfo>;

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

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

返回值:

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

bundle.cleanBundleCacheFiles8+

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

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

需要权限:

ohos.permission.REMOVE_CACHE_FILES

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

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

bundle.cleanBundleCacheFiles8+

cleanBundleCacheFiles(bundleName: string): Promise<void>

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

需要权限:

ohos.permission.REMOVE_CACHE_FILES

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

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

返回值:

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

bundle.setApplicationEnabled8+

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

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

需要权限:

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

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

bundle.setApplicationEnabled8+

setApplicationEnabled(bundleName: string, isEnable: boolean): Promise<void>

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

需要权限:

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>): 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<void>

设置是否启用指定的功能

需要权限:

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<PermissionDef>): void;

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

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

bundle.getPermissionDef8+

getPermissionDef(permissionName: string): Promise<PermissionDef>

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

需要权限:

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>):void;

设置模块是否需要升级

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

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

bundle.setModuleUpgradeFlag9+

setModuleUpgradeFlag(bundleName: string, moduleName: string, upgradeFlag: UpgradeFlag): Promise<void>

设置模块是否需要升级

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

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

返回值:

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

bundle.isModuleRemovable9+

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

检查指定模块是否被移除

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

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

bundle.isModuleRemovable9+

isModuleRemovable(bundleName: string, moduleName: string): Promise<boolean>

检查指定模块是否被移除

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

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

返回值:

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

bundle.getAbilityInfo

getAbilityInfo(bundleName: string, abilityName: string): Promise<AbilityInfo>

通过包名称和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<AbilityInfo>): 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<AbilityInfo>

通过包名称、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<AbilityInfo>): 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<string>

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

返回值:

类型说明
Promise<string>Promise形式返回应用名称信息。

示例:

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<string>): void

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

示例:

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<string>

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

返回值:

类型说明
Promise<string>Promise形式返回应用名称信息。

示例:

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<string>): void

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

示例:

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<boolean>

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

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

返回值:

类型说明
Promise<boolean>Promise形式返回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<boolean>): void

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

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
info[AbilityInfo]Ability的配置信息
callbackAsyncCallback<boolean>返回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<boolean>

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

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

返回值:

类型说明
Promise<boolean>Promise形式返回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<boolean>): void

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

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
bundleNamestring要查询的应用程序包名称。
callbackAsyncCallback<boolean>返回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<Array<AbilityInfo>>

以异步方法根据给定的意图获取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<Array<[AbilityInfo]>>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<Array<AbilityInfo>>): 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<Array<[AbilityInfo]>>程序启动作为入参的回调函数,返回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<Array<AbilityInfo>>): void;

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

以异步方法查询拉起指定应用的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<Want>): 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<string>

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

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

返回值:

类型说明
Promise<string>返回值为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<string>) : void

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

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

名称类型必填描述
uidnumber要查询的uid。
callbackAsyncCallback<string>程序启动作为入参的回调函数,返回指定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<image.PixelMap>;

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

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

返回值:

类型说明
Promise<image.PixelMap>返回值为[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<image.PixelMap>): 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<image.PixelMap>程序启动作为入参的回调函数,返回指定[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<image.PixelMap>;

以异步方法通过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<image.PixelMap>返回值为[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<image.PixelMap>): 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<image.PixelMap>程序启动作为入参的回调函数,返回指定[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<Array<ExtensionAbilityInfo>>

以异步方法根据给定的意图获取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<Array<[ExtensionAbilityInfo]>>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<Array<ExtensionAbilityInfo>>): 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<Array<[ExtensionAbilityInfo]()>>程序启动作为入参的回调函数,返回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<Array<ExtensionAbilityInfo>>): 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<Array<[ExtensionAbilityInfo]>>程序启动作为入参的回调函数,返回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

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

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

UpgradeFlag

此项仅供内部系统使用

系统API:

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

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

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

最后呢,很多开发朋友不知道需要学习那些鸿蒙技术?鸿蒙开发岗位需要掌握那些核心技术点?为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少,假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料,少走很多弯路,节省没必要的麻烦。由两位前阿里高级研发工程师联合打造《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(Harmony NEXT)技术知识点

如果你是一名Android、Java、前端等等开发人员,想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

高清完整版请点击《鸿蒙NEXT星河版开发学习文档》

针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说,我们直接看详细资料鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,帮助大家在技术的道路上更进一步。

《鸿蒙 (OpenHarmony)开发学习视频》

图片

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

获取这份鸿蒙星河版学习资料,请点击→《鸿蒙NEXT星河版开发学习文档》

OpenHarmony北向、南向开发环境搭建

图片

《鸿蒙开发基础》

  1. ArkTS语言

  2. 安装DevEco Studio

  3. 运用你的第一个ArkTS应用

  4. ArkUI声明式UI开发

  5. .……

图片

《鸿蒙开发进阶》

  1. Stage模型入门

  2. 网络管理

  3. 数据管理

  4. 电话服务

  5. 分布式应用开发

  6. 通知与窗口管理

  7. 多媒体技术

  8. 安全技能

  9. 任务管理

  10. WebGL

  11. 国际化开发

  12. 应用测试

  13. DFX面向未来设计

  14. 鸿蒙系统移植和裁剪定制

  15. ……

图片

《鸿蒙开发实战》

  1. ArkTS实践

  2. UIAbility应用

  3. 网络案例

  4. ……

图片

 获取这份鸿蒙星河版学习资料,请点击→《鸿蒙NEXT星河版开发学习文档》

总结

鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程,从而开设鸿蒙课程;企业纷纷跟进启动了鸿蒙研发

并且鸿蒙是完全具备无与伦比的机遇和潜力的;预计到年底将有 5,000 款的应用完成原生鸿蒙开发,未来将会支持 50 万款的应用那么这么多的应用需要开发,也就意味着需要有更多的鸿蒙人才鸿蒙开发工程师也将会迎来爆发式的增长,学习鸿蒙势在必行!

  • 20
    点赞
  • 10
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值