@ohos.bundle (Bundle模块)

本模块提供应用信息查询能力,支持包信息应用信息Ability组件信息等信息的查询,以及应用禁用状态的查询、设置等。

说明:

本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

import bundle from '@ohos.bundle';

权限列表

权限 权限等级 描述
ohos.permission.GET_BUNDLE_INFO normal 查询指定应用信息。
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED system_basic 可查询所有应用信息。
ohos.permission.INSTALL_BUNDLE system_core 可安装、卸载应用。
ohos.permission.MANAGE_DISPOSED_APP_STATUS system_core 可设置和查询应用的处置状态。

权限等级参考权限等级说明

bundle.getApplicationInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.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

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用程序包名称。
bundleFlags number 用于指定返回的应用信息对象中包含信息的标记。取值范围请参考BundleFlag说明中应用信息相关flag。
userId number 用户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.getApplicationInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.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

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用程序包名称。
bundleFlags number 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考BundleFlag说明中应用信息相关flag。
userId number 用户ID。取值范围:大于等于0。
callback AsyncCallback<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.getApplicationInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.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

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用程序包名称。
bundleFlags number 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考BundleFlag说明中应用信息相关flag。
callback AsyncCallback<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.getAllBundleInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.getAllBundleInfo替代。

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

以异步方法获取指定用户所有的BundleInfo,使用Promise形式异步回调,

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleFlag BundleFlag 用于指定返回的包信息对象中包含信息的标记。取值范围:参考BundleFlag说明中包信息相关flag。
userId number 用户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.getAllBundleInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.getAllBundleInfo替代。

getAllBundleInfo(bundleFlag: BundleFlag, callback: AsyncCallback<Array<BundleInfo>>): void

以异步方法获取当前用户所有的BundleInfo,使用callback形式返回结果。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleFlag BundleFlag 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考BundleFlag说明中包信息相关flag。
callback AsyncCallback<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.getAllBundleInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.getAllBundleInfo替代。

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

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleFlag BundleFlag 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考BundleFlag说明中包信息相关flag。
userId number 用户ID。默认值:调用方所在用户,取值范围:大于等于0。
callback AsyncCallback<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.getBundleInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.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

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用程序包名称。
bundleFlags number 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考BundleFlag说明中包信息相关flag。
options BundleOptions 包含userid的查询选项。

返回值:

类型 说明
Promise<BundleInfo> 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.getBundleInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.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

参数:

参数名 类型 必填 说明
bundleName string 需要查询的应用程序包名称。
bundleFlags number 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考BundleFlag说明中包信息相关flag。
callback AsyncCallback<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.getBundleInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.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

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用包名。
bundleFlags number 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考BundleFlag说明中包信息相关flag。
options BundleOptions 包含userid。
callback AsyncCallback<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.getBundleInstallerdeprecated

从API version 9开始不再维护,建议使用installer.getBundleInstaller替代。

getBundleInstaller(): Promise<BundleInstaller>;

获取用于安装包的接口,使用Promise异步回调,返回安装接口对象。

需要权限:

ohos.permission.INSTALL_BUNDLE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

返回值:

类型 说明
Promise<BundleInstaller> Promise对象,返回安装接口对象。

示例:

bundle.getBundleInstaller().then((data) => {
    console.info('getBundleInstaller successfully.');
}).catch((error) => {
    console.error('getBundleInstaller failed.');
});

bundle.getBundleInstallerdeprecated

从API version 9开始不再维护,建议使用installer.getBundleInstaller替代。

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

获取用于安装包的接口,使用callback异步回调。

需要权限:

ohos.permission.INSTALL_BUNDLE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

参数名 类型 必填 说明
callback AsyncCallback<BundleInstaller> 回调函数,返回安装接口对象。

示例:

bundle.getBundleInstaller((err, data) => {
    if (err.code == 0) {
        console.error('getBundleInstaller failed.');
    } else {
        console.info('getBundleInstaller successfully');
    }
});

bundle.cleanBundleCacheFiles8+ deprecated

从API version 9开始不再维护,建议使用bundleManager.cleanBundleCacheFiles替代。

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

清除指定应用程序的缓存数据,使用callback异步回调。

需要权限:

ohos.permission.REMOVE_CACHE_FILES

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

参数名 类型 必填 说明
bundleName string 指示要清除其缓存数据的应用程序包名称。
callback AsyncCallback<void> 回调函数。

示例:

let bundleName = "com.example.myapplication";

bundle.cleanBundleCacheFiles(bundleName, err => {
    if (err) {
        console.error('cleanBundleCacheFiles failed.');
    } else {
        console.info('cleanBundleCacheFiles successfully.');
    }
});

