鸿蒙OS开发文档鸿蒙OS IBundleInstaller

2024-02-25 开发教程鸿蒙OS开发文档匿名 1℃

IBundleInstaller

更新时间: 2021-11-01 17:20

public interface IBundleInstallerextends IRemoteBroker

安装和卸载应用程序

字段摘要

修饰符和类型	字段	描述
static int	STATUS_INSTALL_FAILURE	表示由于系统或服务异常导致安装失败。
static int	STATUS_INSTALL_FAILURE_ABORTED	指示安装因用户拒绝授予权限或安装会话中断而中止。
static int	STATUS_INSTALL_FAILURE_CONFLICT	表示由于应用程序冲突导致安装失败，例如安装了具有不同签名的应用程序版本。
static int	STATUS_INSTALL_FAILURE_DOWNLOAD_FAILED	表示下载失败导致安装失败。
static int	STATUS_INSTALL_FAILURE_DOWNLOAD_TIMEOUT	表示安装失败，因为下载没有及时完成。（30秒）
static int	STATUS_INSTALL_FAILURE_INCOMPATIBLE	表示由于不兼容导致安装失败，例如正在使用的Ohos SDK版本不是所需的最新版本或设备支持的应用程序二进制接口（ABI）的本机代码不可用。
static int	STATUS_INSTALL_FAILURE_INVALID	表示由于bundle格式不正确、bundle损坏或签名错误导致安装失败。
static int	STATUS_INSTALL_FAILURE_STORAGE	表示由于存储原因导致安装失败，例如存储空间不足或存储介质不可用。
static int	STATUS_UNINSTALL_FAILURE	表示卸载因系统或服务异常而失败。
static int	STATUS_UNINSTALL_FAILURE_ABORTED	表示卸载已中止。
static int	STATUS_UNINSTALL_FAILURE_BLOCKED	表示卸载失败，因为bundle不存在，设备不允许卸载，或者用户没有权限卸载应用。
static int	STATUS_UNINSTALL_FAILURE_CONFLICT	表示卸载失败，因为应用程序有共享库，无法卸载。
static int	SUCCESS	表示应用程序已成功安装或卸载。

方法总结

修饰符和类型	方法	描述
boolean	install(ListString bundleFilePaths, InstallParam installParam, InstallerCallback callback)	安装应用程序。
boolean	uninstall(String bundleName, InstallParam installParam, InstallerCallback callback)	卸载应用程序。

从接口 ohos.rpc.IRemoteBroker 继承的方法
asObject

字段详细信息

STATUS_INSTALL_FAILURE

static final int STATUS_INSTALL_FAILURE

表示由于系统或服务异常导致安装失败。

值为 1。

STATUS_INSTALL_FAILURE_ABORTED

static final int STATUS_INSTALL_FAILURE_ABORTED

指示安装因用户拒绝授予权限或安装会话中断而中止。

值为 2。

STATUS_INSTALL_FAILURE_CONFLICT

static final int STATUS_INSTALL_FAILURE_CONFLICT

表示由于应用程序冲突导致安装失败，例如安装了具有不同签名的应用程序版本。用户必须在安装新的应用程序版本之前将其卸载。

值为4

STATUS_INSTALL_FAILURE_DOWNLOAD_FAILED

static final int STATUS_INSTALL_FAILURE_DOWNLOAD_FAILED

表示下载失败导致安装失败。

值为 12。

STATUS_INSTALL_FAILURE_DOWNLOAD_TIMEOUT

static final int STATUS_INSTALL_FAILURE_DOWNLOAD_TIMEOUT

表示安装失败，因为下载没有及时完成。（30秒）

值为 11。

STATUS_INSTALL_FAILURE_INCOMPATIBLE

static final int STATUS_INSTALL_FAILURE_INCOMPATIBLE

表示由于不兼容导致安装失败，例如正在使用的Ohos SDK版本不是所需的最新版本或设备支持的应用程序二进制接口（ABI）的本机代码不可用。

值为 6。

STATUS_INSTALL_FAILURE_INVALID

static final int STATUS_INSTALL_FAILURE_INVALID

表示由于bundle格式不正确、bundle损坏或签名错误导致安装失败。

值为 3。

STATUS_INSTALL_FAILURE_STORAGE

static final int STATUS_INSTALL_FAILURE_STORAGE

表示由于存储原因导致安装失败，例如存储空间不足或存储介质不可用。

值为 5。

STATUS_UNINSTALL_FAILURE

static final int STATUS_UNINSTALL_FAILURE

表示卸载因系统或服务异常而失败。

值为 7。

STATUS_UNINSTALL_FAILURE_ABORTED

static final int STATUS_UNINSTALL_FAILURE_ABORTED

表示卸载已中止。

值为 9。

STATUS_UNINSTALL_FAILURE_BLOCKED

static final int STATUS_UNINSTALL_FAILURE_BLOCKED

表示卸载失败，因为bundle不存在，设备不允许卸载，或者用户没有权限卸载应用。

值为 8。

STATUS_UNINSTALL_FAILURE_CONFLICT

static final int STATUS_UNINSTALL_FAILURE_CONFLICT

表示卸载失败，因为应用程序有共享库，无法卸载。

值为 10。

SUCCESS

static final int SUCCESS

表示应用程序已成功安装或卸载。

值为 0。

方法详情

install

boolean install(ListString bundleFilePaths, InstallParam installParam, InstallerCallback callback) throws RemoteException

安装应用程序。

使用该方法需要向系统申请ohos.permission.INSTALL_BUNDLE权限，该权限是签名级别的。安装是一个异步过程，该方法不返回安装结果。结果会在callback指定的回调方法中携带。

参数:

参数名称	参数描述
bundleFilePaths	指示存储应用程序包的路径。路径应该是当前应用程序数据目录的相对路径。
installParam	表示安装所需的其他参数
callback	安装应用的回调方法，用于监听安装结果。

如果应用程序安装过程成功启动，则返回 true；否则返回 false。

Throws:

Throw名称	Throw描述
RemoteException	如果发生进程间调用异常，则抛出此异常。

uninstall

boolean uninstall(String bundleName, InstallParam installParam, InstallerCallback callback) throws RemoteException

卸载应用程序。

使用该方法需要向系统申请ohos.permission.INSTALL_BUNDLE权限，该权限是签名级别的。

您可以使用标志来确定在卸载应用程序时是否保留用户数据。

参数:

参数名称	参数描述
bundleName	指示要卸载的应用程序的捆绑包名称。
installParam	表示卸载所需的其他参数。
callback	卸载应用回调，监听卸载结果。

如果应用程序卸载过程成功启动，则返回 true；否则返回 false。