BundleInstaller


BundleInstaller

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

在设备上安装、升级和删除捆绑包

BundleInstaller.install

install(bundleFilePaths: Array<string>, param: InstallParam, callback: AsyncCallback<InstallStatus>): void;

以异步方法在HAP中安装应用程序,使用callback形式返回结果。

需要权限:

ohos.permission.INSTALL_BUNDLE

系统能力:

SystemCapability.BundleManager.BundleFramework

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

参数:

名称 类型 必填 描述
bundleFilePaths Array<string> 指示存储应用程序包的路径。路径应该是当前应用程序的数据目录的相对路径。
param InstallParam 指定安装所需的其他参数。
callback AsyncCallback<InstallStatus> 程序启动作为入参的回调函数,返回安装状态信息。

BundleInstaller.uninstall

uninstall(bundleName: string, param: InstallParam, callback: AsyncCallback<InstallStatus>): void;

以异步方法卸载应用程序,使用callback形式返回结果。

需要权限:

ohos.permission.INSTALL_BUNDLE

系统能力:

SystemCapability.BundleManager.BundleFramework

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

参数:

名称 类型 必填 描述
bundleName string 包名
param InstallParam 指定安装所需的其他参数。
callback AsyncCallback<InstallStatus> 程序启动作为入参的回调函数,返回安装状态信息。

BundleInstaller.recover8+

recover(bundleName: string, param: InstallParam, callback: AsyncCallback<InstallStatus>): void;

以异步方法恢复一个应用程序,使用callback形式返回结果。

需要权限:

ohos.permission.INSTALL_BUNDLE

系统能力:

SystemCapability.BundleManager.BundleFramework

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

参数:

名称 类型 必填 描述
bundleName string 包名
param InstallParam 指定安装所需的其他参数。
callback AsyncCallback<InstallStatus> 程序启动作为入参的回调函数,返回安装状态信息。

HashParam9+

应用程序安装卸载信息

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

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

名称 类型 说明
moduleName string 应用程序模块名称
hashValue string 哈希值

InstallParam

应用程序安装卸载信息

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

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

名称 类型 说明
userId number 指示用户id
installFlag number 指示安装标志
isKeepData boolean 指示参数是否有数据
hashParams9+ Array<HashParam> 哈希值参数
crowdtestDeadline9+ number 测试包的被杀死时间

InstallStatus

应用程序安装状态

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

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

名称 类型 可读 可写 说明
status bundle.InstallErrorCode 表示安装或卸载错误状态码
statusMessage string 表示安装或卸载的字符串结果信息