bundle.cleanBundleCacheFiles8+ deprecated

从API version 9开始不再维护,建议使用bundleManager.cleanBundleCacheFiles替代。

cleanBundleCacheFiles(bundleName: string): Promise<void>

清除指定应用程序的缓存数据,使用Promise异步回调。

需要权限:

ohos.permission.REMOVE_CACHE_FILES

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

参数名 类型 必填 说明
bundleName string 指示要清除其缓存数据的应用程序包名称。

返回值:

类型 说明
Promise<void> Promise对象,无返回结果的Promise对象。

示例:

let bundleName = "com.example.myapplication";

bundle.cleanBundleCacheFiles(bundleName).then(()=> {
    console.info('cleanBundleCacheFiles successfully.');
}).catch(err=> {
    console.error('cleanBundleCacheFiles failed.');
});

bundle.setApplicationEnabled8+ deprecated

从API version 9开始不再维护,建议使用bundleManager.setApplicationEnabled替代。

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

设置是否启用指定的应用程序,使用callback异步回调。

需要权限:

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

参数名 类型 必填 说明
bundleName string 指示需要启用或禁用的应用程序包名称。
isEnable boolean 指定是否启用应用程序。true表示启用,false表示禁用。
callback AsyncCallback<void> 回调函数。

示例:

let bundleName = "com.example.myapplication";

bundle.setApplicationEnabled(bundleName, false, err => {
    if (err) {
        console.error('setApplicationEnabled failed.');
    } else {
        console.info('setApplicationEnabled successfully.');
    }
});

bundle.setApplicationEnabled8+ deprecated

从API version 9开始不再维护,建议使用bundleManager.setApplicationEnabled替代。

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

设置是否启用指定的应用程序,使用Promise异步回调。

需要权限:

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

参数名 类型 必填 说明
bundleName string 指示需要启用或禁用的应用程序包名称。
isEnable boolean 指定是否启用应用程序。true表示启用,false禁用。

返回值:

类型 说明
Promise<void> Promise对象,无返回结果的Promise对象。

示例:

let bundleName = "com.example.myapplication";

bundleManager.setApplicationEnabled(bundleName, false).then(()=> {
    console.info('setApplicationEnabled successfully.');
}).catch(err=> {
    console.error('setApplicationEnabled failed.');
});

bundle.setAbilityEnabled8+ deprecated

从API version 9开始不再维护,建议使用bundleManager.setAbilityEnabled替代。

setAbilityEnabled(info: AbilityInfo, isEnable: boolean, callback: AsyncCallback<void>): void;

设置是否启用指定的Ability组件,使用callback异步回调。

需要权限:

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

参数名 类型 必填 说明
info AbilityInfo Ability信息,指示需要设置启用状态的Ability。
isEnable boolean 指定是否启用应用程序。true表示启用,false禁用。
callback AsyncCallback<void> 为返回操作结果而调用的回调。

bundle.setAbilityEnabled8+ deprecated

从API version 9开始不再维护,建议使用bundleManager.setAbilityEnabled替代。

setAbilityEnabled(info: AbilityInfo, isEnable: boolean): Promise<void>

设置是否启用指定的Ability组件,使用Promise异步回调。

需要权限:

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

参数名 类型 必填 说明
info AbilityInfo Ability信息,指示需要设置启用状态的Ability。
isEnable boolean 指定是否启用应用程序。true表示启用,false禁用。

返回值:

类型 说明
Promise<void> Promise对象,无返回结果的Promise对象。

示例:

let flag = bundle.BundleFlag.GET_ABILITY_INFO_WITH_PERMISSION;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};

bundle.getAbilityInfo(want, flag, userId).then((abilityInfo) => {
    console.info('getAbilityInfo successfully. Data: ' + JSON.stringify(abilityInfo));

    bundle.setAbilityEnabled(abilityInfo, false).then(data => {
        console.info('setAbilityEnabled successfully.');
    }).catch(err => {
        console.error('setAbilityEnabled failed:' + JSON.stringify(err));
    })
}).catch(error => {
    console.error('getAbilityInfo failed. Cause: ' + JSON.stringify(error));
});

bundle.getPermissionDef8+ deprecated

从API version 9开始不再维护,建议使用bundleManager.getPermissionDef替代。

getPermissionDef(permissionName: string, callback: AsyncCallback<PermissionDef>): void;

按权限名称获取权限的详细信息,使用callback异步回调。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

