HarmonyOS API：@ohos.bundle (Bundle模块)

版本：v3.1 Beta

@ohos.bundle (Bundle模块)

更新时间: 2023-02-17 09:19

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

说明

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

导入模块

import bundle from '@ohos.bundle';

权限列表

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

bundle.getApplicationInfo^deprecated

从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

参数：

返回值：

示例：

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

从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

参数：

示例：

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

从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

参数：

示例：

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

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

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

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

需要权限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

返回值：

示例：

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

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

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

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

需要权限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

示例：

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

从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

参数：

示例：

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

从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

参数：

返回值：

示例：

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

从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

参数：

示例：

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

从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

参数：

示例：

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

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

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

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

需要权限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

返回值：

示例：

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

从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

参数：

示例：

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.getAllApplicationInfo^deprecated

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

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

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

需要权限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

示例：

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.getBundleArchiveInfo^deprecated

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

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

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

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

返回值：

示例：

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.getBundleArchiveInfo^deprecated

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

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

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

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

示例：

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.getAbilityInfo^deprecated

从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

参数：

返回值：

示例：

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

从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

参数：

示例：

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.getAbilityLabel^{8+ 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

参数：

返回值：

示例：

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));
})

文章转载自：​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/js-apis-bundle-0000001477981489-V3?catalogVersion=V3#ZH-CN_TOPIC_0000001477981489__导入模块​​