!14498 新增错误码17700073回合5.0.1Release

Merge pull request !14498 from 赵淦/OpenHarmony-5.0.1-Release
This commit is contained in:
openharmony_ci 2024-11-05 11:04:34 +00:00 committed by Gitee
commit 05028ff94e
No known key found for this signature in database
GPG Key ID: 173E9B9CA92EEF8F

View File

@ -227,6 +227,50 @@ declare namespace installer {
* @systemapi
* @since 12
*/
/**
* Install HAPs for an application.
* To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE.
* To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE.
* To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE.
* To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE.
*
* @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
* @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored.
* @param { InstallParam } installParam - Indicates other parameters required for the installation.
* @param { AsyncCallback<void> } callback - The callback of installing HAPs result.
* @throws { BusinessError } 201 - Calling interface without 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'.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @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.
* @throws { BusinessError } 17700004 - The specified user ID is not found.
* @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed.
* @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified.
* @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large.
* @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information.
* @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space.
* @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early.
* @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist.
* @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed.
* @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions.
* @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths.
* @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install.
* @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy.
* @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy
* (required APL: system_basic or system_core).
* @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported.
* @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode.
* @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed.
* @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device.
* @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode.
* @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions.
* @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled.
* @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed.
* @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same
* <br>bundle name but different signature information exists on the device.
* @syscap SystemCapability.BundleManager.BundleFramework.Core
* @systemapi
* @since 13
*/
install(hapFilePaths: Array<string>, installParam: InstallParam, callback: AsyncCallback<void>): void;
/**
@ -372,6 +416,48 @@ declare namespace installer {
* @systemapi
* @since 12
*/
/**
* Install HAPs for an application.
* To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE.
* To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE.
* To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE.
* To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE.
*
* @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
* @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored.
* @param { AsyncCallback<void> } callback - The callback of installing HAPs result.
* @throws { BusinessError } 201 - Calling interface without 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'.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed.
* @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified.
* @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large.
* @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information.
* @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space.
* @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early.
* @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist.
* @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed.
* @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions.
* @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths.
* @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install.
* @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy.
* @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy
* (required APL: system_basic or system_core).
* @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported.
* @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode.
* @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed.
* @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device.
* @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode.
* @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions.
* @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled.
* @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed.
* @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same
* <br>bundle name but different signature information exists on the device.
* @syscap SystemCapability.BundleManager.BundleFramework.Core
* @systemapi
* @since 13
*/
install(hapFilePaths: Array<string>, callback: AsyncCallback<void>): void;
/**
@ -529,6 +615,50 @@ declare namespace installer {
* @systemapi
* @since 12
*/
/**
* Install haps for an application.
* To install a non-enterprise application, you must have the permission ohos.permission.INSTALL_BUNDLE.
* To install an enterprise application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_BUNDLE.
* To install an enterprise administrator application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_MDM_BUNDLE.
* To install an enterprise normal application, you must have the permission ohos.permission.INSTALL_ENTERPRISE_NORMAL_BUNDLE.
*
* @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
* @param { Array<string> } hapFilePaths - Indicates the path where the HAP of the application is stored.
* @param { InstallParam } [installParam] - Indicates other parameters required for the installation.
* @returns { Promise<void> }
* @throws { BusinessError } 201 - Calling interface without 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'.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @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.
* @throws { BusinessError } 17700004 - The specified user ID is not found.
* @throws { BusinessError } 17700010 - Failed to install the HAP because the HAP fails to be parsed.
* @throws { BusinessError } 17700011 - Failed to install the HAP because the HAP signature fails to be verified.
* @throws { BusinessError } 17700012 - Failed to install the HAP because the HAP path is invalid or the HAP is too large.
* @throws { BusinessError } 17700015 - Failed to install the HAPs because they have different configuration information.
* @throws { BusinessError } 17700016 - Failed to install the HAP because of insufficient system disk space.
* @throws { BusinessError } 17700017 - Failed to install the HAP since the version of the HAP to install is too early.
* @throws { BusinessError } 17700018 - Failed to install because the dependent module does not exist.
* @throws { BusinessError } 17700031 - Failed to install the HAP because the overlay check of the HAP is failed.
* @throws { BusinessError } 17700036 - Failed to install the HSP because lacks appropriate permissions.
* @throws { BusinessError } 17700039 - Failed to install because disallow install a shared bundle by hapFilePaths.
* @throws { BusinessError } 17700041 - Failed to install because enterprise device management disallow install.
* @throws { BusinessError } 17700042 - Failed to install the HAP because of incorrect URI in the data proxy.
* @throws { BusinessError } 17700043 - Failed to install the HAP because of low APL in the non-system data proxy
* (required APL: system_basic or system_core).
* @throws { BusinessError } 17700044 - Failed to install the HAP because the isolationMode configured is not supported.
* @throws { BusinessError } 17700047 - Failed to install the HAP because the VersionCode to be updated is not greater than the current VersionCode.
* @throws { BusinessError } 17700048 - Failed to install the HAP because the code signature verification is failed.
* @throws { BusinessError } 17700050 - Failed to install the HAP because enterprise normal/MDM bundle cannot be installed on non-enterprise device.
* @throws { BusinessError } 17700052 - Failed to install the HAP because debug bundle cannot be installed under non-developer mode.
* @throws { BusinessError } 17700054 - Failed to install the HAP because the HAP requests wrong permissions.
* @throws { BusinessError } 17700058 - Failed to install the HAP because the device has been controlled.
* @throws { BusinessError } 17700066 - Failed to install the HAP because installing the native package failed.
* @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same
* <br>bundle name but different signature information exists on the device.
* @syscap SystemCapability.BundleManager.BundleFramework.Core
* @systemapi
* @since 13
*/
install(hapFilePaths: Array<string>, installParam?: InstallParam): Promise<void>;
/**
@ -727,6 +857,24 @@ declare namespace installer {
* @systemapi
* @since 9
*/
/**
* Recover an application.
*
* @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.RECOVER_BUNDLE
* @param { string } bundleName - Indicates the bundle name of the application to be recovered.
* @param { InstallParam } installParam - Indicates other parameters required for the recover.
* @param { AsyncCallback<void> } callback - The callback of recovering application result.
* @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.RECOVER_BUNDLE'.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 17700001 - The specified bundle name is not found.
* @throws { BusinessError } 17700004 - The specified user ID is not found.
* @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same
* <br>bundle name but different signature information exists on the device.
* @syscap SystemCapability.BundleManager.BundleFramework.Core
* @systemapi
* @since 13
*/
recover(bundleName: string, installParam: InstallParam, callback: AsyncCallback<void>): void;
/**
@ -743,6 +891,22 @@ declare namespace installer {
* @systemapi
* @since 9
*/
/**
* Recover an application.
*
* @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.RECOVER_BUNDLE
* @param { string } bundleName - Indicates the bundle name of the application to be recovered.
* @param { AsyncCallback<void> } callback - The callback of recovering application result.
* @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.RECOVER_BUNDLE'.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 17700001 - The specified bundle name is not found.
* @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same
* <br>bundle name but different signature information exists on the device.
* @syscap SystemCapability.BundleManager.BundleFramework.Core
* @systemapi
* @since 13
*/
recover(bundleName: string, callback: AsyncCallback<void>): void;
/**
@ -761,6 +925,24 @@ declare namespace installer {
* @systemapi
* @since 9
*/
/**
* Recover an application.
*
* @permission ohos.permission.INSTALL_BUNDLE or ohos.permission.RECOVER_BUNDLE
* @param { string } bundleName - Indicates the bundle name of the application to be recovered.
* @param { InstallParam } installParam - Indicates other parameters required for the recover.
* @returns { Promise<void> }
* @throws { BusinessError } 201 - Calling interface without permission 'ohos.permission.INSTALL_BUNDLE' or 'ohos.permission.RECOVER_BUNDLE'.
* @throws { BusinessError } 202 - Permission verification failed. A non-system application calls a system API.
* @throws { BusinessError } 401 - Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
* @throws { BusinessError } 17700001 - The specified bundle name is not found.
* @throws { BusinessError } 17700004 - The specified user ID is not found.
* @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same
* <br>bundle name but different signature information exists on the device.
* @syscap SystemCapability.BundleManager.BundleFramework.Core
* @systemapi
* @since 13
*/
recover(bundleName: string, installParam?: InstallParam): Promise<void>;
/**
@ -1038,6 +1220,8 @@ declare namespace installer {
* @throws { BusinessError } 17700045 - Failed to uninstall because enterprise device management disallow uninstall.
* @throws { BusinessError } 17700057 - Failed to uninstall updates because the HAP is not pre-installed.
* @throws { BusinessError } 17700060 - The specified application cannot be uninstalled.
* @throws { BusinessError } 17700073 - Failed to install the HAP because an application with the same
* <br>bundle name but different signature information exists on the device.
* @syscap SystemCapability.BundleManager.BundleFramework.Core
* @systemapi
* @since 13
@ -1385,7 +1569,7 @@ declare namespace installer {
export interface CreateAppCloneParam {
/**
* Indicates the user id
*
*
* @type { ?number }
* @syscap SystemCapability.BundleManager.BundleFramework.Core
* @systemapi
@ -1394,13 +1578,13 @@ declare namespace installer {
userId?: number;
/**
* Indicates the appIndex of MultiApp
*
*
* @type { ?number }
* @syscap SystemCapability.BundleManager.BundleFramework.Core
* @systemapi
* @since 12
*/
appIndex?: number;
appIndex?: number;
}
}