harmony 鸿蒙@ohos.bundle.freeInstall (freeInstall模块)

2022-12-05 浏览 (874)

@ohos.bundle.freeInstall (freeInstall模块)

本模块提供免安装相关的设置和查询能力，支持BundlePackInfo、DispatchInfo等信息的查询

说明：

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

本模块接口为系统接口。

导入模块

import freeInstall from '@ohos.bundle.freeInstall';

权限列表

权限权限等级描述
ohos.permission.GET_BUNDLE_INFO_PRIVILEGEDsystem_basic可查询所有应用信息。
ohos.permission.INSTALL_BUNDLEsystem_core允许应用安装、卸载其他应用（除了企业相关应用，目前有企业InHouse应用，企业MDM应用和企业normal应用）。

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

UpgradeFlag

系统接口： 此接口为系统接口。

系统能力： SystemCapability.BundleManager.BundleFramework.FreeInstall

名称值说明
NOT_UPGRADE0模块无需升级。
SINGLE_UPGRADE1单个模块需要升级。
RELATION_UPGRADE2关系模块需要升级。

BundlePackFlag

系统接口： 此接口为系统接口。

系统能力： SystemCapability.BundleManager.BundleFramework.FreeInstall

名称值说明
GET_PACK_INFO_ALL0x00000000获取应用包pack.info的所有信息。
GET_PACKAGES0x00000001获取应用包pack.info的package信息。
GET_BUNDLE_SUMMARY0x00000002获取应用包pack.info的bundle摘要信息。
GET_MODULE_SUMMARY0x00000004获取应用包pack.info的module摘要信息。

freeInstall.setHapModuleUpgradeFlag

setHapModuleUpgradeFlag(bundleName: string, moduleName: string, upgradeFlag: UpgradeFlag, callback: AsyncCallback<void>):void;

设置指定模块是否升级。使用callback异步回调。

需要权限： ohos.permission.INSTALL_BUNDLE

系统接口： 此接口为系统接口。

系统能力： SystemCapability.BundleManager.BundleFramework.FreeInstall

参数：

参数名类型必填说明
bundleNamestring是应用Bundle名称。
moduleNamestring是应用程序模块名称。
upgradeFlagUpgradeFlag是仅供内部系统使用标志位
callbackAsyncCallback<void>是回调函数。当函数调用成功，err为null，否则为错误对象。

错误码：

以下错误码的详细介绍请参见ohos.bundle错误码。

错误码ID错误信息
17700001The specified bundle name is not found.
17700002The specified module name is not found.

示例：

import freeInstall from '@ohos.bundle.freeInstall';
let bundleName = 'com.example.myapplication';
let moduleName = 'entry';
let upgradeFlag = freeInstall.UpgradeFlag.SINGLE_UPGRADE;
try {
    freeInstall.setHapModuleUpgradeFlag(bundleName, moduleName, upgradeFlag, err => {
        if (err) {
            console.error('Operation failed:' + JSON.stringify(err));
        } else {
            console.info('Operation succeed');
        }
    });
} catch (err) {
    console.error('Operation failed:' + JSON.stringify(err));
}

setHapModuleUpgradeFlag

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

设置指定模块是否升级。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.INSTALL_BUNDLE

系统能力： SystemCapability.BundleManager.BundleFramework.FreeInstall

参数：

参数名类型必填说明
bundleNamestring是应用Bundle名称。
moduleNamestring是应用程序模块名称。
upgradeFlagUpgradeFlag是仅供内部系统使用标志位。

返回值：

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

错误码：

以下错误码的详细介绍请参见ohos.bundle错误码。

错误码ID错误信息
17700001The specified bundle name is not found.
17700002The specified module name is not found.

示例：