参数名 类型 必填 说明
permissionName string 需要查询的权限的名称。
callback AsyncCallback<PermissionDef> 程序启动作为入参的回调函数,返回定义的权限信息。

示例:

let permission = "ohos.permission.GET_BUNDLE_INFO";
bundleManager.getPermissionDef(permission, (err, data) => {
    if (err) {
        console.error('getPermissionDef failed:' + err.message);
    } else {
        console.info('getPermissionDef successfully:' + JSON.stringify(data));
    }
});

bundle.getPermissionDef8+ deprecated

从API version 9开始不再维护,建议使用bundleManager.getPermissionDef替代。

getPermissionDef(permissionName: string): Promise<PermissionDef>

按权限名称获取权限的详细信息,使用promise异步回调。。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

系统API:

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

参数:

参数名 类型 必填 说明
permissionName string 需要查询的权限的名称。

返回值:

类型 说明
Promise<PermissionDef> Promise对象,获取成功时返回权限详细信息。

示例:

let permissionName = "ohos.permission.GET_BUNDLE_INFO";
bundle.getPermissionDef(permissionName).then((data) => {
    console.info('getPermissionDef successfully. Data: ' + JSON.stringify(data));
}).catch(error => {
    console.error('getPermissionDef failed. Cause: ' + error.message);
});

bundle.getAllApplicationInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.getAllApplicationInfo替代。

getAllApplicationInfo(bundleFlags: number, userId?: number): Promise<Array<ApplicationInfo>>

获取指定用户下所有已安装的应用信息,使用promise异步回调。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleFlags number 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考BundleFlag说明中应用信息相关flag。
userId number 用户ID。默认值:调用方所在用户,取值范围:大于等于0。

返回值:

类型 说明
Promise<Array<ApplicationInfo>> 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.getAllApplicationInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.getAllApplicationInfo替代。

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

获取指定用户下所有已安装的应用信息,使用callback异步回调。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleFlags number 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考BundleFlag说明中应用信息相关flag。
userId number 用户ID。默认值:调用方所在用户,取值范围:大于等于0。
callback AsyncCallback<Array<ApplicationInfo>> 程序启动作为入参的回调函数,返回应用信息列表。

示例:

let bundleFlags = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
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.getAllApplicationInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.getAllApplicationInfo替代。

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

获取调用方所在用户下已安装的应用信息,使用callback异步回调。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleFlags number 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考BundleFlag说明中应用信息相关flag。
callback AsyncCallback<Array<ApplicationInfo>> 程序启动作为入参的回调函数,返回应用信息列表。

示例:

let bundleFlags = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
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.getBundleArchiveInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.getBundleArchiveInfo替代。

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

获取有关HAP包中包含的应用程序包的信息,使用Promise形式返回结果。

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
hapFilePath string HAP存放路径。支持当前应用程序的绝对路径和数据目录沙箱路径。
bundleFlags number 用于指定要返回的BundleInfo对象中包含信息的标记。取值范围:参考BundleFlag说明中包信息相关flag。

返回值:

类型 说明
Promise<BundleInfo> 返回值为Promise对象,Promise中包含有关hap包中包含的应用程序的信息。

示例:

let hapFilePath = "/data/storage/el2/base/test.hap";
let bundleFlags = 0;
bundle.getBundleArchiveInfo(hapFilePath, bundleFlags)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})

bundle.getBundleArchiveInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.getBundleArchiveInfo替代。

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

以异步方法获取有关HAP包中包含的应用程序包的信息,使用callback形式返回结果。

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
hapFilePath string HAP存放路径,支持当前应用程序的绝对路径和数据目录沙箱路径。
bundleFlags number 用于指定要返回的BundleInfo对象中包含信息的标记。取值范围:参考BundleFlag说明中包信息相关flag。
callback AsyncCallback<BundleInfo> 程序启动作为入参的回调函数,返回HAP包中包含的应用程序包的信息。

示例:

let hapFilePath = "/data/storage/el2/base/test.hap";
let bundleFlags = 0;
bundle.getBundleArchiveInfo(hapFilePath, bundleFlags, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})

bundle.getAbilityInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.queryAbilityInfo替代。

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

通过包名称和组件名获取Ability组件信息,使用Promise形式异步回调。

获取调用方自己的信息时不需要权限。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleName string 应用程序包名称。
abilityName string Ability组件名称。

返回值:

类型 说明
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.getAbilityInfodeprecated

从API version 9开始不再维护,建议使用bundleManager.queryAbilityInfo替代。

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

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

获取调用方自己的信息时不需要权限。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleName string 应用程序包名称。
abilityName string Ability名称。
callback AsyncCallback<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.getAbilityLabel8+ deprecated

