1/* 2 * Copyright (c) 2022 Huawei Device Co., Ltd. 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 * See the License for the specific language governing permissions and 13 * limitations under the License. 14 */ 15 16/** 17 * @file 18 * @kit AbilityKit 19 */ 20 21import { AsyncCallback } from './@ohos.base'; 22 23/** 24 * Support install, upgrade, remove and recover bundles on the devices. 25 * 26 * @namespace installer 27 * @syscap SystemCapability.BundleManager.BundleFramework.Core 28 * @systemapi 29 * @since arkts {'1.1':'9', '1.2':'20'} 30 * @arkts 1.1&1.2 31 */ 32declare namespace installer { 33 /** 34 * Obtains the interface used to install bundle. 35 * 36 * @param { AsyncCallback<BundleInstaller> } callback - The callback of BundleInstaller object. 37 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 38 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Incorrect parameter types. 39 * @syscap SystemCapability.BundleManager.BundleFramework.Core 40 * @systemapi 41 * @since arkts {'1.1':'9', '1.2':'20'} 42 * @arkts 1.1&1.2 43 */ 44 function getBundleInstaller(callback: AsyncCallback<BundleInstaller>): void; 45 46 /** 47 * Obtains the interface used to install bundle. 48 * 49 * @returns { Promise<BundleInstaller> } BundleInstaller object. 50 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 51 * @syscap SystemCapability.BundleManager.BundleFramework.Core 52 * @systemapi 53 * @since arkts {'1.1':'9', '1.2':'20'} 54 * @arkts 1.1&1.2 55 */ 56 function getBundleInstaller(): Promise<BundleInstaller>; 57 58 /** 59 * Obtains the interface used to install bundle. 60 * 61 * @returns { BundleInstaller } BundleInstaller object. 62 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 63 * @syscap SystemCapability.BundleManager.BundleFramework.Core 64 * @systemapi 65 * @since arkts {'1.1':'10', '1.2':'20'} 66 * @arkts 1.1&1.2 67 */ 68 function getBundleInstallerSync(): BundleInstaller; 69 70 /** 71 * Bundle installer interface, include install uninstall recover. 72 * 73 * @interface BundleInstaller 74 * @syscap SystemCapability.BundleManager.BundleFramework.Core 75 * @systemapi 76 * @since arkts {'1.1':'9', '1.2':'20'} 77 * @arkts 1.1&1.2 78 */ 79 interface BundleInstaller { 80 /** 81 * Install haps for an application. 82 * 83 * @permission ohos.permission.INSTALL_BUNDLE 84 * @param { Array<string> } hapFilePaths - Indicates the path where the hap of the application is stored. 85 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 86 * @param { AsyncCallback<void> } callback - The callback of installing haps result. 87 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE'. 88 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 89 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 90 * @throws { BusinessError } 17700004 - The specified user ID is not found. 91 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 92 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 93 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 94 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 95 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 96 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 97 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 98 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 99 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 100 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 101 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 102 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 103 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 104 * (required APL: system_basic or system_core). 105 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 106 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 107 * @syscap SystemCapability.BundleManager.BundleFramework.Core 108 * @systemapi 109 * @since 9 110 */ 111 /** 112 * Install HAPs for an application. 113 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 114 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 115 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 116 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 117 * 118 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 119 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 120 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 121 * @param { AsyncCallback<void> } callback - The callback of installing HAPs result. 122 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 123 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 124 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 125 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 126 * 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 127 * 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 128 * @throws { BusinessError } 17700004 - The specified user ID is not found. 129 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 130 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 131 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 132 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 133 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 134 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 135 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 136 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 137 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 138 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 139 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 140 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 141 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 142 * (required APL: system_basic or system_core). 143 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 144 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 145 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 146 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 147 * @syscap SystemCapability.BundleManager.BundleFramework.Core 148 * @systemapi 149 * @since 10 150 */ 151 /** 152 * Install HAPs for an application. 153 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 154 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 155 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 156 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 157 * 158 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 159 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 160 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 161 * @param { AsyncCallback<void> } callback - The callback of installing HAPs result. 162 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 163 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 164 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 165 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 166 * 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 167 * 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 168 * @throws { BusinessError } 17700004 - The specified user ID is not found. 169 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 170 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 171 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 172 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 173 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 174 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 175 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 176 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 177 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 178 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 179 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 180 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 181 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 182 * (required APL: system_basic or system_core). 183 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 184 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 185 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 186 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 187 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 188 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 189 * @syscap SystemCapability.BundleManager.BundleFramework.Core 190 * @systemapi 191 * @since 11 192 */ 193 /** 194 * Install HAPs for an application. 195 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 196 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 197 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 198 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 199 * 200 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 201 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 202 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 203 * @param { AsyncCallback<void> } callback - The callback of installing HAPs result. 204 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 205 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 206 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 207 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 208 * @throws { BusinessError } 17700004 - The specified user ID is not found. 209 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 210 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 211 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 212 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 213 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 214 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 215 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 216 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 217 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 218 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 219 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 220 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 221 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 222 * (required APL: system_basic or system_core). 223 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 224 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 225 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 226 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 227 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 228 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 229 * @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled. 230 * @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed. 231 * @syscap SystemCapability.BundleManager.BundleFramework.Core 232 * @systemapi 233 * @since 12 234 */ 235 /** 236 * Install HAPs for an application. 237 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 238 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 239 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 240 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 241 * To install an internal beta application, you must have the permission ohos.permission.INSTALL_INTERNALTESTING_BUNDLE. 242 * 243 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 244 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 245 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 246 * @param { AsyncCallback<void> } callback - The callback of installing HAPs result. 247 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 248 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 249 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 250 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 251 * @throws { BusinessError } 17700004 - The specified user ID is not found. 252 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 253 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 254 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 255 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 256 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 257 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 258 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 259 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 260 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 261 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 262 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 263 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 264 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 265 * (required APL: system_basic or system_core). 266 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 267 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 268 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 269 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 270 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 271 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 272 * @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled. 273 * @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed. 274 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 275 * <br>bundle name but different signature information exists on the device. 276 * @syscap SystemCapability.BundleManager.BundleFramework.Core 277 * @systemapi 278 * @since 13 279 */ 280 /** 281 * Install HAPs for an application. 282 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 283 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 284 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 285 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 286 * To install an internal beta application, you must have the permission ohos.permission.INSTALL_INTERNALTESTING_BUNDLE. 287 * 288 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 289 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 290 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 291 * @param { AsyncCallback<void> } callback - The callback of installing HAPs result. 292 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 293 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 294 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 295 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 296 * @throws { BusinessError } 17700004 - The specified user ID is not found. 297 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 298 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 299 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 300 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 301 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 302 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 303 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 304 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 305 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 306 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 307 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 308 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 309 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 310 * (required APL: system_basic or system_core). 311 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 312 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 313 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 314 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 315 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 316 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 317 * @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled. 318 * @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed. 319 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 320 * <br>bundle name but different signature information exists on the device. 321 * @throws { BusinessError } 17700077 - Failed to install the HAP and restore to preinstalled bundle. 322 * @syscap SystemCapability.BundleManager.BundleFramework.Core 323 * @systemapi 324 * @since 17 325 */ 326 /** 327 * Install HAPs for an application. 328 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 329 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 330 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 331 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 332 * To install an internal beta application, you must have the permission ohos.permission.INSTALL_INTERNALTESTING_BUNDLE. 333 * 334 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 335 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 336 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 337 * @param { AsyncCallback<void> } callback - The callback of installing HAPs result. 338 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 339 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 340 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 341 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 342 * @throws { BusinessError } 17700004 - The specified user ID is not found. 343 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 344 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 345 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 346 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 347 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 348 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 349 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 350 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 351 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 352 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 353 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 354 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 355 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 356 * (required APL: system_basic or system_core). 357 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 358 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 359 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 360 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 361 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 362 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 363 * @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled. 364 * @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed. 365 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 366 * <br>bundle name but different signature information exists on the device. 367 * @throws { BusinessError } 17700076 - Failed to install the HAP or HSP because the app distribution type is not allowed. 368 * @throws { BusinessError } 17700077 - Failed to install the HAP and restore to preinstalled bundle. 369 * @syscap SystemCapability.BundleManager.BundleFramework.Core 370 * @systemapi 371 * @since arkts {'1.1':'18', '1.2':'20'} 372 * @arkts 1.1&1.2 373 */ 374 install(hapFilePaths: Array<string>, installParam: InstallParam, callback: AsyncCallback<void>): void; 375 376 /** 377 * Install haps for an application. 378 * 379 * @permission ohos.permission.INSTALL_BUNDLE 380 * @param { Array<string> } hapFilePaths - Indicates the path where the hap of the application is stored. 381 * @param { AsyncCallback<void> } callback - The callback of installing haps result. 382 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE'. 383 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 384 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 385 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 386 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 387 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 388 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 389 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 390 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 391 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 392 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 393 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 394 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 395 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 396 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 397 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 398 * (required APL: system_basic or system_core). 399 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 400 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 401 * @syscap SystemCapability.BundleManager.BundleFramework.Core 402 * @systemapi 403 * @since 9 404 */ 405 /** 406 * Install HAPs for an application. 407 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 408 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 409 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 410 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 411 * 412 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 413 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 414 * @param { AsyncCallback<void> } callback - The callback of installing HAPs result. 415 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 416 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 417 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 418 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 419 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 420 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 421 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 422 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 423 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 424 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 425 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 426 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 427 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 428 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 429 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 430 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 431 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 432 * (required APL: system_basic or system_core). 433 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 434 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 435 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 436 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 437 * @syscap SystemCapability.BundleManager.BundleFramework.Core 438 * @systemapi 439 * @since 10 440 */ 441 /** 442 * Install HAPs for an application. 443 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 444 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 445 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 446 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 447 * 448 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 449 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 450 * @param { AsyncCallback<void> } callback - The callback of installing HAPs result. 451 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 452 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 453 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 454 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 455 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 456 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 457 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 458 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 459 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 460 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 461 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 462 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 463 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 464 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 465 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 466 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 467 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 468 * (required APL: system_basic or system_core). 469 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 470 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 471 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 472 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 473 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 474 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 475 * @syscap SystemCapability.BundleManager.BundleFramework.Core 476 * @systemapi 477 * @since 11 478 */ 479 /** 480 * Install HAPs for an application. 481 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 482 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 483 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 484 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 485 * 486 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 487 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 488 * @param { AsyncCallback<void> } callback - The callback of installing HAPs result. 489 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 490 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 491 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 492 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 493 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 494 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 495 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 496 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 497 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 498 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 499 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 500 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 501 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 502 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 503 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 504 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 505 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 506 * (required APL: system_basic or system_core). 507 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 508 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 509 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 510 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 511 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 512 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 513 * @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled. 514 * @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed. 515 * @syscap SystemCapability.BundleManager.BundleFramework.Core 516 * @systemapi 517 * @since 12 518 */ 519 /** 520 * Install HAPs for an application. 521 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 522 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 523 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 524 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 525 * To install an internal beta application, you must have the permission ohos.permission.INSTALL_INTERNALTESTING_BUNDLE. 526 * 527 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 528 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 529 * @param { AsyncCallback<void> } callback - The callback of installing HAPs result. 530 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 531 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 532 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 533 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 534 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 535 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 536 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 537 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 538 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 539 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 540 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 541 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 542 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 543 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 544 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 545 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 546 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 547 * (required APL: system_basic or system_core). 548 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 549 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 550 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 551 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 552 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 553 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 554 * @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled. 555 * @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed. 556 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 557 * <br>bundle name but different signature information exists on the device. 558 * @syscap SystemCapability.BundleManager.BundleFramework.Core 559 * @systemapi 560 * @since 13 561 */ 562 /** 563 * Install HAPs for an application. 564 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 565 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 566 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 567 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 568 * To install an internal beta application, you must have the permission ohos.permission.INSTALL_INTERNALTESTING_BUNDLE. 569 * 570 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 571 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 572 * @param { AsyncCallback<void> } callback - The callback of installing HAPs result. 573 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 574 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 575 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 576 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 577 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 578 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 579 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 580 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 581 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 582 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 583 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 584 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 585 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 586 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 587 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 588 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 589 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 590 * (required APL: system_basic or system_core). 591 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 592 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 593 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 594 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 595 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 596 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 597 * @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled. 598 * @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed. 599 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 600 * <br>bundle name but different signature information exists on the device. 601 * @throws { BusinessError } 17700077 - Failed to install the HAP and restore to preinstalled bundle. 602 * @syscap SystemCapability.BundleManager.BundleFramework.Core 603 * @systemapi 604 * @since 17 605 */ 606 /** 607 * Install HAPs for an application. 608 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 609 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 610 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 611 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 612 * To install an internal beta application, you must have the permission ohos.permission.INSTALL_INTERNALTESTING_BUNDLE. 613 * 614 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 615 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 616 * @param { AsyncCallback<void> } callback - The callback of installing HAPs result. 617 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 618 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 619 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 620 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 621 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 622 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 623 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 624 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 625 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 626 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 627 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 628 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 629 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 630 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 631 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 632 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 633 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 634 * (required APL: system_basic or system_core). 635 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 636 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 637 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 638 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 639 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 640 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 641 * @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled. 642 * @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed. 643 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 644 * <br>bundle name but different signature information exists on the device. 645 * @throws { BusinessError } 17700076 - Failed to install the HAP or HSP because the app distribution type is not allowed. 646 * @throws { BusinessError } 17700077 - Failed to install the HAP and restore to preinstalled bundle. 647 * @syscap SystemCapability.BundleManager.BundleFramework.Core 648 * @systemapi 649 * @since arkts {'1.1':'18', '1.2':'20'} 650 * @arkts 1.1&1.2 651 */ 652 install(hapFilePaths: Array<string>, callback: AsyncCallback<void>): void; 653 654 /** 655 * Install haps for an application. 656 * 657 * @permission ohos.permission.INSTALL_BUNDLE 658 * @param { Array<string> } hapFilePaths - Indicates the path where the hap of the application is stored. 659 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 660 * @returns { Promise<void> } the promise returned by the function. 661 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE'. 662 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 663 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 664 * @throws { BusinessError } 17700004 - The specified user ID is not found. 665 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 666 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 667 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 668 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 669 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 670 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 671 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 672 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 673 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 674 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 675 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 676 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 677 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 678 * (required APL: system_basic or system_core). 679 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 680 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 681 * @syscap SystemCapability.BundleManager.BundleFramework.Core 682 * @systemapi 683 * @since 9 684 */ 685 /** 686 * Install haps for an application. 687 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 688 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 689 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 690 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 691 * 692 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 693 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 694 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 695 * @returns { Promise<void> } the promise returned by the function. 696 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 697 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 698 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 699 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 700 * 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 701 * 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 702 * @throws { BusinessError } 17700004 - The specified user ID is not found. 703 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 704 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 705 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 706 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 707 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 708 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 709 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 710 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 711 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 712 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 713 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 714 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 715 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 716 * (required APL: system_basic or system_core). 717 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 718 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 719 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 720 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 721 * @syscap SystemCapability.BundleManager.BundleFramework.Core 722 * @systemapi 723 * @since 10 724 */ 725 /** 726 * Install haps for an application. 727 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 728 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 729 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 730 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 731 * 732 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 733 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 734 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 735 * @returns { Promise<void> } the promise returned by the function. 736 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 737 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 738 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 739 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 740 * 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 741 * 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 742 * @throws { BusinessError } 17700004 - The specified user ID is not found. 743 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 744 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 745 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 746 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 747 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 748 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 749 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 750 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 751 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 752 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 753 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 754 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 755 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 756 * (required APL: system_basic or system_core). 757 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 758 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 759 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 760 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 761 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 762 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 763 * @syscap SystemCapability.BundleManager.BundleFramework.Core 764 * @systemapi 765 * @since 11 766 */ 767 /** 768 * Install haps for an application. 769 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 770 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 771 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 772 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 773 * 774 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 775 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 776 * @param { InstallParam } [installParam] - Indicates other parameters required for the installation. 777 * @returns { Promise<void> } the promise returned by the function. 778 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 779 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 780 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 781 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 782 * @throws { BusinessError } 17700004 - The specified user ID is not found. 783 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 784 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 785 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 786 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 787 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 788 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 789 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 790 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 791 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 792 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 793 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 794 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 795 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 796 * (required APL: system_basic or system_core). 797 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 798 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 799 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 800 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 801 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 802 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 803 * @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled. 804 * @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed. 805 * @syscap SystemCapability.BundleManager.BundleFramework.Core 806 * @systemapi 807 * @since 12 808 */ 809 /** 810 * Install haps for an application. 811 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 812 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 813 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 814 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 815 * To install an internal beta application, you must have the permission ohos.permission.INSTALL_INTERNALTESTING_BUNDLE. 816 * 817 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 818 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 819 * @param { InstallParam } [installParam] - Indicates other parameters required for the installation. 820 * @returns { Promise<void> } the promise returned by the function. 821 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 822 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 823 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 824 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 825 * @throws { BusinessError } 17700004 - The specified user ID is not found. 826 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 827 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 828 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 829 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 830 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 831 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 832 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 833 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 834 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 835 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 836 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 837 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 838 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 839 * (required APL: system_basic or system_core). 840 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 841 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 842 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 843 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 844 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 845 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 846 * @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled. 847 * @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed. 848 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 849 * <br>bundle name but different signature information exists on the device. 850 * @syscap SystemCapability.BundleManager.BundleFramework.Core 851 * @systemapi 852 * @since 13 853 */ 854 /** 855 * Install haps for an application. 856 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 857 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 858 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 859 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 860 * To install an internal beta application, you must have the permission ohos.permission.INSTALL_INTERNALTESTING_BUNDLE. 861 * 862 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 863 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 864 * @param { InstallParam } [installParam] - Indicates other parameters required for the installation. 865 * @returns { Promise<void> } the promise returned by the function. 866 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 867 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 868 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 869 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 870 * @throws { BusinessError } 17700004 - The specified user ID is not found. 871 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 872 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 873 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 874 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 875 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 876 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 877 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 878 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 879 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 880 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 881 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 882 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 883 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 884 * (required APL: system_basic or system_core). 885 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 886 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 887 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 888 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 889 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 890 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 891 * @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled. 892 * @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed. 893 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 894 * <br>bundle name but different signature information exists on the device. 895 * @throws { BusinessError } 17700077 - Failed to install the HAP and restore to preinstalled bundle. 896 * @syscap SystemCapability.BundleManager.BundleFramework.Core 897 * @systemapi 898 * @since 17 899 */ 900 /** 901 * Install haps for an application. 902 * To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE. 903 * To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE. 904 * To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE. 905 * To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE. 906 * To install an internal beta application, you must have the permission ohos.permission.INSTALL_INTERNALTESTING_BUNDLE. 907 * 908 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE or ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE 909 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 910 * @param { InstallParam } [installParam] - Indicates other parameters required for the installation. 911 * @returns { Promise<void> } the promise returned by the function. 912 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_BUNDLE' or 913 * 'ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE' or 'ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE'. 914 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 915 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 916 * @throws { BusinessError } 17700004 - The specified user ID is not found. 917 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 918 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 919 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 920 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 921 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 922 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 923 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 924 * @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed. 925 * @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions. 926 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 927 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 928 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 929 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 930 * (required APL: system_basic or system_core). 931 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 932 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 933 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 934 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 935 * @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode. 936 * @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions. 937 * @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled. 938 * @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed. 939 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 940 * <br>bundle name but different signature information exists on the device. 941 * @throws { BusinessError } 17700076 - Failed to install the HAP or HSP because the app distribution type is not allowed. 942 * @throws { BusinessError } 17700077 - Failed to install the HAP and restore to preinstalled bundle. 943 * @syscap SystemCapability.BundleManager.BundleFramework.Core 944 * @systemapi 945 * @since arkts {'1.1':'18', '1.2':'20'} 946 * @arkts 1.1&1.2 947 */ 948 install(hapFilePaths: Array<string>, installParam?: InstallParam): Promise<void>; 949 950 /** 951 * Uninstall an application. 952 * 953 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 954 * @param { string } bundleName - Indicates the bundle name of the application to be uninstalled. 955 * @param { InstallParam } installParam - Indicates other parameters required for the uninstall. 956 * @param { AsyncCallback<void> } callback - The callback of uninstalling application result. 957 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.UNINSTALL_BUNDLE'. 958 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 959 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 960 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 961 * @throws { BusinessError } 17700004 - The specified user ID is not found. 962 * @throws { BusinessError } 17700020 - The specified bundle is pre-installed bundle which cannot be uninstalled. 963 * @throws { BusinessError } 17700040 - The specified bundle is a shared bundle which cannot be uninstalled. 964 * @throws { BusinessError } 17700045 - Failed to uninstall because enterprise device management disallow uninstall. 965 * @syscap SystemCapability.BundleManager.BundleFramework.Core 966 * @systemapi 967 * @since 9 968 */ 969 /** 970 * Uninstall an application. 971 * 972 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 973 * @param { string } bundleName - Indicates the bundle name of the application to be uninstalled. 974 * @param { InstallParam } installParam - Indicates other parameters required for the uninstall. 975 * @param { AsyncCallback<void> } callback - The callback of uninstalling application result. 976 * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. 977 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 978 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 979 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 980 * @throws { BusinessError } 17700004 - The specified user ID is not found. 981 * @throws { BusinessError } 17700020 - The specified bundle is a pre-installed bundle and cannot be uninstalled. 982 * @throws { BusinessError } 17700040 - The specified bundle is a shared bundle and cannot be uninstalled. 983 * @throws { BusinessError } 17700045 - Failed to uninstall the HAP because uninstall is not allowed by the enterprise device management. 984 * @throws { BusinessError } 17700067 - Failed to uninstall the HAP because uninstalling the native package failed. 985 * @syscap SystemCapability.BundleManager.BundleFramework.Core 986 * @systemapi 987 * @since 12 988 */ 989 /** 990 * Uninstall an application. 991 * 992 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 993 * @param { string } bundleName - Indicates the bundle name of the application to be uninstalled. 994 * @param { InstallParam } installParam - Indicates other parameters required for the uninstall. 995 * @param { AsyncCallback<void> } callback - The callback of uninstalling application result. 996 * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. 997 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 998 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 999 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1000 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1001 * @throws { BusinessError } 17700020 - The specified bundle is a pre-installed bundle and cannot be uninstalled. 1002 * @throws { BusinessError } 17700040 - The specified bundle is a shared bundle and cannot be uninstalled. 1003 * @throws { BusinessError } 17700045 - Failed to uninstall the HAP because uninstall is not allowed by the enterprise device management. 1004 * @throws { BusinessError } 17700060 - The specified application cannot be uninstalled. 1005 * @throws { BusinessError } 17700067 - Failed to uninstall the HAP because uninstalling the native package failed. 1006 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1007 * @systemapi 1008 * @since 13 1009 */ 1010 /** 1011 * Uninstall an application. 1012 * 1013 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 1014 * @param { string } bundleName - Indicates the bundle name of the application to be uninstalled. 1015 * @param { InstallParam } installParam - Indicates other parameters required for the uninstallation. 1016 * @param { AsyncCallback<void> } callback - The callback of uninstalling application result. 1017 * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. 1018 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1019 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1020 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1021 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1022 * @throws { BusinessError } 17700020 - The specified bundle is a pre-installed bundle and cannot be uninstalled. 1023 * @throws { BusinessError } 17700040 - The specified bundle is a shared bundle and cannot be uninstalled. 1024 * @throws { BusinessError } 17700045 - Failed to uninstall the HAP because uninstall is not allowed by the enterprise device management. 1025 * @throws { BusinessError } 17700060 - The specified application cannot be uninstalled. 1026 * @throws { BusinessError } 17700062 - Failed to uninstall the app because the app is locked. 1027 * @throws { BusinessError } 17700067 - Failed to uninstall the HAP because uninstalling the native package failed. 1028 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1029 * @systemapi 1030 * @since arkts {'1.1':'15', '1.2':'20'} 1031 * @arkts 1.1&1.2 1032 */ 1033 uninstall(bundleName: string, installParam: InstallParam, callback: AsyncCallback<void>): void; 1034 1035 /** 1036 * Uninstall an application. 1037 * 1038 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 1039 * @param { string } bundleName - Indicates the bundle name of the application to be uninstalled. 1040 * @param { AsyncCallback<void> } callback - The callback of uninstalling application result. 1041 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.UNINSTALL_BUNDLE'. 1042 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 1043 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1044 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1045 * @throws { BusinessError } 17700020 - The specified bundle is pre-installed bundle which cannot be uninstalled. 1046 * @throws { BusinessError } 17700040 - The specified bundle is a shared bundle which cannot be uninstalled. 1047 * @throws { BusinessError } 17700045 - Failed to uninstall because enterprise device management disallow uninstall. 1048 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1049 * @systemapi 1050 * @since 9 1051 */ 1052 /** 1053 * Uninstall an application. 1054 * 1055 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 1056 * @param { string } bundleName - Indicates the bundle name of the application to be uninstalled. 1057 * @param { AsyncCallback<void> } callback - The callback of uninstalling application result. 1058 * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. 1059 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1060 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1061 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1062 * @throws { BusinessError } 17700020 - The specified bundle is a pre-installed bundle and cannot be uninstalled. 1063 * @throws { BusinessError } 17700040 - The specified bundle is a shared bundle and cannot be uninstalled. 1064 * @throws { BusinessError } 17700045 - Failed to uninstall the HAP because uninstall is not allowed by the enterprise device management. 1065 * @throws { BusinessError } 17700067 - Failed to uninstall the HAP because uninstalling the native package failed. 1066 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1067 * @systemapi 1068 * @since 12 1069 */ 1070 /** 1071 * Uninstall an application. 1072 * 1073 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 1074 * @param { string } bundleName - Indicates the bundle name of the application to be uninstalled. 1075 * @param { AsyncCallback<void> } callback - The callback of uninstalling application result. 1076 * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. 1077 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1078 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1079 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1080 * @throws { BusinessError } 17700020 - The specified bundle is a pre-installed bundle and cannot be uninstalled. 1081 * @throws { BusinessError } 17700040 - The specified bundle is a shared bundle and cannot be uninstalled. 1082 * @throws { BusinessError } 17700045 - Failed to uninstall the HAP because uninstall is not allowed by the enterprise device management. 1083 * @throws { BusinessError } 17700060 - The specified application cannot be uninstalled. 1084 * @throws { BusinessError } 17700067 - Failed to uninstall the HAP because uninstalling the native package failed. 1085 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1086 * @systemapi 1087 * @since arkts {'1.1':'13', '1.2':'20'} 1088 * @arkts 1.1&1.2 1089 */ 1090 uninstall(bundleName: string, callback: AsyncCallback<void>): void; 1091 1092 /** 1093 * Uninstall an application. 1094 * 1095 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 1096 * @param { string } bundleName - Indicates the bundle name of the application to be uninstalled. 1097 * @param { InstallParam } installParam - Indicates other parameters required for the uninstall. 1098 * @returns { Promise<void> } the promise returned by the function. 1099 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.UNINSTALL_BUNDLE'. 1100 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 1101 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1102 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1103 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1104 * @throws { BusinessError } 17700020 - The specified bundle is pre-installed bundle which cannot be uninstalled. 1105 * @throws { BusinessError } 17700040 - The specified bundle is a shared bundle which cannot be uninstalled. 1106 * @throws { BusinessError } 17700045 - Failed to uninstall because enterprise device management disallow uninstall. 1107 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1108 * @systemapi 1109 * @since 9 1110 */ 1111 /** 1112 * Uninstall an application. 1113 * 1114 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 1115 * @param { string } bundleName - Indicates the bundle name of the application to be uninstalled. 1116 * @param { InstallParam } installParam - Indicates other parameters required for the uninstall. 1117 * @returns { Promise<void> } the promise returned by the function. 1118 * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. 1119 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1120 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1121 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1122 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1123 * @throws { BusinessError } 17700020 - The specified bundle is a pre-installed bundle and cannot be uninstalled. 1124 * @throws { BusinessError } 17700040 - The specified bundle is a shared bundle and cannot be uninstalled. 1125 * @throws { BusinessError } 17700045 - Failed to uninstall the HAP because uninstall is not allowed by the enterprise device management. 1126 * @throws { BusinessError } 17700067 - Failed to uninstall the HAP because uninstalling the native package failed. 1127 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1128 * @systemapi 1129 * @since 12 1130 */ 1131 /** 1132 * Uninstall an application. 1133 * 1134 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 1135 * @param { string } bundleName - Indicates the bundle name of the application to be uninstalled. 1136 * @param { InstallParam } installParam - Indicates other parameters required for the uninstall. 1137 * @returns { Promise<void> } the promise returned by the function. 1138 * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. 1139 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1140 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1141 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1142 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1143 * @throws { BusinessError } 17700020 - The specified bundle is a pre-installed bundle and cannot be uninstalled. 1144 * @throws { BusinessError } 17700040 - The specified bundle is a shared bundle and cannot be uninstalled. 1145 * @throws { BusinessError } 17700045 - Failed to uninstall the HAP because uninstall is not allowed by the enterprise device management. 1146 * @throws { BusinessError } 17700060 - The specified application cannot be uninstalled. 1147 * @throws { BusinessError } 17700067 - Failed to uninstall the HAP because uninstalling the native package failed. 1148 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1149 * @systemapi 1150 * @since 13 1151 */ 1152 /** 1153 * Uninstall an application. 1154 * 1155 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 1156 * @param { string } bundleName - Indicates the bundle name of the application to be uninstalled. 1157 * @param { InstallParam } [installParam] - Indicates other parameters required for the uninstallation. 1158 * @returns { Promise<void> } the promise returned by the function. 1159 * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. 1160 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1161 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1162 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1163 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1164 * @throws { BusinessError } 17700020 - The specified bundle is a pre-installed bundle and cannot be uninstalled. 1165 * @throws { BusinessError } 17700040 - The specified bundle is a shared bundle and cannot be uninstalled. 1166 * @throws { BusinessError } 17700045 - Failed to uninstall the HAP because uninstall is not allowed by the enterprise device management. 1167 * @throws { BusinessError } 17700060 - The specified application cannot be uninstalled. 1168 * @throws { BusinessError } 17700062 - Failed to uninstall the app because the app is locked. 1169 * @throws { BusinessError } 17700067 - Failed to uninstall the HAP because uninstalling the native package failed. 1170 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1171 * @systemapi 1172 * @since arkts {'1.1':'15', '1.2':'20'} 1173 * @arkts 1.1&1.2 1174 */ 1175 uninstall(bundleName: string, installParam?: InstallParam): Promise<void>; 1176 1177 /** 1178 * Recover an application. 1179 * 1180 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.RECOVER_BUNDLE 1181 * @param { string } bundleName - Indicates the bundle name of the application to be recovered. 1182 * @param { InstallParam } installParam - Indicates other parameters required for the recover. 1183 * @param { AsyncCallback<void> } callback - The callback of recovering application result. 1184 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.RECOVER_BUNDLE'. 1185 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1186 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1187 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1188 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1189 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1190 * @systemapi 1191 * @since 9 1192 */ 1193 /** 1194 * Recover an application. 1195 * 1196 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.RECOVER_BUNDLE 1197 * @param { string } bundleName - Indicates the bundle name of the application to be recovered. 1198 * @param { InstallParam } installParam - Indicates other parameters required for the recover. 1199 * @param { AsyncCallback<void> } callback - The callback of recovering application result. 1200 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.RECOVER_BUNDLE'. 1201 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1202 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1203 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1204 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1205 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 1206 * <br>bundle name but different signature information exists on the device. 1207 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1208 * @systemapi 1209 * @since 13 1210 */ 1211 /** 1212 * Recover an application. 1213 * 1214 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.RECOVER_BUNDLE 1215 * @param { string } bundleName - Indicates the bundle name of the application to be recovered. 1216 * @param { InstallParam } installParam - Indicates other parameters required for the recover. 1217 * @param { AsyncCallback<void> } callback - The callback of recovering application result. 1218 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.RECOVER_BUNDLE'. 1219 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1220 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1221 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1222 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1223 * @throws { BusinessError } 17700058 - Failed to install the HAP because this application is prohibited 1224 * <br>from being installed on this device or by specified users. 1225 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 1226 * <br>bundle name but different signature information exists on the device. 1227 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1228 * @systemapi 1229 * @since arkts {'1.1':'14', '1.2':'20'} 1230 * @arkts 1.1&1.2 1231 */ 1232 recover(bundleName: string, installParam: InstallParam, callback: AsyncCallback<void>): void; 1233 1234 /** 1235 * Recover an application. 1236 * 1237 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.RECOVER_BUNDLE 1238 * @param { string } bundleName - Indicates the bundle name of the application to be recovered. 1239 * @param { AsyncCallback<void> } callback - The callback of recovering application result. 1240 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.RECOVER_BUNDLE'. 1241 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1242 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1243 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1244 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1245 * @systemapi 1246 * @since 9 1247 */ 1248 /** 1249 * Recover an application. 1250 * 1251 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.RECOVER_BUNDLE 1252 * @param { string } bundleName - Indicates the bundle name of the application to be recovered. 1253 * @param { AsyncCallback<void> } callback - The callback of recovering application result. 1254 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.RECOVER_BUNDLE'. 1255 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1256 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1257 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1258 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 1259 * <br>bundle name but different signature information exists on the device. 1260 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1261 * @systemapi 1262 * @since 13 1263 */ 1264 /** 1265 * Recover an application. 1266 * 1267 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.RECOVER_BUNDLE 1268 * @param { string } bundleName - Indicates the bundle name of the application to be recovered. 1269 * @param { AsyncCallback<void> } callback - The callback of recovering application result. 1270 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.RECOVER_BUNDLE'. 1271 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1272 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1273 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1274 * @throws { BusinessError } 17700058 - Failed to install the HAP because this application is prohibited 1275 * <br>from being installed on this device or by specified users. 1276 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 1277 * <br>bundle name but different signature information exists on the device. 1278 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1279 * @systemapi 1280 * @since arkts {'1.1':'14', '1.2':'20'} 1281 * @arkts 1.1&1.2 1282 */ 1283 recover(bundleName: string, callback: AsyncCallback<void>): void; 1284 1285 /** 1286 * Recover an application. 1287 * 1288 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.RECOVER_BUNDLE 1289 * @param { string } bundleName - Indicates the bundle name of the application to be recovered. 1290 * @param { InstallParam } installParam - Indicates other parameters required for the recover. 1291 * @returns { Promise<void> } the promise returned by the function. 1292 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.RECOVER_BUNDLE'. 1293 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1294 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1295 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1296 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1297 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1298 * @systemapi 1299 * @since 9 1300 */ 1301 /** 1302 * Recover an application. 1303 * 1304 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.RECOVER_BUNDLE 1305 * @param { string } bundleName - Indicates the bundle name of the application to be recovered. 1306 * @param { InstallParam } installParam - Indicates other parameters required for the recover. 1307 * @returns { Promise<void> } the promise returned by the function. 1308 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.RECOVER_BUNDLE'. 1309 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1310 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1311 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1312 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1313 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 1314 * <br>bundle name but different signature information exists on the device. 1315 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1316 * @systemapi 1317 * @since 13 1318 */ 1319 /** 1320 * Recover an application. 1321 * 1322 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.RECOVER_BUNDLE 1323 * @param { string } bundleName - Indicates the bundle name of the application to be recovered. 1324 * @param { InstallParam } installParam - Indicates other parameters required for the recover. 1325 * @returns { Promise<void> } the promise returned by the function. 1326 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.RECOVER_BUNDLE'. 1327 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1328 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1329 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1330 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1331 * @throws { BusinessError } 17700058 - Failed to install the HAP because this application is prohibited 1332 * <br>from being installed on this device or by specified users. 1333 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 1334 * <br>bundle name but different signature information exists on the device. 1335 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1336 * @systemapi 1337 * @since arkts {'1.1':'14', '1.2':'20'} 1338 * @arkts 1.1&1.2 1339 */ 1340 recover(bundleName: string, installParam?: InstallParam): Promise<void>; 1341 1342 /** 1343 * Uninstall a shared bundle. 1344 * 1345 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 1346 * @param { UninstallParam } uninstallParam - Indicates parameters required for the uninstall. 1347 * @param { AsyncCallback<void> } callback - The callback of uninstalling shared bundle result. 1348 * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. 1349 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1350 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1351 * @throws { BusinessError } 17700020 - The specified bundle is a pre-installed bundle and cannot be uninstalled. 1352 * @throws { BusinessError } 17700037 - The version of shared bundle is dependent on other applications. 1353 * @throws { BusinessError } 17700038 - The specified shared bundle does not exist. 1354 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1355 * @systemapi 1356 * @since arkts {'1.1':'10', '1.2':'20'} 1357 * @arkts 1.1&1.2 1358 */ 1359 uninstall(uninstallParam: UninstallParam, callback: AsyncCallback<void>): void; 1360 1361 /** 1362 * Uninstall a shared bundle. 1363 * 1364 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 1365 * @param { UninstallParam } uninstallParam - Indicates parameters required for the uninstall. 1366 * @returns { Promise<void> } the promise returned by the function. 1367 * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. 1368 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1369 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1370 * @throws { BusinessError } 17700020 - The specified bundle is a pre-installed bundle and cannot be uninstalled. 1371 * @throws { BusinessError } 17700037 - The version of shared bundle is dependent on other applications. 1372 * @throws { BusinessError } 17700038 - The specified shared bundle does not exist. 1373 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1374 * @systemapi 1375 * @since arkts {'1.1':'10', '1.2':'20'} 1376 * @arkts 1.1&1.2 1377 */ 1378 uninstall(uninstallParam: UninstallParam): Promise<void>; 1379 1380 /** 1381 * Updates this enterprise application. 1382 * 1383 * @permission ohos.permission.INSTALL_SELF_BUNDLE 1384 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 1385 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 1386 * @param { AsyncCallback<void> } callback - Indicates the callback used to return the HAP installation result. 1387 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_SELF_BUNDLE'. 1388 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1389 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 1390 * 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 1391 * 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 1392 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1393 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 1394 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 1395 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 1396 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 1397 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 1398 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 1399 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 1400 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 1401 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 1402 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 1403 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 1404 * (required APL: system_basic or system_core). 1405 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 1406 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 1407 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 1408 * @throws { BusinessError } 17700049 - Failed to install the HAP because the bundleName is different from the bundleName of the caller application. 1409 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 1410 * @throws { BusinessError } 17700051 - Failed to install the HAP because the distribution type of caller application is not enterprise_mdm. 1411 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1412 * @systemapi 1413 * @since 10 1414 */ 1415 /** 1416 * Updates this enterprise application. 1417 * 1418 * @permission ohos.permission.INSTALL_SELF_BUNDLE 1419 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 1420 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 1421 * @param { AsyncCallback<void> } callback - Indicates the callback used to return the HAP installation result. 1422 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_SELF_BUNDLE'. 1423 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1424 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 1425 * 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 1426 * 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 1427 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1428 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 1429 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 1430 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 1431 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 1432 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 1433 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 1434 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 1435 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 1436 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 1437 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 1438 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 1439 * (required APL: system_basic or system_core). 1440 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 1441 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 1442 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 1443 * @throws { BusinessError } 17700049 - Failed to install the HAP because the bundleName is different from the bundleName of the caller application. 1444 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 1445 * @throws { BusinessError } 17700051 - Failed to install the HAP because the distribution type of caller application is not enterprise_mdm. 1446 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1447 * @systemapi 1448 * @since arkts {'1.1':'12', '1.2':'20'} 1449 * @arkts 1.1&1.2 1450 */ 1451 updateBundleForSelf(hapFilePaths: Array<string>, installParam: InstallParam, callback: AsyncCallback<void>): void; 1452 1453 /** 1454 * Updates this enterprise application. 1455 * 1456 * @permission ohos.permission.INSTALL_SELF_BUNDLE 1457 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 1458 * @param { AsyncCallback<void> } callback - Indicates the callback used to return the HAP installation result. 1459 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_SELF_BUNDLE'. 1460 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1461 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1462 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 1463 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 1464 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 1465 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 1466 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 1467 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 1468 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 1469 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 1470 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 1471 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 1472 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 1473 * (required APL: system_basic or system_core). 1474 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 1475 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 1476 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 1477 * @throws { BusinessError } 17700049 - Failed to install the HAP because the bundleName is different from the bundleName of the caller application. 1478 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 1479 * @throws { BusinessError } 17700051 - Failed to install the HAP because the distribution type of caller application is not enterprise_mdm. 1480 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1481 * @systemapi 1482 * @since 10 1483 */ 1484 /** 1485 * Updates this enterprise application. 1486 * 1487 * @permission ohos.permission.INSTALL_SELF_BUNDLE 1488 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 1489 * @param { AsyncCallback<void> } callback - Indicates the callback used to return the HAP installation result. 1490 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_SELF_BUNDLE'. 1491 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1492 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1493 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 1494 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 1495 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 1496 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 1497 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 1498 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 1499 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 1500 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 1501 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 1502 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 1503 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 1504 * (required APL: system_basic or system_core). 1505 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 1506 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 1507 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 1508 * @throws { BusinessError } 17700049 - Failed to install the HAP because the bundleName is different from the bundleName of the caller application. 1509 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 1510 * @throws { BusinessError } 17700051 - Failed to install the HAP because the distribution type of caller application is not enterprise_mdm. 1511 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1512 * @systemapi 1513 * @since arkts {'1.1':'12', '1.2':'20'} 1514 * @arkts 1.1&1.2 1515 */ 1516 updateBundleForSelf(hapFilePaths: Array<string>, callback: AsyncCallback<void>): void; 1517 1518 /** 1519 * Updates this enterprise application. 1520 * 1521 * @permission ohos.permission.INSTALL_SELF_BUNDLE 1522 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 1523 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 1524 * @returns { Promise<void> } the promise returned by the function. 1525 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_SELF_BUNDLE'. 1526 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1527 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 1528 * 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 1529 * 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 1530 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1531 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 1532 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 1533 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 1534 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 1535 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 1536 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 1537 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 1538 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 1539 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 1540 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 1541 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 1542 * (required APL: system_basic or system_core). 1543 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 1544 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 1545 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 1546 * @throws { BusinessError } 17700049 - Failed to install the HAP because the bundleName is different from the bundleName of the caller application. 1547 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 1548 * @throws { BusinessError } 17700051 - Failed to install the HAP because the distribution type of caller application is not enterprise_mdm. 1549 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1550 * @systemapi 1551 * @since 10 1552 */ 1553 /** 1554 * Updates this enterprise application. 1555 * 1556 * @permission ohos.permission.INSTALL_SELF_BUNDLE 1557 * @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored. 1558 * @param { InstallParam } installParam - Indicates other parameters required for the installation. 1559 * @returns { Promise<void> } the promise returned by the function. 1560 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_SELF_BUNDLE'. 1561 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1562 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 1563 * 2. Incorrect parameter types; 3. Parameter hapFiles is needed for code signature; 1564 * 4. The size of specifiedDistributionType is greater than 128; 5. The size of additionalInfo is greater than 3000. 1565 * @throws { BusinessError } 17700004 - The specified user ID is not found. 1566 * @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed. 1567 * @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified. 1568 * @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large. 1569 * @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information. 1570 * @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space. 1571 * @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early. 1572 * @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist. 1573 * @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths. 1574 * @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install. 1575 * @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy. 1576 * @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy 1577 * (required APL: system_basic or system_core). 1578 * @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported. 1579 * @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode. 1580 * @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed. 1581 * @throws { BusinessError } 17700049 - Failed to install the HAP because the bundleName is different from the bundleName of the caller application. 1582 * @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device. 1583 * @throws { BusinessError } 17700051 - Failed to install the HAP because the distribution type of caller application is not enterprise_mdm. 1584 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1585 * @systemapi 1586 * @since arkts {'1.1':'12', '1.2':'20'} 1587 * @arkts 1.1&1.2 1588 */ 1589 updateBundleForSelf(hapFilePaths: Array<string>, installParam?: InstallParam): Promise<void>; 1590 1591 /** 1592 * Uninstall updates for a pre-installed application. 1593 * 1594 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 1595 * @param { string } bundleName - Indicates the bundle name of the application to be uninstalled updates. 1596 * @param { InstallParam } installParam - Indicates other parameters required for the uninstall. 1597 * @returns { Promise<void> } the promise returned by the function. 1598 * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. 1599 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1600 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1601 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1602 * @throws { BusinessError } 17700045 - Failed to uninstall because enterprise device management disallow uninstall. 1603 * @throws { BusinessError } 17700057 - Failed to uninstall updates because the HAP is not pre-installed. 1604 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1605 * @systemapi 1606 * @since 12 1607 */ 1608 /** 1609 * Uninstall updates for a pre-installed application. 1610 * 1611 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 1612 * @param { string } bundleName - Indicates the bundle name of the application to be uninstalled updates. 1613 * @param { InstallParam } installParam - Indicates other parameters required for the uninstall. 1614 * @returns { Promise<void> } the promise returned by the function. 1615 * @throws { BusinessError } 201 - Permission verification failed. The application does not have the permission required to call the API. 1616 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1617 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1618 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1619 * @throws { BusinessError } 17700045 - Failed to uninstall because enterprise device management disallow uninstall. 1620 * @throws { BusinessError } 17700057 - Failed to uninstall updates because the HAP is not pre-installed. 1621 * @throws { BusinessError } 17700060 - The specified application cannot be uninstalled. 1622 * @throws { BusinessError } 17700067 - Failed to uninstall the HAP because uninstalling the native package failed. 1623 * @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same 1624 * <br>bundle name but different signature information exists on the device. 1625 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1626 * @systemapi 1627 * @since arkts {'1.1':'13', '1.2':'20'} 1628 * @arkts 1.1&1.2 1629 */ 1630 uninstallUpdates(bundleName: string, installParam?: InstallParam): Promise<void>; 1631 1632 /** 1633 * Add extend resources. 1634 * 1635 * @permission ohos.permission.INSTALL_BUNDLE 1636 * @param { string } bundleName - Indicates the bundleName. 1637 * @param { Array<string> } filePaths - Indicates the file path for extend resources. 1638 * @returns { Promise<void> } Returns addExtResource result. 1639 * @throws { BusinessError } 201 - Permission denied. 1640 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 1641 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1642 * @throws { BusinessError } 17700001 - The specified bundleName is not found. 1643 * @throws { BusinessError } 17700301 - AddExtResource failed due to parse file failed. 1644 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1645 * @systemapi 1646 * @since arkts {'1.1':'12', '1.2':'20'} 1647 * @arkts 1.1&1.2 1648 */ 1649 addExtResource(bundleName: string, filePaths: Array<string>): Promise<void>; 1650 1651 /** 1652 * Remove extend resources. 1653 * 1654 * @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.UNINSTALL_BUNDLE 1655 * @param { string } bundleName - Indicates the bundleName. 1656 * @param { Array<string> } moduleNames - Indicates the moduleNames for extend resources. 1657 * @returns { Promise<void> } Returns removeExtResource result. 1658 * @throws { BusinessError } 201 - Permission denied. 1659 * @throws { BusinessError } 202 - Permission denied, non-system app called system api. 1660 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1661 * @throws { BusinessError } 17700001 - The specified bundleName is not found. 1662 * @throws { BusinessError } 17700302 - RemoveExtResource failed due to module does not exist. 1663 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1664 * @systemapi 1665 * @since arkts {'1.1':'12', '1.2':'20'} 1666 * @arkts 1.1&1.2 1667 */ 1668 removeExtResource(bundleName: string, moduleNames: Array<string>): Promise<void>; 1669 1670 /** 1671 * Create clone instance for an application. 1672 * 1673 * @permission ohos.permission.INSTALL_CLONE_BUNDLE 1674 * @param { string } bundleName - Indicates the path where the HAP of the application is stored. 1675 * @param { CreateAppCloneParam } [createAppCloneParam] Indicates the optional params of create clone app. 1676 * @returns { Promise<number> } Return the appIndex of the clone application. 1677 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_CLONE_BUNDLE'. 1678 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1679 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1680 * @throws { BusinessError } 17700001 - The specified bundleName cannot be found or the bundle is not installed by the specified user. 1681 * @throws { BusinessError } 17700004 - The userId is invalid. 1682 * @throws { BusinessError } 17700061 - The appIndex is not in valid range or already exists. 1683 * @throws { BusinessError } 17700069 - The app does not support the creation of an appClone instance. 1684 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1685 * @systemapi 1686 * @since arkts {'1.1':'12', '1.2':'20'} 1687 * @arkts 1.1&1.2 1688 */ 1689 createAppClone(bundleName: string, createAppCloneParam?: CreateAppCloneParam): Promise<number>; 1690 1691 /** 1692 * Destroy clone instance for an application. 1693 * 1694 * @permission ohos.permission.UNINSTALL_CLONE_BUNDLE 1695 * @param { string } bundleName - Indicates the path where the HAP of the application is stored. 1696 * @param { number } appIndex - Indicates the clone application's index. 1697 * @param { number } [userId] - userId Indicates the user ID. 1698 * @returns { Promise<void> } the promise returned by the function. 1699 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.UNINSTALL_CLONE_BUNDLE'. 1700 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1701 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1702 * @throws { BusinessError } 17700001 - The specified bundleName cannot be found or the bundle is not installed by the specified user. 1703 * @throws { BusinessError } 17700004 - The userId is invalid. 1704 * @throws { BusinessError } 17700061 - AppIndex not in valid range. 1705 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1706 * @systemapi 1707 * @since 12 1708 */ 1709 destroyAppClone(bundleName: string, appIndex: number, userId?: number): Promise<void>; 1710 1711 /** 1712 * Destroy clone instance for an application. 1713 * 1714 * @permission ohos.permission.UNINSTALL_CLONE_BUNDLE 1715 * @param { string } bundleName - Indicates the bundleName of clone app. 1716 * @param { number } appIndex - Indicates the clone application's index. 1717 * @param { DestroyAppCloneParam } [destroyAppCloneParam] - Indicates other parameters required for the uninstallation. 1718 * @returns { Promise<void> } the promise returned by the function. 1719 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.UNINSTALL_CLONE_BUNDLE'. 1720 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1721 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1722 * @throws { BusinessError } 17700001 - The specified bundleName cannot be found or the bundle is not installed by the specified user. 1723 * @throws { BusinessError } 17700004 - The userId is invalid. 1724 * @throws { BusinessError } 17700061 - AppIndex not in valid range. 1725 * @throws { BusinessError } 17700062 - Failed to uninstall the app because the app is locked. 1726 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1727 * @systemapi 1728 * @since 15 1729 */ 1730 destroyAppClone(bundleName: string, appIndex: number, destroyAppCloneParam?: DestroyAppCloneParam): Promise<void>; 1731 1732 /** 1733 * Destroy clone instance for an application. 1734 * 1735 * @permission ohos.permission.UNINSTALL_CLONE_BUNDLE 1736 * @param { string } bundleName - Indicates the bundleName of clone app. 1737 * @param { number } appIndex - Indicates the clone application's index. 1738 * @param { number | DestroyAppCloneParam } [options] - Indicates other parameters required for the uninstallation. 1739 * @returns { Promise<void> } 1740 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.UNINSTALL_CLONE_BUNDLE'. 1741 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1742 * @throws { BusinessError } 17700001 - The specified bundleName cannot be found or the bundle is not installed by the specified user. 1743 * @throws { BusinessError } 17700004 - The userId is invalid. 1744 * @throws { BusinessError } 17700061 - AppIndex not in valid range. 1745 * @throws { BusinessError } 17700062 - Failed to uninstall the app because the app is locked. 1746 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1747 * @systemapi 1748 * @since 20 1749 * @arkts 1.2 1750 */ 1751 destroyAppClone(bundleName: string, appIndex: number, options?: number | DestroyAppCloneParam): Promise<void>; 1752 1753 /** 1754 * Install application by bundle name with specified user. 1755 * 1756 * @permission ohos.permission.INSTALL_BUNDLE 1757 * @param { string } bundleName - Indicates the bundle name of application. 1758 * @param { number } [userId] - userId Indicates the user ID. 1759 * @returns { Promise<void> } the promise returned by the function. 1760 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE'. 1761 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1762 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1763 * @throws { BusinessError } 17700001 - The specified bundleName cannot be found or the bundle is not installed by the specified user. 1764 * @throws { BusinessError } 17700004 - The userId is invalid. 1765 * @throws { BusinessError } 17700071 - It is not allowed to install the enterprise bundle. 1766 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1767 * @systemapi 1768 * @since 12 1769 */ 1770 /** 1771 * Install application by bundle name with specified user. 1772 * 1773 * @permission ohos.permission.INSTALL_BUNDLE 1774 * @param { string } bundleName - Indicates the bundle name of application. 1775 * @param { number } [userId] - userId Indicates the user ID. 1776 * @returns { Promise<void> } the promise returned by the function. 1777 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE'. 1778 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1779 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types. 1780 * @throws { BusinessError } 17700001 - The specified bundleName cannot be found or the bundle is not installed by the specified user. 1781 * @throws { BusinessError } 17700004 - The userId is invalid. 1782 * @throws { BusinessError } 17700071 - It is not allowed to install the enterprise bundle. 1783 * @throws { BusinessError } 17700058 - Failed to install the HAP because this application is prohibited 1784 * <br>from being installed on this device or by specified users. 1785 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1786 * @systemapi 1787 * @since arkts {'1.1':'14', '1.2':'20'} 1788 * @arkts 1.1&1.2 1789 */ 1790 installPreexistingApp(bundleName: string, userId?: number): Promise<void>; 1791 1792 /** 1793 * Install plugin for host application. 1794 * 1795 * @permission ohos.permission.INSTALL_PLUGIN_BUNDLE 1796 * @param { string } hostBundleName - Indicates the bundle name of host application. 1797 * @param { Array<string> } pluginFilePaths - Indicates the file paths of plugin. 1798 * @param { PluginParam } [pluginParam] - Indicates parameters required for install plugin. 1799 * @returns { Promise<void> } the promise returned by the function. 1800 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_PLUGIN_BUNDLE'. 1801 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1802 * @throws { BusinessError } 17700001 - The specified hostBundleName cannot be found or the bundle is not installed by the specified user. 1803 * @throws { BusinessError } 17700004 - The userId is invalid. 1804 * @throws { BusinessError } 17700010 - Failed to install the plugin because the plugin fails to be parsed. 1805 * @throws { BusinessError } 17700011 - Failed to install the plugin because the plugin signature fails to be verified. 1806 * @throws { BusinessError } 17700012 - Failed to install the plugin because the HSP path is invalid or the HSP is too large. 1807 * @throws { BusinessError } 17700015 - Failed to install the plugin because they have different configuration information. 1808 * @throws { BusinessError } 17700016 - Failed to install the plugin because of insufficient system disk space. 1809 * @throws { BusinessError } 17700017 - Failed to install the plugin since the version of the plugin to install is too early. 1810 * @throws { BusinessError } 17700048 - Failed to install the plugin because the code signature verification is failed. 1811 * @throws { BusinessError } 17700052 - Failed to install the plugin because debug bundle cannot be installed under non-developer mode. 1812 * @throws { BusinessError } 17700073 - Failed to install the plugin because a plugin with the same 1813 * <br>bundle name but different signature information exists on the device. 1814 * @throws { BusinessError } 17700087 - Failed to install the plugin because the current device does not support plugin. 1815 * @throws { BusinessError } 17700088 - Failed to install the plugin because the host application lacks ohos.permission.kernel.SUPPORT_PLUGIN. 1816 * @throws { BusinessError } 17700089 - Failed to install the plugin because the plugin id fails to be parsed. 1817 * @throws { BusinessError } 17700090 - Failed to install the plugin because the plugin id fails to be verified. 1818 * @throws { BusinessError } 17700091 - Failed to install the plugin because the plugin name is same as host bundle name. 1819 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1820 * @systemapi 1821 * @since arkts {'1.1':'19', '1.2':'20'} 1822 * @arkts 1.1&1.2 1823 */ 1824 installPlugin(hostBundleName: string, pluginFilePaths: Array<string>, pluginParam?: PluginParam): Promise<void>; 1825 1826 /** 1827 * Uninstall plugin for host application. 1828 * 1829 * @permission ohos.permission.UNINSTALL_PLUGIN_BUNDLE 1830 * @param { string } hostBundleName - Indicates the bundle name of host application. 1831 * @param { string } pluginBundleName - Indicates the bundle name of plugin application. 1832 * @param { PluginParam } [pluginParam] - Indicates parameters required for uninstall plugin. 1833 * @returns { Promise<void> } the promise returned by the function. 1834 * @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.UNINSTALL_PLUGIN_BUNDLE'. 1835 * @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API. 1836 * @throws { BusinessError } 17700001 - The specified bundle name is not found. 1837 * @throws { BusinessError } 17700004 - The user id is invalid. 1838 * @throws { BusinessError } 17700092 - Failed to uninstall the plugin because the specified plugin is not found. 1839 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1840 * @systemapi 1841 * @since arkts {'1.1':'19', '1.2':'20'} 1842 * @arkts 1.1&1.2 1843 */ 1844 uninstallPlugin(hostBundleName: string, pluginBundleName: string, pluginParam?: PluginParam): Promise<void>; 1845 } 1846 1847 /** 1848 * Provides parameters required for hashParam. 1849 * 1850 * @typedef HashParam 1851 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1852 * @systemapi 1853 * @since arkts {'1.1':'9', '1.2':'20'} 1854 * @arkts 1.1&1.2 1855 */ 1856 export interface HashParam { 1857 /** 1858 * Indicates the moduleName 1859 * 1860 * @type { string } 1861 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1862 * @systemapi 1863 * @since arkts {'1.1':'9', '1.2':'20'} 1864 * @arkts 1.1&1.2 1865 */ 1866 moduleName: string; 1867 1868 /** 1869 * Indicates the hash value 1870 * 1871 * @type { string } 1872 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1873 * @systemapi 1874 * @since arkts {'1.1':'9', '1.2':'20'} 1875 * @arkts 1.1&1.2 1876 */ 1877 hashValue: string; 1878 } 1879 1880 /** 1881 * Provides parameters required for VerifyCodeParam. 1882 * 1883 * @typedef VerifyCodeParam 1884 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1885 * @systemapi 1886 * @since 10 1887 * @deprecated since 11 1888 */ 1889 export interface VerifyCodeParam { 1890 /** 1891 * Indicates the moduleName which hopes to be processed with code signature. 1892 * 1893 * @type { string } 1894 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1895 * @systemapi 1896 * @since 10 1897 * @deprecated since 11 1898 */ 1899 moduleName: string; 1900 1901 /** 1902 * Indicates the path where the code signature file of the corresponding HAP is stored. 1903 * 1904 * @type { string } 1905 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1906 * @systemapi 1907 * @since 10 1908 * @deprecated since 11 1909 */ 1910 signatureFilePath: string; 1911 } 1912 1913 /** 1914 * Provides parameters required for PGOParam. 1915 * 1916 * @typedef PGOParam 1917 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1918 * @systemapi 1919 * @since arkts {'1.1':'11', '1.2':'20'} 1920 * @arkts 1.1&1.2 1921 */ 1922 export interface PGOParam { 1923 /** 1924 * Indicates the moduleName that need to store profile-guided optimization(PGO) file. 1925 * 1926 * @type { string } 1927 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1928 * @systemapi 1929 * @since arkts {'1.1':'11', '1.2':'20'} 1930 * @arkts 1.1&1.2 1931 */ 1932 moduleName: string; 1933 1934 /** 1935 * Indicates the path where the profile-guided optimization(PGO) file is stored. 1936 * 1937 * @type { string } 1938 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1939 * @systemapi 1940 * @since arkts {'1.1':'11', '1.2':'20'} 1941 * @arkts 1.1&1.2 1942 */ 1943 pgoFilePath: string; 1944 } 1945 1946 /** 1947 * Provides parameters required for Parameters. 1948 * 1949 * @typedef Parameters 1950 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1951 * @systemapi 1952 * @since arkts {'1.1':'15', '1.2':'20'} 1953 * @arkts 1.1&1.2 1954 */ 1955 export interface Parameters { 1956 /** 1957 * Indicates key. 1958 * 1959 * @type { string } 1960 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1961 * @systemapi 1962 * @since arkts {'1.1':'15', '1.2':'20'} 1963 * @arkts 1.1&1.2 1964 */ 1965 key: string; 1966 1967 /** 1968 * Indicates value. 1969 * 1970 * @type { string } 1971 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1972 * @systemapi 1973 * @since arkts {'1.1':'15', '1.2':'20'} 1974 * @arkts 1.1&1.2 1975 */ 1976 value: string; 1977 } 1978 1979 /** 1980 * Provides parameters required for installing or uninstalling an application. 1981 * 1982 * @typedef InstallParam 1983 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1984 * @systemapi 1985 * @since arkts {'1.1':'9', '1.2':'20'} 1986 * @arkts 1.1&1.2 1987 */ 1988 export interface InstallParam { 1989 /** 1990 * Indicates the user id 1991 * 1992 * @type { ?number } 1993 * @syscap SystemCapability.BundleManager.BundleFramework.Core 1994 * @systemapi 1995 * @since arkts {'1.1':'9', '1.2':'20'} 1996 * @arkts 1.1&1.2 1997 */ 1998 userId?: number; 1999 2000 /** 2001 * Indicates the installation type. The value 0x00 means normal installation, 0x01 means overwrite installation, and 0x10 means installation-free. 2002 * 2003 * @type { ?number } 2004 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2005 * @systemapi 2006 * @since arkts {'1.1':'9', '1.2':'20'} 2007 * @arkts 1.1&1.2 2008 */ 2009 installFlag?: number; 2010 2011 /** 2012 * Indicates whether the param has data 2013 * 2014 * @type { ?boolean } 2015 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2016 * @systemapi 2017 * @since arkts {'1.1':'9', '1.2':'20'} 2018 * @arkts 1.1&1.2 2019 */ 2020 isKeepData?: boolean; 2021 2022 /** 2023 * Indicates the hash params 2024 * 2025 * @type { ?Array<HashParam> } 2026 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2027 * @systemapi 2028 * @since arkts {'1.1':'9', '1.2':'20'} 2029 * @arkts 1.1&1.2 2030 */ 2031 hashParams?: Array<HashParam>; 2032 2033 /** 2034 * Indicates the deadline of the crowdtesting bundle 2035 * 2036 * @type { ?number } 2037 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2038 * @systemapi 2039 * @since arkts {'1.1':'9', '1.2':'20'} 2040 * @arkts 1.1&1.2 2041 */ 2042 crowdtestDeadline?: number; 2043 2044 /** 2045 * Indicates the shared bundle dir paths. 2046 * 2047 * @type { ?Array<string> } 2048 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2049 * @systemapi 2050 * @since arkts {'1.1':'10', '1.2':'20'} 2051 * @arkts 1.1&1.2 2052 */ 2053 sharedBundleDirPaths?: Array<string>; 2054 2055 /** 2056 * Indicates the distribution type specified during bundle installation. 2057 * 2058 * @type { ?string } 2059 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2060 * @systemapi 2061 * @since arkts {'1.1':'10', '1.2':'20'} 2062 * @arkts 1.1&1.2 2063 */ 2064 specifiedDistributionType?: string; 2065 2066 /** 2067 * Indicates the additional information during bundle installation. 2068 * 2069 * @type { ?string } 2070 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2071 * @systemapi 2072 * @since arkts {'1.1':'10', '1.2':'20'} 2073 * @arkts 1.1&1.2 2074 */ 2075 additionalInfo?: string; 2076 2077 /** 2078 * Indicates the verification code param. 2079 * 2080 * @type { ?Array<VerifyCodeParam> } 2081 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2082 * @systemapi 2083 * @since 10 2084 * @deprecated since 11 2085 */ 2086 verifyCodeParams?: Array<VerifyCodeParam>; 2087 2088 /** 2089 * Indicates the profile-guided optimization(PGO) params. 2090 * 2091 * @type { ?Array<PGOParam> } 2092 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2093 * @systemapi 2094 * @since arkts {'1.1':'11', '1.2':'20'} 2095 * @arkts 1.1&1.2 2096 */ 2097 pgoParams?: Array<PGOParam>; 2098 2099 /** 2100 * Indicates parameters. 2101 * 2102 * @type { ?Array<Parameters> } 2103 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2104 * @systemapi 2105 * @since arkts {'1.1':'15', '1.2':'20'} 2106 * @arkts 1.1&1.2 2107 */ 2108 parameters?: Array<Parameters>; 2109 } 2110 2111 /** 2112 * Provides parameters required for uninstalling shared bundle. 2113 * 2114 * @typedef UninstallParam 2115 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2116 * @systemapi 2117 * @since arkts {'1.1':'10', '1.2':'20'} 2118 * @arkts 1.1&1.2 2119 */ 2120 export interface UninstallParam { 2121 /** 2122 * Indicates the shared bundle name 2123 * 2124 * @type { string } 2125 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2126 * @systemapi 2127 * @since arkts {'1.1':'10', '1.2':'20'} 2128 * @arkts 1.1&1.2 2129 */ 2130 bundleName: string; 2131 2132 /** 2133 * Indicates the shared version code. If default, indicates that all version sharing bundles are uninstalled 2134 * 2135 * @type { ?number } 2136 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2137 * @systemapi 2138 * @since arkts {'1.1':'10', '1.2':'20'} 2139 * @arkts 1.1&1.2 2140 */ 2141 versionCode?: number; 2142 } 2143 2144 /** 2145 * Provides parameters required for creating clone app. 2146 * 2147 * @typedef CreateAppCloneParam 2148 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2149 * @systemapi 2150 * @since arkts {'1.1':'12', '1.2':'20'} 2151 * @arkts 1.1&1.2 2152 */ 2153 export interface CreateAppCloneParam { 2154 /** 2155 * Indicates the user id 2156 * 2157 * @type { ?number } 2158 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2159 * @systemapi 2160 * @since arkts {'1.1':'12', '1.2':'20'} 2161 * @arkts 1.1&1.2 2162 */ 2163 userId?: number; 2164 /** 2165 * Indicates the appIndex of MultiApp 2166 * 2167 * @type { ?number } 2168 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2169 * @systemapi 2170 * @since arkts {'1.1':'12', '1.2':'20'} 2171 * @arkts 1.1&1.2 2172 */ 2173 appIndex?: number; 2174 } 2175 2176 /** 2177 * Provides parameters required for destroy clone app. 2178 * 2179 * @typedef DestroyAppCloneParam 2180 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2181 * @systemapi 2182 * @since arkts {'1.1':'15', '1.2':'20'} 2183 * @arkts 1.1&1.2 2184 */ 2185 export interface DestroyAppCloneParam { 2186 /** 2187 * Indicates the user id 2188 * 2189 * @type { ?number } 2190 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2191 * @systemapi 2192 * @since arkts {'1.1':'15', '1.2':'20'} 2193 * @arkts 1.1&1.2 2194 */ 2195 userId?: number; 2196 /** 2197 * Indicates parameters. 2198 * 2199 * @type { ?Array<Parameters> } 2200 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2201 * @systemapi 2202 * @since arkts {'1.1':'15', '1.2':'20'} 2203 * @arkts 1.1&1.2 2204 */ 2205 parameters?: Array<Parameters>; 2206 } 2207 2208 /** 2209 * Provides parameters required for installing a plugin or uninstalling a plugin 2210 * 2211 * @typedef PluginParam 2212 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2213 * @systemapi 2214 * @since arkts {'1.1':'19', '1.2':'20'} 2215 * @arkts 1.1&1.2 2216 */ 2217 export interface PluginParam { 2218 /** 2219 * Indicates the user id. 2220 * 2221 * @type { ?number } 2222 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2223 * @systemapi 2224 * @since arkts {'1.1':'19', '1.2':'20'} 2225 * @arkts 1.1&1.2 2226 */ 2227 userId?: number; 2228 2229 /** 2230 * Indicates parameters. 2231 * 2232 * @type { ?Array<Parameters> } 2233 * @syscap SystemCapability.BundleManager.BundleFramework.Core 2234 * @systemapi 2235 * @since arkts {'1.1':'19', '1.2':'20'} 2236 * @arkts 1.1&1.2 2237 */ 2238 parameters?: Array<Parameters>; 2239 } 2240} 2241 2242export default installer; 2243