HarmonyOS实战开发：@ohos.bundle.installer (installer模块)

最新推荐文章于 2024-07-26 15:35:11 发布
最新推荐文章于 2024-07-26 15:35:11 发布
阅读量936 收藏 25
点赞数 15
分类专栏： 鸿蒙 文章标签： harmonyos 华为 鸿蒙 鸿蒙系统 android
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2401_84194030/article/details/139203663
版权

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

在设备上安装、升级和卸载应用。

导入模块

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

权限列表

权限权限等级描述
ohos.permission.INSTALL_BUNDLEsystem_core允许应用安装、卸载其他应用（除了企业相关应用，目前有企业InHouse应用，企业MDM应用和企业normal应用）。
ohos.permission.INSTALL_ENTERPRISE_BUNDLEsystem_core允许应用安装企业InHouse应用。
ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLEsystem_core允许在企业设备上安装企业MDM应用包。
ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLEsystem_core允许在企业设备上安装企业NORMAL应用包。
ohos.permission.UNINSTALL_BUNDLEsystem_core允许应用卸载应用。
ohos.permission.RECOVER_BUNDLEsystem_core允许应用恢复预置应用。
ohos.permission.INSTALL_SELF_BUNDLEsystem_core允许企业MDM应用在企业设备上自升级。

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

BundleInstaller.getBundleInstaller

getBundleInstaller(callback: AsyncCallback<BundleInstaller>): void

获取BundleInstaller对象，使用callback形式返回结果。

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

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

参数：

参数名类型必填说明
callbackAsyncCallback<BundleInstaller>是回调函数，获取BundleInstaller对象，err为null，data为获取到的BundleInstaller对象；否则为错误对象。

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