从API version 9开始不再维护,建议使用bundleManager.getAbilityLabel替代。

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

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

获取调用方自己的信息时不需要权限。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleName string 应用程序包名称。
abilityName string Ability名称。

返回值:

类型 说明
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+ deprecated

从API version 9开始不再维护,建议使用bundleManager.getAbilityLabel替代。

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

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

获取调用方自己的信息时不需要权限。

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleName string 应用程序包名称。
abilityName string Ability名称。
callback AsyncCallback<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.isAbilityEnabled8+ deprecated

从API version 9开始不再维护,建议使用bundleManager.isAbilityEnabled替代。

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+ deprecated

从API version 9开始不再维护,建议使用bundleManager.isAbilityEnabled替代。

isAbilityEnabled(info : AbilityInfo, callback : AsyncCallback<boolean>): void

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

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
info AbilityInfo Ability的配置信息。
callback AsyncCallback<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+ deprecated

从API version 9开始不再维护,建议使用bundleManager.isApplicationEnabled替代。

isApplicationEnabled(bundleName: string): Promise<boolean>

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

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用程序包名称。

返回值:

类型 说明
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+ deprecated

从API version 9开始不再维护,建议使用bundleManager.isApplicationEnabled替代。

isApplicationEnabled(bundleName: string, callback : AsyncCallback<boolean>): void

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

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用程序包名称。
callback AsyncCallback<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.queryAbilityByWantdeprecated

从API version 9开始不再维护,建议使用bundleManager.queryAbilityInfo替代。

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 包含要查询的应用程序包名称的意图。
bundleFlags number 用于指定返回abilityInfo信息。取值范围:参考BundleFlag说明中Ability信息相关flag。
userId number 用户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.queryAbilityByWantdeprecated

从API version 9开始不再维护,建议使用bundleManager.queryAbilityInfo替代。

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 指示包含要查询的应用程序包名称的意图。
bundleFlags number 用于指定返回abilityInfo信息。取值范围:参考BundleFlag说明中Ability信息相关flag。
userId number 用户ID。取值范围:大于等于0。
callback AsyncCallback<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.queryAbilityByWantdeprecated

从API version 9开始不再维护,建议使用bundleManager.queryAbilityInfo替代。

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 指示包含要查询的应用程序包名称的意图。
bundleFlags number 用于指定返回abilityInfo信息。取值范围:参考BundleFlag说明中Ability信息相关flag。
callback AsyncCallback<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.getLaunchWantForBundledeprecated

从API version 9开始不再维护,建议使用bundleManager.getLaunchWantForBundle替代。

getLaunchWantForBundle(bundleName: string): Promise<Want>

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用程序包名称。

返回值:

类型 说明
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.getLaunchWantForBundledeprecated

从API version 9开始不再维护,建议使用bundleManager.getLaunchWantForBundle替代。

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

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

需要权限:

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用程序包名称。
callback AsyncCallback<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+ deprecated

从API version 9开始不再维护,建议使用bundleManager.getBundleNameByUid替代。

getNameForUid(uid: number): Promise<string>

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

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
uid number 要查询的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+ deprecated

从API version 9开始不再维护,建议使用bundleManager.getBundleNameByUid替代。

getNameForUid(uid: number, callback: AsyncCallback<string>) : void

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

系统能力:

SystemCapability.BundleManager.BundleFramework

参数:

参数名 类型 必填 说明
uid number 要查询的uid。
callback AsyncCallback<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+ deprecated

从API version 9开始不再维护,建议使用resourceManager.getMediaContent替代。

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

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用包名。
abilityName string 要查询的Ability组件名。

返回值:

类型 说明
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+ deprecated

从API version 9开始不再维护,建议使用resourceManager.getMediaContent替代。

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

参数:

参数名 类型 必填 说明
bundleName string 要查询的应用包名称。
abilityName string 要查询的Ability组件名。
callback AsyncCallback<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));
})

InstallErrorCodedeprecated

从API version 9开始不再维护,不推荐使用。

系统能力: SystemCapability.BundleManager.BundleFramework

