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

版本：v3.1 Beta

@ohos.bundle (Bundle模块)

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

参数：

示例：

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.isAbilityEnabled^{8+ deprecated}

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

isAbilityEnabled(info: AbilityInfo): Promise<boolean>

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

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

返回值：

示例：

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.isAbilityEnabled^{8+ deprecated}

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

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

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

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

示例：

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.isApplicationEnabled^{8+ deprecated}

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

isApplicationEnabled(bundleName: string): Promise<boolean>

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

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

返回值：

示例：

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.isApplicationEnabled^{8+ deprecated}

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

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

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

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

示例：

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

从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

参数：

返回值：

示例：

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

从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

参数：

示例：

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

从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

参数：

示例：

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

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

getLaunchWantForBundle(bundleName: string): Promise<Want>

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

需要权限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

返回值：

示例：

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

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

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

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

需要权限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

示例：

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.getNameForUid^{8+ deprecated}

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

getNameForUid(uid: number): Promise<string>

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

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

返回值：

示例：

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.getNameForUid^{8+ deprecated}

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

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

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

系统能力：

SystemCapability.BundleManager.BundleFramework

参数：

示例：

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.getAbilityIcon^{8+ deprecated}

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

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

参数：

返回值：

示例：

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.getAbilityIcon^{8+ deprecated}

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

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

参数：

示例：

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

InstallErrorCode^deprecated

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

系统能力: SystemCapability.BundleManager.BundleFramework

BundleFlag^deprecated

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

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

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

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

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

BundleOptions^deprecated

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

查询选项，包含userId。

系统能力: SystemCapability.BundleManager.BundleFramework

AbilityType^deprecated

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

Ability组件类型。

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

DisplayOrientation^deprecated

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

屏幕显示方向。

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

LaunchMode^deprecated

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

Ability组件的启动模式。

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

AbilitySubType^deprecated

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

Ability组件的子类型。

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

ColorMode^deprecated

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

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

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

GrantStatus^deprecated

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

权限授予状态。

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

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