import freeInstall from '@ohos.bundle.freeInstall';
import { BusinessError } from '@ohos.base';
let bundleName = 'com.example.myapplication';
let moduleName = 'entry';
let upgradeFlag = freeInstall.UpgradeFlag.SINGLE_UPGRADE;
try {
    freeInstall.setHapModuleUpgradeFlag(bundleName, moduleName, upgradeFlag).then(() => {
        console.info('Operation succeed')
    }).catch((err: BusinessError) => {
        console.error('Operation failed:' + JSON.stringify(err));
    });
} catch (err) {
    console.error('Operation failed:' + JSON.stringify(err));
}

isHapModuleRemovable

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

查询指定模块是否可以被移除。使用callback异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力： SystemCapability.BundleManager.BundleFramework.FreeInstall

参数：

参数名类型必填说明
bundleNamestring是应用Bundle名称。
moduleNamestring是应用程序模块名称。
callbackAsyncCallback<boolean>是回调函数。返回true表示可以移除；返回false表示不可移除。

错误码：

以下错误码的详细介绍请参见ohos.bundle错误码。

错误码ID错误信息
17700001The specified bundle name is not found.
17700002The specified module name is not found.

示例：

import freeInstall from '@ohos.bundle.freeInstall';
let bundleName = 'com.example.myapplication';
let moduleName = 'entry';
try {
    freeInstall.isHapModuleRemovable(bundleName, moduleName, (err, data) => {
        if (err) {
            console.error('Operation failed:' + JSON.stringify(err));
        } else {
            console.info('Operation succeed:' + JSON.stringify(data));
        }
    });
} catch (err) {
    console.error('Operation failed:' + JSON.stringify(err));
}

isHapModuleRemovable

isHapModuleRemovable(bundleName: string, moduleName: string): Promise<boolean>;

查询指定模块是否可以被移除。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力： SystemCapability.BundleManager.BundleFramework.FreeInstall

参数：

参数名类型必填说明
bundleNamestring是应用Bundle名称。
moduleNamestring是应用程序模块名称。

返回值：

类型说明
Promise<boolean>Promise对象。返回true表示可以移除；返回false表示不可移除。

错误码：

以下错误码的详细介绍请参见ohos.bundle错误码。

错误码ID错误信息
17700001The specified bundle name is not found.
17700002The specified module name is not found.

示例：

import freeInstall from '@ohos.bundle.freeInstall';
import { BusinessError } from '@ohos.base';
let bundleName = 'com.example.myapplication';
let moduleName = 'entry';
try {
    freeInstall.isHapModuleRemovable(bundleName, moduleName).then(data => {
        console.info('Operation succeed:' + JSON.stringify(data));
    }).catch((err: BusinessError) => {
        console.error('Operation failed:' + JSON.stringify(err));
    });
} catch (err) {
    console.error('Operation failed:' + JSON.stringify(err));
}

getBundlePackInfo

getBundlePackInfo(bundleName: string, bundlePackFlag : BundlePackFlag, callback: AsyncCallback<BundlePackInfo>): void;

基于bundleName和bundlePackFlag来获取bundlePackInfo。使用callback异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力： SystemCapability.BundleManager.BundleFramework.FreeInstall

参数：

参数名类型必填说明
bundleNamestring是应用Bundle名称。
bundlePackFlagBundlePackFlag是指示要查询的应用包标志。
callbackAsyncCallback<BundlePackInfo>是回调函数。当函数调用成功，err为null，data为获取到的BundlePackInfo信息。否则为错误对象。

错误码：

以下错误码的详细介绍请参见ohos.bundle错误码。

错误码ID错误信息
17700001The specified bundle name is not found.

示例：

import freeInstall from '@ohos.bundle.freeInstall';
let bundleName = 'com.example.myapplication';
let bundlePackFlag = freeInstall.BundlePackFlag.GET_PACK_INFO_ALL;
try {
    freeInstall.getBundlePackInfo(bundleName, bundlePackFlag, (err, data) => {
        if (err) {
            console.error('Operation failed:' + JSON.stringify(err));
        } else {
            console.info('Operation succeed:' + JSON.stringify(data));
        }
    });
} catch (err) {
    console.error('Operation failed:' + JSON.stringify(err));
}