名称 说明
SUCCESS 0 安装成功
STATUS_INSTALL_FAILURE 1 安装失败(不存在安装的应用)
STATUS_INSTALL_FAILURE_ABORTED 2 安装中止
STATUS_INSTALL_FAILURE_INVALID 3 安装参数无效
STATUS_INSTALL_FAILURE_CONFLICT 4 安装冲突 (常见于升级和已有应用基本信息不一致)
STATUS_INSTALL_FAILURE_STORAGE 5 存储包信息失败
STATUS_INSTALL_FAILURE_INCOMPATIBLE 6 安装不兼容(常见于版本降级安装或者签名信息错误)
STATUS_UNINSTALL_FAILURE 7 卸载失败 (不存在卸载的应用)
STATUS_UNINSTALL_FAILURE_BLOCKED 8 卸载中止 (没有使用)
STATUS_UNINSTALL_FAILURE_ABORTED 9 卸载中止 (参数无效导致)
STATUS_UNINSTALL_FAILURE_CONFLICT 10 卸载冲突 (卸载系统应用失败, 结束应用进程失败)
STATUS_INSTALL_FAILURE_DOWNLOAD_TIMEOUT 0x0B 安装失败 (下载超时)
STATUS_INSTALL_FAILURE_DOWNLOAD_FAILED 0x0C 安装失败 (下载失败)
STATUS_RECOVER_FAILURE_INVALID8+ 0x0D 恢复预置应用失败
STATUS_ABILITY_NOT_FOUND 0x40 Ability未找到
STATUS_BMS_SERVICE_ERROR 0x41 BMS服务错误
STATUS_FAILED_NO_SPACE_LEFT8+ 0x42 设备空间不足
STATUS_GRANT_REQUEST_PERMISSIONS_FAILED8+ 0x43 应用授权失败
STATUS_INSTALL_PERMISSION_DENIED8+ 0x44 缺少安装权限
STATUS_UNINSTALL_PERMISSION_DENIED8+ 0x45 缺少卸载权限

BundleFlagdeprecated

从API version 9开始不再维护,建议使用bundleManager.BundleFlag替代。

包信息标志,指示需要获取的包信息的内容。

当接口与标志不匹配时,该标志会被忽略,例如获取application时使用GET_ABILITY_INFO_WITH_PERMISSION对结果不会产生影响。

标志可以叠加使用,例如使用GET_APPLICATION_INFO_WITH_PERMISSION + GET_APPLICATION_INFO_WITH_DISABLE可以使结果同时包含应用权限信息和被禁用的应用信息。

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

名称 说明
GET_BUNDLE_DEFAULT 0x00000000 获取默认的应用信息
GET_BUNDLE_WITH_ABILITIES 0x00000001 获取包括Ability信息的包信息
GET_ABILITY_INFO_WITH_PERMISSION 0x00000002 获取包括权限的Ability信息
GET_ABILITY_INFO_WITH_APPLICATION 0x00000004 获取包括Application的ability信息
GET_APPLICATION_INFO_WITH_PERMISSION 0x00000008 获取包括权限的应用信息
GET_BUNDLE_WITH_REQUESTED_PERMISSION 0x00000010 获取包括所需权限的包信息
GET_ABILITY_INFO_WITH_METADATA8+ 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_INFO 0xFFFF0000 获取应用所有的信息

BundleOptionsdeprecated

从API version 9开始不再维护,不推荐使用。

查询选项,包含userId。

系统能力: SystemCapability.BundleManager.BundleFramework

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

AbilityTypedeprecated

从API version 9开始不再维护,建议使用bundleManager.AbilityType替代。

Ability组件类型。

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

名称 说明
UNKNOWN 未知Ability类型
PAGE 表示基于Page模板开发的FA,用于提供与用户交互的能力
SERVICE 表示基于Service模板开发的PA,用于提供后台运行任务的能力
DATA 表示基于Data模板开发的PA,用于对外部提供统一的数据访问对象

DisplayOrientationdeprecated

从API version 9开始不再维护,建议使用bundleManager.DisplayOrientation替代。

屏幕显示方向。

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

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

LaunchModedeprecated

从API version 9开始不再维护,建议使用bundleManager.LaunchType替代。

Ability组件的启动模式。

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

名称 说明
SINGLETON 0 Ability只有一个实例
STANDARD 1 Ability有多个实例

AbilitySubTypedeprecated

从API version 9开始不再维护,不推荐使用。

Ability组件的子类型。

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

名称 说明
UNSPECIFIED 0 未定义Ability子类型
CA 1 Ability子类型是带有 UI 的服务

ColorModedeprecated

从API version 9开始不再维护,不推荐使用。

应用、卡片等的颜色模式。

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

名称 说明
AUTO_MODE -1 自动模式
DARK_MODE 0 黑色模式
LIGHT_MODE 1 亮度模式

GrantStatusdeprecated

从API version 9开始不再维护,建议使用bundleManager.PermissionGrantState替代。

权限授予状态。

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

名称 说明
PERMISSION_DENIED -1 拒绝授予权限
PERMISSION_GRANTED 0 授予权限