Bundle模塊(JS端SDK接口)

說明： 本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口，采用上角標(biāo)單獨(dú)標(biāo)記接口的起始版本。 API9 當(dāng)前為Canary版本，僅供試用，不保證接口可穩(wěn)定調(diào)用。

導(dǎo)入模塊

import bundle from '@ohos.bundle';

開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

系統(tǒng)能力

SystemCapability.BundleManager.BundleFramework

權(quán)限列表

bundle.getApplicationInfo

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

以異步方法根據(jù)給定的包名獲取ApplicationInfo，使用Promise形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.getApplicationInfo

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

以異步方法根據(jù)給定的包名獲取ApplicationInfo，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

bundle.getApplicationInfo

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

以異步方法根據(jù)給定的包名獲取ApplicationInfo，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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>

以異步方法獲取系統(tǒng)中所有可用的BundleInfo，使用Promise形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.getAllBundleInfo

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

以異步方法獲取系統(tǒng)中所有可用的BundleInfo，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

bundle.getAllBundleInfo

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

以異步方法獲取系統(tǒng)中所有可用的BundleInfo，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

以異步方法根據(jù)給定的包名獲取BundleInfo，使用Promise形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.getBundleInfo

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

以異步方法根據(jù)給定的包名獲取BundleInfo，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

bundle.getBundleInfo

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

以異步方法根據(jù)給定的包名獲取BundleInfo，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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>

獲取指定用戶下所有已安裝的應(yīng)用信息，通過Promise獲取返回值。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.getAllApplicationInfo

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

獲取指定用戶下所有已安裝的應(yīng)用信息，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

bundle.getAllApplicationInfo

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

獲取指定用戶下所有已安裝的應(yīng)用信息，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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;

獲取用于安裝包的接口

需要權(quán)限：

ohos.permission.INSTALL_BUNDLE

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

返回值：

bundle.getBundleInstaller

getBundleInstaller(callback: AsyncCallback): void;

獲取用于安裝包的接口

需要權(quán)限：

ohos.permission.INSTALL_BUNDLE

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

bundle.getBundleArchiveInfo

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

獲取有關(guān)ohos能力包（HAP）中包含的應(yīng)用程序包的信息

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

bundle.getBundleArchiveInfo

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

獲取有關(guān)ohos能力包（HAP）中包含的應(yīng)用程序包的信息

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

bundle.cleanBundleCacheFiles8+

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

清除指定應(yīng)用程序的緩存數(shù)據(jù)

需要權(quán)限：

ohos.permission.REMOVE_CACHE_FILES

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

bundle.cleanBundleCacheFiles8+

cleanBundleCacheFiles(bundleName: string): Promise

清除指定應(yīng)用程序的緩存數(shù)據(jù)

需要權(quán)限：

ohos.permission.REMOVE_CACHE_FILES

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

返回值：

bundle.setApplicationEnabled8+

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

設(shè)置是否啟用指定的應(yīng)用程序

需要權(quán)限：

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

bundle.setApplicationEnabled8+

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

設(shè)置是否啟用指定的應(yīng)用程序

需要權(quán)限：

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

返回值：

bundle.setAbilityEnabled8+

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

設(shè)置是否啟用指定的功能

需要權(quán)限：

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

bundle.setAbilityEnabled8+

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

設(shè)置是否啟用指定的功能

需要權(quán)限：

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

返回值：

bundle.getPermissionDef8+

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

按權(quán)限名稱獲取權(quán)限的詳細(xì)信息

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

bundle.getPermissionDef8+

getPermissionDef(permissionName: string): Promise

按權(quán)限名稱獲取權(quán)限的詳細(xì)信息

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

返回值：

bundle.setModuleUpgradeFlag9+

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

設(shè)置模塊是否需要升級(jí)

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

bundle.setModuleUpgradeFlag9+

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

設(shè)置模塊是否需要升級(jí)

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

返回值：

bundle.isModuleRemovable9+

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

檢查指定模塊是否被移除

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

bundle.isModuleRemovable9+

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

檢查指定模塊是否被移除

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

參數(shù)：

返回值：

bundle.getAbilityInfo

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

通過包名稱和abilityName獲取Ability信息，使用Promise形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.getAbilityInfo

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

通過包名稱和abilityName獲取Ability信息，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

bundle.getAbilityInfo9+

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

通過包名稱、moduleName和abilityName獲取Ability信息，使用Promise形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.getAbilityInfo9+

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

通過包名稱、moduleName和abilityName獲取Ability信息，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

bundle.getAbilityLabel8+

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

通過包名稱和abilityName獲取應(yīng)用名稱，使用Promise形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.getAbilityLabel8+

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