try {
    installer.getBundleInstaller((err: BusinessError, data: installer.BundleInstaller) => {
        if (err) {
            console.error('getBundleInstaller failed:' + err.message);
        } else {
            console.info('getBundleInstaller successfully');
        }
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed:' + message);
}

BundleInstaller.getBundleInstaller

getBundleInstaller(): Promise<BundleInstaller>

获取BundleInstaller对象，使用callback形式返回结果。

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

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

返回值： | 类型 | 说明 | | ------------------------------------------------------------ | ------------------------------------ | | Promise<BundleInstaller> | Promise对象，返回BundleInstaller对象。 |

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        console.info('getBundleInstaller successfully.');
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.getBundleInstallerSync10+

getBundleInstallerSync(): BundleInstaller

获取并返回BundleInstaller对象。

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

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

返回值： | 类型 | 说明 | | ------------------------------------------------------------ | ------------------------------------ | | BundleInstaller | 返回BundleInstaller对象。 |

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

try {
    installer.getBundleInstallerSync();
    console.info('getBundleInstallerSync successfully.');
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstallerSync failed. Cause: ' + message);
}

BundleInstaller.install

install(hapFilePaths: Array<string>, installParam: InstallParam, callback: AsyncCallback<void>): void

以异步方法安装应用，使用callback形式返回结果。

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

需要权限： ohos.permission.INSTALL_BUNDLE 或 ohos.permission.INSTALL_ENTERPRISE_BUNDLE10+ 或 ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE10+ 或 ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE10+

说明： 从API version 10起，可通过ohos.permission.INSTALL_ENTERPRISE_BUNDLE 或 ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 或 ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE权限调用此接口。

安装企业应用需要ohos.permission.INSTALL_ENTERPRISE_BUNDLE权限。

安装企业NORMAL应用需要ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE或ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE权限。

安装企业MDM应用需要ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE权限。

安装普通应用需要ohos.permission.INSTALL_BUNDLE权限。

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

参数：

参数名类型必填说明
hapFilePathsArray<string>是存储应用程序包的路径。路径应该是当前应用程序中存放HAP的数据目录。当传入的路径是一个目录时， 该目录下只能放同一个应用的HAP，且这些HAP的签名需要保持一致。
installParamInstallParam是指定安装所需的其他参数。
callbackAsyncCallback<void>是回调函数，安装应用成功，err为null，否则为错误对象。

错误码：

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

错误码ID错误信息
17700004The specified user ID is not found.
17700010Failed to install the HAP because the HAP fails to be parsed.
17700011Failed to install the HAP because the HAP signature fails to be verified.
17700012Failed to install the HAP because the HAP path is invalid or the HAP is too large.
17700015Failed to install the HAPs because they have different configuration information.
17700016Failed to install the HAP because of insufficient system disk space.
17700017Failed to install the HAP since the version of the HAP to install is too early.
17700018Failed to install because the dependent module does not exist.
17700031Failed to install the HAP because the overlay check of the HAP is failed.
17700036Failed to install the HSP because lacks appropriate permissions.
17700039Failed to install because disallow install a shared bundle by hapFilePaths.
17700041Failed to install because enterprise device management disallow install.
17700042Failed to install the HAP because of incorrect URI in the data proxy.
17700043Failed to install the HAP because of low APL in the non-system data proxy (required APL: system_basic or system_core).
17700044Failed to install the HAP because the isolationMode configured is not supported.
17700047Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode.
17700048Failed to install the HAP because the code signature verification is failed.
17700050Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device.

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let hapFilePaths = ['/data/storage/el2/base/haps/entry/files/'];
let installParam: installer.InstallParam = {
    userId: 100,
    isKeepData: false,
    installFlag: 1,
};

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.install(hapFilePaths, installParam, (err: BusinessError) => {
            if (err) {
                console.error('install failed:' + err.message);
            } else {
                console.info('install successfully.');
            }
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.install

install(hapFilePaths: Array<string>, callback: AsyncCallback<void>): void

以异步方法安装应用，使用callback形式返回结果。

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

需要权限： ohos.permission.INSTALL_BUNDLE 或 ohos.permission.INSTALL_ENTERPRISE_BUNDLE10+ 或 ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE10+ 或 ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE10+

说明： 从API version 10起，可通过ohos.permission.INSTALL_ENTERPRISE_BUNDLE 或 ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 或 ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE权限调用此接口。

安装企业应用需要ohos.permission.INSTALL_ENTERPRISE_BUNDLE权限。

安装企业NORMAL应用需要ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE或ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE权限。

安装企业MDM应用需要ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE权限。

安装普通应用需要ohos.permission.INSTALL_BUNDLE权限。

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

参数：

参数名类型必填说明
hapFilePathsArray<string>是存储应用程序包的路径。路径应该是当前应用程序中存放HAP的数据目录。当传入的路径是一个目录时， 该目录下只能放同一个应用的HAP，且这些HAP的签名需要保持一致。
callbackAsyncCallback<void>是回调函数，安装应用成功，err为null，否则为错误对象。

错误码：

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

错误码ID错误信息
17700010Failed to install the HAP because the HAP fails to be parsed.
17700011Failed to install the HAP because the HAP signature fails to be verified.
17700012Failed to install the HAP because the HAP path is invalid or the HAP is too large.
17700015Failed to install the HAPs because they have different configuration information.
17700016Failed to install the HAP because of insufficient system disk space.
17700017Failed to install the HAP since the version of the HAP to install is too early.
17700018Failed to install because the dependent module does not exist.
17700031Failed to install the HAP because the overlay check of the HAP is failed.
17700036Failed to install the HSP because lacks appropriate permissions.
17700039Failed to install because disallow install a shared bundle by hapFilePaths.
17700041Failed to install because enterprise device management disallow install.
17700042Failed to install the HAP because of incorrect URI in the data proxy.
17700043Failed to install the HAP because of low APL in the non-system data proxy (required APL: system_basic or system_core).
17700044Failed to install the HAP because the isolationMode configured is not supported.
17700047Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode.
17700048Failed to install the HAP because the code signature verification is failed.
17700050Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device.

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let hapFilePaths = ['/data/storage/el2/base/haps/entry/files/'];

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.install(hapFilePaths, (err: BusinessError) => {
            if (err) {
                console.error('install failed:' + err.message);
            } else {
                console.info('install successfully.');
            }
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.install

install(hapFilePaths: Array<string>, installParam?: InstallParam) : Promise<void>

以异步方法安装应用，使用Promise形式返回结果。

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

需要权限： ohos.permission.INSTALL_BUNDLE 或 ohos.permission.INSTALL_ENTERPRISE_BUNDLE10+ 或 ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE10+ 或 ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE10+

说明： 从API version 10起，可通过ohos.permission.INSTALL_ENTERPRISE_BUNDLE 或 ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 或 ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE权限调用此接口。

安装企业应用需要ohos.permission.INSTALL_ENTERPRISE_BUNDLE权限。

安装企业NORMAL应用需要ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE或ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE权限。

安装企业MDM应用需要ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE权限。

安装普通应用需要ohos.permission.INSTALL_BUNDLE权限。

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

参数：

参数名类型必填说明
hapFilePathsArray<string>是存储应用程序包的路径。路径应该是当前应用程序中存放HAP的数据目录。当传入的路径是一个目录时， 该目录下只能放同一个应用的HAP，且这些HAP的签名需要保持一致。
installParamInstallParam否指定安装所需的其他参数，默认值：参照InstallParam的默认值。

返回值：

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

错误码：

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

错误码ID错误信息
17700004The specified user ID is not found.
17700010Failed to install the HAP because the HAP fails to be parsed.
17700011Failed to install the HAP because the HAP signature fails to be verified.
17700012Failed to install the HAP because the HAP path is invalid or the HAP is too large.
17700015Failed to install the HAPs because they have different configuration information.
17700016Failed to install the HAP because of insufficient system disk space.
17700017Failed to install the HAP since the version of the HAP to install is too early.
17700018Failed to install because the dependent module does not exist.
17700031Failed to install the HAP because the overlay check of the HAP is failed.
17700036Failed to install the HSP because lacks appropriate permissions.
17700039Failed to install because disallow install a shared bundle by hapFilePaths.
17700041Failed to install because enterprise device management disallow install.
17700042Failed to install the HAP because of incorrect URI in the data proxy.
17700043Failed to install the HAP because of low APL in the non-system data proxy (required APL: system_basic or system_core).
17700044Failed to install the HAP because the isolationMode configured is not supported.
17700047Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode.
17700048Failed to install the HAP because the code signature verification is failed.
17700050Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device.

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let hapFilePaths = ['/data/storage/el2/base/haps/entry/files/'];
let installParam: installer.InstallParam = {
    userId: 100,
    isKeepData: false,
    installFlag: 1,
};

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.install(hapFilePaths, installParam)
            .then((data: void) => {
                console.info('install successfully: ' + JSON.stringify(data));
        }).catch((error: BusinessError) => {
            console.error('install failed:' + error.message);
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.uninstall

uninstall(bundleName: string, installParam: InstallParam, callback: AsyncCallback<void>): void

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

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

需要权限： ohos.permission.INSTALL_BUNDLE 或 ohos.permission.UNINSTALL_BUNDLE

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

参数：

参数名类型必填说明
bundleNamestring是待卸载应用的包名。
installParamInstallParam是指定安装所需的其他参数。
callbackAsyncCallback<void>是回调函数，卸载应用成功，err为null，否则为错误对象。

错误码：

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

错误码ID错误信息
17700001The specified bundle name is not found.
17700004The specified user ID is not found.
17700020The specified bundle is pre-installed bundle which cannot be uninstalled.
17700040The specified bundle is a shared bundle which cannot be uninstalled.
17700045Failed to uninstall because enterprise device management disallow uninstall.

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let bundleName = 'com.ohos.demo';
let installParam: installer.InstallParam = {
    userId: 100,
    isKeepData: false,
    installFlag: 1
};

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.uninstall(bundleName, installParam, (err: BusinessError) => {
            if (err) {
                console.error('uninstall failed:' + err.message);
            } else {
                console.info('uninstall successfully.');
            }
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.uninstall

uninstall(bundleName: string, callback: AsyncCallback<void>): void

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

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

需要权限： ohos.permission.INSTALL_BUNDLE 或 ohos.permission.UNINSTALL_BUNDLE

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

参数：

参数名类型必填说明
bundleNamestring是待卸载应用的包名。
callbackAsyncCallback<void>是回调函数，卸载应用成功，err为null，否则为错误对象。

错误码：

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

错误码ID错误信息
17700001The specified bundle name is not found.
17700020The specified bundle is pre-installed bundle which cannot be uninstalled.
17700040The specified bundle is a shared bundle which cannot be uninstalled.
17700045Failed to uninstall because enterprise device management disallow uninstall.

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let bundleName = 'com.ohos.demo';

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.uninstall(bundleName, (err: BusinessError) => {
            if (err) {
                console.error('uninstall failed:' + err.message);
            } else {
                console.info('uninstall successfully.');
            }
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.uninstall

uninstall(bundleName: string, installParam?: InstallParam) : Promise<void>

以异步方法卸载应用，使用Promise形式返回结果。

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

需要权限： ohos.permission.INSTALL_BUNDLE 或 ohos.permission.UNINSTALL_BUNDLE

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

参数：

参数名类型必填说明
bundleNamestring是待卸载应用的包名。
installParamInstallParam否指定安装所需的其他参数，默认值：参照InstallParam的默认值。

返回值：

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

错误码：

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

错误码ID错误信息
17700001The specified bundle name is not found.
17700004The specified user ID is not found.
17700020The specified bundle is pre-installed bundle which cannot be uninstalled.
17700040The specified bundle is a shared bundle which cannot be uninstalled.
17700045Failed to uninstall because enterprise device management disallow uninstall.

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let bundleName = 'com.ohos.demo';
let installParam: installer.InstallParam = {
    userId: 100,
    isKeepData: false,
    installFlag: 1,
};

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.uninstall(bundleName, installParam)
            .then((data: void) => {
                console.info('uninstall successfully: ' + JSON.stringify(data));
        }).catch((error: BusinessError) => {
            console.error('uninstall failed:' + error.message);
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.recover

recover(bundleName: string, installParam: InstallParam, callback: AsyncCallback<void>): void

以异步方法回滚应用到初次安装时的状态，使用callback形式返回结果。

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

需要权限： ohos.permission.INSTALL_BUNDLE 或 ohos.permission.RECOVER_BUNDLE

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

参数：

参数名类型必填说明
bundleNamestring是待恢复应用的包名。
installParamInstallParam是指定安装所需的其他参数。
callbackAsyncCallback<void>是回调函数，回滚应用成功，err为null，否则为错误对象。

错误码：

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

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

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let bundleName = 'com.ohos.demo';
let installParam: installer.InstallParam = {
    userId: 100,
    isKeepData: false,
    installFlag: 1
};

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.recover(bundleName, installParam, (err: BusinessError) => {
            if (err) {
                console.error('recover failed:' + err.message);
            } else {
                console.info('recover successfully.');
            }
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.recover

recover(bundleName: string, callback: AsyncCallback<void>): void

以异步方法回滚应用到初次安装时的状态，使用callback形式返回结果。

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

需要权限： ohos.permission.INSTALL_BUNDLE 或 ohos.permission.RECOVER_BUNDLE

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

参数：

参数名类型必填说明
bundleNamestring是待恢复应用的包名。
callbackAsyncCallback<void>是回调函数，回滚应用成功，err为null，否则为错误对象。

错误码：

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

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

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let bundleName = 'com.ohos.demo';

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.recover(bundleName, (err: BusinessError) => {
            if (err) {
                console.error('recover failed:' + err.message);
            } else {
                console.info('recover successfully.');
            }
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.recover

recover(bundleName: string, installParam?: InstallParam) : Promise<void>

以异步方法回滚应用到初次安装时的状态，使用Promise形式返回结果。

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

需要权限： ohos.permission.INSTALL_BUNDLE 或 ohos.permission.RECOVER_BUNDLE

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

参数：

参数名类型必填说明
bundleNamestring是待卸载应用的包名。
installParamInstallParam否指定安装所需的其他参数，默认值：参照InstallParam的默认值。

返回值：

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

错误码：

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

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

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let bundleName = 'com.ohos.demo';
let installParam: installer.InstallParam = {
    userId: 100,
    isKeepData: false,
    installFlag: 1,
};

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.recover(bundleName, installParam)
            .then((data: void) => {
                console.info('recover successfully: ' + JSON.stringify(data));
        }).catch((error: BusinessError) => {
            console.error('recover failed:' + error.message);
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.uninstall10+

uninstall(uninstallParam: UninstallParam, callback : AsyncCallback<void>) : void

以异步方法卸载一个共享包，使用callback形式返回结果。

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

需要权限： ohos.permission.INSTALL_BUNDLE 或 ohos.permission.UNINSTALL_BUNDLE

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

参数：

参数名类型必填说明
uninstallParamUninstallParam是共享包卸载需指定的参数信息。
callbackAsyncCallback<void>是回调函数，卸载应用成功，err为null，否则为错误对象。

错误码：

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

错误码ID错误信息
17700020The specified bundle is pre-installed bundle which cannot be uninstalled.
17700037The version of shared bundle is dependent on other applications.
17700038The specified shared bundle does not exist.

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let uninstallParam: installer.UninstallParam = {
    bundleName: "com.ohos.demo",
};

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.uninstall(uninstallParam, (err: BusinessError) => {
            if (err) {
                console.error('uninstall failed:' + err.message);
            } else {
                console.info('uninstall successfully.');
            }
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.uninstall10+

uninstall(uninstallParam: UninstallParam) : Promise<void>

以异步方法卸载一个共享包，使用Promise形式返回结果。

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

需要权限： ohos.permission.INSTALL_BUNDLE 或 ohos.permission.UNINSTALL_BUNDLE

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

参数：

参数名类型必填说明
uninstallParamUninstallParam是共享包卸载需指定的参数信息。

返回值：

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

错误码：

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

错误码ID错误信息
17700020The specified bundle is pre-installed bundle which cannot be uninstalled.
17700037The version of shared bundle is dependent on other applications.
17700038The specified shared bundle does not exist.

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let uninstallParam: installer.UninstallParam = {
    bundleName: "com.ohos.demo",
};

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.uninstall(uninstallParam, (err: BusinessError) => {
            if (err) {
                console.error('uninstall failed:' + err.message);
            } else {
                console.info('uninstall successfully.');
            }
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.updateBundleForSelf10+

updateBundleForSelf(hapFilePaths: Array<string>, installParam: InstallParam, callback: AsyncCallback<void>): void

以异步方法更新当前应用，仅限企业设备上的企业MDM应用调用，且传入的hapFilePaths中的hap必须都属于当前应用，使用callback形式返回结果。

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

需要权限： ohos.permission.INSTALL_SELF_BUNDLE

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

参数：

参数名类型必填说明
hapFilePathsArray<string>是存储应用程序包的路径。路径应该是当前应用程序中存放HAP的数据目录。当传入的路径是一个目录时， 该目录下只能放同一个应用的HAP，且这些HAP的签名需要保持一致。
installParamInstallParam是指定安装所需的其他参数。
callbackAsyncCallback<void>是回调函数，安装应用成功，err为null，否则为错误对象。

错误码：

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

错误码ID错误信息
17700004The specified user ID is not found.
17700010Failed to install the HAP because the HAP fails to be parsed.
17700011Failed to install the HAP because the HAP signature fails to be verified.
17700012Failed to install the HAP because the HAP path is invalid or the HAP is too large.
17700015Failed to install the HAPs because they have different configuration information.
17700016Failed to install the HAP because of insufficient system disk space.
17700017Failed to install the HAP since the version of the HAP to install is too early.
17700018Failed to install because the dependent module does not exist.
17700039Failed to install because disallow install a shared bundle by hapFilePaths.
17700041Failed to install because enterprise device management disallow install.
17700042Failed to install the HAP because of incorrect URI in the data proxy.
17700043Failed to install the HAP because of low APL in the non-system data proxy (required APL: system_basic or system_core).
17700044Failed to install the HAP because the isolationMode configured is not supported.
17700047Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode.
17700048Failed to install the HAP because the code signature verification is failed.
17700049Failed to install the HAP because the bundleName is different from the bundleName of the caller application.
17700050Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device.
17700051Failed to install the HAP because the distribution type of caller application is not enterprise_mdm.

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let hapFilePaths = ['/data/storage/el2/base/haps/entry/files/'];
let installParam: installer.InstallParam = {
    userId: 100,
    isKeepData: false,
    installFlag: 1,
};

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.updateBundleForSelf(hapFilePaths, installParam, (err: BusinessError) => {
            if (err) {
                console.error('updateBundleForSelf failed:' + err.message);
            } else {
                console.info('updateBundleForSelf successfully.');
            }
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.updateBundleForSelf10+

updateBundleForSelf(hapFilePaths: Array<string>, callback: AsyncCallback<void>): void

以异步方法更新当前应用，仅限企业设备上的企业MDM应用调用，且传入的hapFilePaths中的hap必须都属于当前应用，使用callback形式返回结果。

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

需要权限： ohos.permission.INSTALL_SELF_BUNDLE

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

参数：

参数名类型必填说明
hapFilePathsArray<string>是存储应用程序包的路径。路径应该是当前应用程序中存放HAP的数据目录。当传入的路径是一个目录时， 该目录下只能放同一个应用的HAP，且这些HAP的签名需要保持一致。
callbackAsyncCallback<void>是回调函数，安装应用成功，err为null，否则为错误对象。

错误码：

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

错误码ID错误信息
17700010Failed to install the HAP because the HAP fails to be parsed.
17700011Failed to install the HAP because the HAP signature fails to be verified.
17700012Failed to install the HAP because the HAP path is invalid or the HAP is too large.
17700015Failed to install the HAPs because they have different configuration information.
17700016Failed to install the HAP because of insufficient system disk space.
17700017Failed to install the HAP since the version of the HAP to install is too early.
17700018Failed to install because the dependent module does not exist.
17700039Failed to install because disallow install a shared bundle by hapFilePaths.
17700041Failed to install because enterprise device management disallow install.
17700042Failed to install the HAP because of incorrect URI in the data proxy.
17700043Failed to install the HAP because of low APL in the non-system data proxy (required APL: system_basic or system_core).
17700044Failed to install the HAP because the isolationMode configured is not supported.
17700047Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode.
17700048Failed to install the HAP because the code signature verification is failed.
17700049Failed to install the HAP because the bundleName is different from the bundleName of the caller application.
17700050Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device.
17700051Failed to install the HAP because the distribution type of caller application is not enterprise_mdm.

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let hapFilePaths = ['/data/storage/el2/base/haps/entry/files/'];

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.updateBundleForSelf(hapFilePaths, (err: BusinessError) => {
            if (err) {
                console.error('updateBundleForSelf failed:' + err.message);
            } else {
                console.info('updateBundleForSelf successfully.');
            }
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

BundleInstaller.updateBundleForSelf10+

updateBundleForSelf(hapFilePaths: Array<string>, installParam?: InstallParam): Promise<void>

以异步方法更新当前应用，仅限企业设备上的企业MDM应用调用，且传入的hapFilePaths中的hap必须都属于当前应用，使用promise形式返回结果。

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

需要权限： ohos.permission.INSTALL_SELF_BUNDLE

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

参数：

参数名类型必填说明
hapFilePathsArray<string>是存储应用程序包的路径。路径应该是当前应用程序中存放HAP的数据目录。当传入的路径是一个目录时， 该目录下只能放同一个应用的HAP，且这些HAP的签名需要保持一致。
installParamInstallParam否指定安装所需的其他参数，默认值：参照InstallParam的默认值。

返回值：

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

错误码：

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

错误码ID错误信息
17700004The specified user ID is not found.
17700010Failed to install the HAP because the HAP fails to be parsed.
17700011Failed to install the HAP because the HAP signature fails to be verified.
17700012Failed to install the HAP because the HAP path is invalid or the HAP is too large.
17700015Failed to install the HAPs because they have different configuration information.
17700016Failed to install the HAP because of insufficient system disk space.
17700017Failed to install the HAP since the version of the HAP to install is too early.
17700018Failed to install because the dependent module does not exist.
17700039Failed to install because disallow install a shared bundle by hapFilePaths.
17700041Failed to install because enterprise device management disallow install.
17700042Failed to install the HAP because of incorrect URI in the data proxy.
17700043Failed to install the HAP because of low APL in the non-system data proxy (required APL: system_basic or system_core).
17700044Failed to install the HAP because the isolationMode configured is not supported.
17700047Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode.
17700048Failed to install the HAP because the code signature verification is failed.
17700049Failed to install the HAP because the bundleName is different from the bundleName of the caller application.
17700050Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device.
17700051Failed to install the HAP because the distribution type of caller application is not enterprise_mdm.

示例：

import installer from '@ohos.bundle.installer';
import { BusinessError } from '@ohos.base';

let hapFilePaths = ['/data/storage/el2/base/haps/entry/files/'];
let installParam: installer.InstallParam = {
    userId: 100,
    isKeepData: false,
    installFlag: 1,
};

try {
    installer.getBundleInstaller().then((data: installer.BundleInstaller) => {
        data.updateBundleForSelf(hapFilePaths, installParam)
            .then((data: void) => {
                console.info('updateBundleForSelf successfully: ' + JSON.stringify(data));
        }).catch((error: BusinessError) => {
            console.error('updateBundleForSelf failed:' + error.message);
        });
    }).catch((error: BusinessError) => {
        console.error('getBundleInstaller failed. Cause: ' + error.message);
    });
} catch (error) {
    let message = (error as BusinessError).message;
    console.error('getBundleInstaller failed. Cause: ' + message);
}

HashParam

应用程序安装卸载哈希参数信息。

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

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

名称类型必填说明
moduleNamestring是应用程序模块名称。
hashValuestring是哈希值。

InstallParam

应用程序安装、卸载或恢复需指定的参数信息。

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

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

名称类型必填说明
userIdnumber否指示用户id，默认值：调用方所在用户，取值范围：大于等于0，可使用queryOsAccountLocalIdFromProcess获取当前进程所在用户。
installFlagnumber否指示安装标志，枚举值：0x00：应用初次安装，0x01：应用覆盖安装，0x10：应用免安装，默认值为应用初次安装。
isKeepDataboolean否卸载时是否保留数据目录，默认值为false。
hashParamsArray<HashParam>否哈希值参数，默认值为空。
crowdtestDeadlinenumber否众测活动的截止日期，默认值为-1，表示无截止日期约束。
sharedBundleDirPaths10+Array<String>否共享包文件所在路径，默认值为空。
specifiedDistributionType10+string否应用安装时指定的分发类型，默认值为空，最大长度为128字节。该字段通常由操作系统运营方的应用市场指定。
additionalInfo10+string否应用安装时的额外信息，默认值为空，最大长度为3000字节。该字段通常由操作系统运营方的应用市场在安装企业应用时指定，用于保存应用的额外信息。
verifyCodeParams10+Array<VerifyCodeParam>否代码签名文件参数，默认值为空。

UninstallParam10+

共享包卸载需指定的参数信息。

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

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

名称类型必填说明
bundleNamestring是共享包包名。
versionCodenumber否指示共享包的版本号。默认值：如果不填写versionCode，则卸载该包名的所有共享包。

VerifyCodeParam10+

应用程序代码签名文件信息。

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

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

名称类型必填说明
moduleNamestring是应用程序模块名称。
signatureFilePathstring是代码签名文件路径。

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

  •  HarmonOS基础技能

  • HarmonOS就业必备技能 
  •  HarmonOS多媒体技术

  • 鸿蒙NaPi组件进阶

  • HarmonOS高级技能

  • 初识HarmonOS内核 
  • 实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

图片

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

图片

 《鸿蒙开发基础》

  • ArkTS语言
  • 安装DevEco Studio
  • 运用你的第一个ArkTS应用
  • ArkUI声明式UI开发
  • .……

图片

 《鸿蒙开发进阶》

  • Stage模型入门
  • 网络管理
  • 数据管理
  • 电话服务
  • 分布式应用开发
  • 通知与窗口管理
  • 多媒体技术
  • 安全技能
  • 任务管理
  • WebGL
  • 国际化开发
  • 应用测试
  • DFX面向未来设计
  • 鸿蒙系统移植和裁剪定制
  • ……

图片

《鸿蒙进阶实战》

  • ArkTS实践
  • UIAbility应用
  • 网络案例
  • ……

图片

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。

蜀道衫QAQ
关注
  • 15
    点赞
  • 踩
  • 25
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
鸿蒙开发已解决-Failure[ERROR_GET_BUNDLE_INSTALLER_FAILED]
一键难忘的博客
01-09 851
本文描述了在运行/调试过程中出现“Failure[ERROR_GET_BUNDLE_INSTALLER_FAILED]”错误的问题，并提供了相关的报错信息和截图。问题的根本原因是系统的BMS服务异常导致。作者通过官方提供的解决方案发现，等待一段时间后重试或者在DevEco Studio中收集错误日志信息并求助于HarmonyOS社区。然而，作者在实际解决问题的过程中发现，问题可以通过简单地重新启动集成开发环境（IDE）来解决，而无需等待较长的时间或采取其他复杂的步骤。
无法导入ohos.bundle.installer错误解决方法
xiangzhihong8的专栏
02-29 161
造成错误的原因是，我们使用的是public-sdk，所以我们需要到OpenHarmony平台下载full-sdk，下载链接：https://ci.openharmony.cn/workbench/cicd/dailybuild/dailylist?今天在运行一个开源项目时，发现编译项目时报了一个错误：ohos.bundle.installer。如果没有找到，可以看看滚动构建是不是有，然后替换成full-sdk即可。
installer-module:安装程序模块 - 简单的 PHP MVC
06-24
安装模块 安装程序模块 - 简单的 PHP MVC 使用 symfony 命令的安装程序模块 命令 AssetsInstall - 应用程序/控制台应用程序：资产：安装 GenerateModel（Doctrine DBAL、Doctrine ORM 和 PDO） - 应用程序/控制台 app:generate:model
bundle install 命令
热门推荐
怀素的专栏
08-23 4万+
Bundle介绍： Rails 3中引入Bundle来管理项目中所有gem依赖，该命令只能在一个含有Gemfile的目录下执行，如rails 3项目的根目录。 关于Gemfile和Gemfile.lock 所有Ruby项目的信赖包都在Gemfile中进行配置，不再像以往那样，通过require来查找。Rails 3中如果需要require某个gem包，必须通过修改Ge
OpenHarmony5.0如何将Bundle文件拷贝到沙盒
最新发布
weixin_40307746的博客
07-26 362
HarmonyOS NEXT应用开发之异常处理案例_import { logger } from ‘@ohos base‘；
2301_79054873的博客
04-15 1014
|—PreferencesManager.ets // 数据模型层-持久化存储。| |—PreferencesManager.ets // 视图层-应用异常页面。
Cannot find module '@ohos.bundle.installer
05-24
这个错误信息通常表示在你的代码中引用了一个名为 '@ohos.bundle.installer' 的模块，但是系统无法找到这个模块。 这个问题可能有多种原因，比如： 1. 该模块没有被正确安装或配置。你可以尝试使用命令行工具重新...
com.android.packageinstaller,Android包管理机制（二）PackageInstaller安装APK
weixin_42121412的博客
05-28 2389
前言在本系列上一篇文章Android包管理机制(一)PackageInstaller的初始化中我们学习了PackageInstaller是如何初始化的，这一篇文章我们接着学习PackageInstaller是如何安装APK的。本系列文章的源码基于Android8.0。1.PackageInstaller中的处理紧接着上一篇的内容，在PackageInstallerActivity调用startIn...
mysql-installer-community-5.6.19.0.msi
09-18
MySQL-5.6.19-1.el6.i686.rpm-bundle.tar MySQL-5.6.19-1.el6.x86_64.rpm-bundle.tar mysql-5.6.19-win32.zip mysql-5.6.19-winx64.zip mysql-installer-community-5.6.19.0.msi mysql-installer-web-community-5.6....
symfony-bundle-installer-plugin:安装或删除 Symfony2 包时自动更新 AppKernel.php
05-31
总之，Symfony Bundle Installer Plugin是一个提高开发效率的实用工具，它简化了Symfony2项目的bundle管理，帮助开发者更专注于业务逻辑的实现，而不是繁琐的配置工作。通过正确地使用这个插件，您可以享受到更加...
HarmonyOS实战开发：@ohos.promptAction （弹窗）
2401_84194030的博客
05-28 1025
创建并显示文本提示框、对话框和操作菜单。
HarmonyOS实战开发：@ohos.file.fs (文件管理)
2401_84194030的博客
06-01 1497
该模块为基础文件操作API，提供基础文件操作能力，包括文件基本管理、文件目录管理、文件信息统计、文件流式读写等常用功能。
鸿蒙原生应用元服务-访问控制（权限）开发应用权限列表二
weixin_69135651的博客
04-24 1044
允许应用使用系统身份凭据管理能力进行口令、人脸、指纹等录入、修改、删除等操作。允许应用使用口令输入接口，用于系统应用完成口令输入框绘制场景。允许应用查询其他应用的快捷方式信息、启动其他应用的快捷方式。允许应用使用系统身份认证能力进行用户身份认证或身份识别。允许应用监听输入事件，仅系统签名应用可申请此权限。允许应用获取对端WLAN或者蓝牙设备的MAC地址。允许应用获取本机WLAN或者蓝牙设备的MAC地址。允许系统应用查询其他应用在前台或后台的运行时间。本文根据HarmonyOS官方文档API9整理。
bundle install
田攀的日志
04-05 9541
bundle install的作用：Make sure all dependencies in your Gemfile are available to your application.尤其是你切换环境（切换不同的系统），这个时候在新的环境中可能各个Gem组件的版本不匹配，就需要运行bundle Install来保证当前环境的GEM FILES版本匹配。$ bundle install [--
HarmonyOS实战开发：@ohos.app.form.formHost (formHost)
2401_84194030的博客
05-16 643
formHost模块提供了卡片使用方相关接口的能力........
如何使用命令行对RK开发板进行OpenHarmony版本烧录？
m0_64420071的博客
03-29 1528
开发版烧录
HarmonyOS实战开发：@ohos.app.ability.Want (Want)
2401_84194030的博客
05-16 707
Want是对象间信息传递的载体.........
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值