getBundlePackInfo

getBundlePackInfo(bundleName: string, bundlePackFlag : BundlePackFlag): Promise<BundlePackInfo>;

基于bundleName和BundlePackFlag来获取bundlePackInfo。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力： SystemCapability.BundleManager.BundleFramework.FreeInstall

参数：

参数名类型必填说明
bundleNamestring是应用程序Bundle名称。
bundlePackFlagBundlePackFlag是指示要查询的应用包标志。

返回值：

类型说明
Promise<BundlePackInfo>Promise对象，返回BundlePackInfo信息。

错误码：

以下错误码的详细介绍请参见ohos.bundle错误码。

错误码ID错误信息
17700001The specified bundle name is not found.

示例：

import freeInstall from '@ohos.bundle.freeInstall';
import { BusinessError } from '@ohos.base';
let bundleName = 'com.example.myapplication';
let bundlePackFlag = freeInstall.BundlePackFlag.GET_PACK_INFO_ALL;
try {
    freeInstall.getBundlePackInfo(bundleName, bundlePackFlag).then(data => {
        console.info('Operation succeed:' + JSON.stringify(data));
    }).catch((err: BusinessError) => {
        console.error('Operation failed:' + JSON.stringify(err));
    });
} catch (err) {
    console.error('Operation failed:' + JSON.stringify(err));
}

getDispatchInfo

getDispatchInfo(callback: AsyncCallback<DispatchInfo>): void;

获取有关dispatch版本的信息。使用callback异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力： SystemCapability.BundleManager.BundleFramework.FreeInstall

参数：

参数名类型必填说明
callbackAsyncCallback<DispatchInfo>是回调函数。当函数调用成功，err为null，data为获取到的DispatchInfo信息。否则为错误对象。

示例：

import freeInstall from '@ohos.bundle.freeInstall';
try {
    freeInstall.getDispatchInfo((err, data) => {
        if (err) {
            console.error('Operation failed:' + JSON.stringify(err));
        } else {
            console.info('Operation succeed:' + JSON.stringify(data));
        }
    });
} catch (err) {
    console.error('Operation failed:' + JSON.stringify(err));
}

getDispatchInfo

getDispatchInfo(): Promise<DispatchInfo>;

获取有关dispatch版本的信息。使用Promise异步回调。

系统接口： 此接口为系统接口。

需要权限： ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

系统能力： SystemCapability.BundleManager.BundleFramework.FreeInstall

返回值：

类型说明
Promise<DispatchInfo>Promise对象，返回DispatchInfo信息。

示例：

import freeInstall from '@ohos.bundle.freeInstall';
import { BusinessError } from '@ohos.base';
try {
    freeInstall.getDispatchInfo().then(data => {
        console.info('Operation succeed:' + JSON.stringify(data));
    }).catch((err: BusinessError) => {
        console.error('Operation failed:' + JSON.stringify(err));
    });
} catch (err) {
    console.error('Operation failed:' + JSON.stringify(err));
}

你可能感兴趣的鸿蒙文章

harmony 鸿蒙接口

harmony 鸿蒙系统公共事件定义(待停用)

harmony 鸿蒙系统公共事件定义

harmony 鸿蒙开发说明

harmony 鸿蒙企业设备管理概述（仅对系统应用开放）

harmony 鸿蒙BundleStatusCallback

harmony 鸿蒙@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony 鸿蒙@ohos.distributedBundle (分布式包管理)

harmony 鸿蒙@ohos.bundle (Bundle模块)

harmony 鸿蒙@ohos.enterprise.EnterpriseAdminExtensionAbility (企业设备管理扩展能力)

  • 所属分类： 后端技术
  • 本文标签： 软件 鸿蒙
  • 版权声明： 本文链接 https://seaxiang.com/blog/21b32c6d5fb149ec9aef5012eb96ad40