通過包名稱和abilityName獲取應(yīng)用名稱，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

bundle.getAbilityLabel9+

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

通過包名稱、moduleName和abilityName獲取應(yīng)用名稱，使用Promise形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.getAbilityLabel9+

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

通過包名稱、moduleName和abilityName獲取應(yīng)用名稱，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

以異步方法根據(jù)給定的AbilityInfo查詢ability是否已經(jīng)啟用，使用Promise形式返回結(jié)果。

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.isAbilityEnabled8+

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

以異步方法根據(jù)給定的AbilityInfo查詢ability是否已經(jīng)啟用，使用callback形式返回結(jié)果。

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

以異步方法根據(jù)給定的包名查詢指定應(yīng)用程序是否已經(jīng)啟用，使用Promise形式返回結(jié)果。

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.isApplicationEnabled8+

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

以異步方法根據(jù)給定的包名查詢指定應(yīng)用程序是否已經(jīng)啟用，使用callback形式返回結(jié)果。

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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>

以異步方法根據(jù)給定的意圖獲取Ability信息，使用Promise形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.queryAbilityByWant

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

以異步方法根據(jù)給定的意圖獲取Ability信息，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

bundle.queryAbilityByWant

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

以異步方法根據(jù)給定的意圖獲取Ability信息，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

以異步方法查詢拉起指定應(yīng)用的want對(duì)象，使用Promise形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.getLaunchWantForBundle

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

以異步方法查詢拉起指定應(yīng)用的want對(duì)象，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

bundle.getNameForUid8+

getNameForUid(uid: number): Promise

以異步方法通過uid獲取對(duì)應(yīng)的包名，使用Promise形式返回結(jié)果。

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.getNameForUid8+

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

以異步方法通過uid獲取對(duì)應(yīng)的包名，使用callback形式返回結(jié)果。

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

bundle.getAbilityIcon8+

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

以異步方法通過bundleName和abilityName獲取對(duì)應(yīng)Icon的[PixelMap]，使用Promise形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.getAbilityIcon8+

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

以異步方法通過bundleName和abilityName獲取對(duì)應(yīng)Icon的[PixelMap]，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

bundle.getAbilityIcon9+

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

以異步方法通過bundleName、moduleName和abilityName獲取對(duì)應(yīng)Icon的[PixelMap]，使用Promise形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.getAbilityIcon9+

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

以異步方法通過bundleName、moduleName和abilityName獲取對(duì)應(yīng)Icon的[PixelMap]，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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>

以異步方法根據(jù)給定的意圖獲取ExtensionAbility信息，使用Promise形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

返回值：

示例：

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

bundle.queryExtensionAbilityInfos9+

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

以異步方法根據(jù)給定的意圖獲取ExtensionAbility信息，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

bundle.queryExtensionAbilityInfos9+

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

以異步方法根據(jù)給定的意圖獲取ExtensionAbility信息，使用callback形式返回結(jié)果。

需要權(quán)限：

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

系統(tǒng)能力：

SystemCapability.BundleManager.BundleFramework

參數(shù)：

示例：

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

系統(tǒng)能力: SystemCapability.BundleManager.BundleFramework

BundleFlag

包的標(biāo)志

系統(tǒng)能力: 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.BundleManager.BundleFramework

BundleOptions

包的選項(xiàng)

系統(tǒng)能力: SystemCapability.BundleManager.BundleFramework

AbilityType

Ability類型

系統(tǒng)能力: 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.BundleManager.BundleFramework

DisplayOrientation

屏幕顯示方向

系統(tǒng)能力: 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.BundleManager.BundleFramework

LaunchMode

啟動(dòng)模式

系統(tǒng)能力: 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.BundleManager.BundleFramework

AbilitySubType

Ability的子類型

系統(tǒng)能力: 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.BundleManager.BundleFramework

ExtensionAbilityType9+

ExtensionAbility的類型

系統(tǒng)能力: 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.BundleManager.BundleFramework

ExtensionFlag9+

擴(kuò)展標(biāo)志

系統(tǒng)能力: 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.BundleManager.BundleFramework

ColorMode

顏色模式

系統(tǒng)能力: 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.BundleManager.BundleFramework

GrantStatus

授予狀態(tài)

系統(tǒng)能力: 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.BundleManager.BundleFramework

UpgradeFlag

此項(xiàng)僅供內(nèi)部系統(tǒng)使用

系統(tǒng)API：

此接口為系統(tǒng)接口，三方應(yīng)用不支持調(diào)用

系統(tǒng)能力: 以下各項(xiàng)對(duì)應(yīng)的系統(tǒng)能力均為SystemCapability.BundleManager.BundleFramework

審核編輯 黃宇