diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-ElementName.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-ElementName.md index 2d778e03977a44ad74f4ce890218492a6296d4f5..a8422df7d701782aa7e9e492601f66bbc13b4639 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-ElementName.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-ElementName.md @@ -7,7 +7,9 @@ ElementName信息，通过接口[Context.getElementName](js-apis-Context.md)获取。 -## ElementName +## ElementName(deprecated) + +> 从API version 9开始不再维护，建议使用[ElementName](js-apis-bundleManager-elementName.md)替代。 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundle-remoteAbilityInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundle-remoteAbilityInfo.md index 5780790fed9c45955d326b23850800ff9227a0f8..690b6415c2ddd04ef1932bfc60aa4381d6574447 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-bundle-remoteAbilityInfo.md +++ b/zh-cn/application-dev/reference/apis/js-apis-bundle-remoteAbilityInfo.md @@ -9,7 +9,10 @@ 包含基本远程能力信息 -## RemoteAbilityInfo +## RemoteAbilityInfo(deprecated) + +> 从API version 9开始不再维护，建议使用[RemoteAbilityInfo](js-apis-bundleManager-remoteAbilityInfo.md)替代。 + **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.DistributedBundleFramework diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-elementName.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-elementName.md new file mode 100644 index 0000000000000000000000000000000000000000..7c8e9520a08430cc709a9731c16f72dc7b8412c2 --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-elementName.md @@ -0,0 +1,19 @@ +# ElementName + +ElementName信息，通过接口[Context.getElementName](js-apis-Context.md)获取。 + +> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + +## ElementName + + **系统能力:** SystemCapability.BundleManager.BundleFramework + +| 名称 | 类型 | 可读 | 可写 | 说明 | +| ----------------------- | ---------| ---- | ---- | ------------------------- | +| deviceId | string | 是 | 是 | 设备id。 | +| bundleName | string | 是 | 是 | 应用包名。 | +| abilityName | string | 是 | 是 | Ability名称。 | +| uri | string | 是 | 是 | 资源标识符。 | +| shortName | string | 是 | 是 | Ability短名称。 | +| moduleName | string | 是 | 是 | Ability所属的HAP包的模块名称。 | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-bundleManager-remoteAbilityInfo.md b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-remoteAbilityInfo.md new file mode 100644 index 0000000000000000000000000000000000000000..083a56fe3db8711024914e5f18b4f82269f50dc9 --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-bundleManager-remoteAbilityInfo.md @@ -0,0 +1,20 @@ +# RemoteAbilityInfo + +包含基本远程能力信息，通过接口[distributedBundle.getRemoteAbilityInfo](js-apis-distributedBundle.md)获取。 + +> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + +本模块接口为系统接口。 + +## RemoteAbilityInfo + + **系统能力:** SystemCapability.BundleManager.DistributedBundleFramework + + **系统接口：** 此接口为系统接口。 + +| 名称 | 类型 | 可读 | 可写 | 说明 | +| ----------- | -------------------------------------------- | ---- | ---- | ----------------------- | +| elementName | [ElementName](js-apis-bundleManager-elementName.md) | 是 | 否 | 指明的ability的ElementName信息 | +| label | string | 是 | 否 | 指明ability的标签信息 | +| icon | string | 是 | 否 | 指明的ability的图标信息 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-distributedBundle.md b/zh-cn/application-dev/reference/apis/js-apis-distributedBundle.md new file mode 100644 index 0000000000000000000000000000000000000000..02cee1ce3332cd40ed61f674bce5162147c5f4f1 --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-distributedBundle.md @@ -0,0 +1,503 @@ +# distributedBundle模块(JS端SDK接口) + +本模块提供分布式包的管理能力 + +> **说明：** +> +> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + +本模块接口为系统接口。 + +## 导入模块 + +``` +import distributedBundle from '@ohos.bundle.distributedBundle'; +``` + +## 系统能力 + +SystemCapability.BundleManager.DistributedBundleFramework + +## 权限列表 + +| 权限 | 权限等级 | 描述 | +| ------------------------------------------ | ------------ | ------------------ | +| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息 | + +权限等级参考[权限等级说明](https://gitee.com/openharmony/docs/blob/master/zh-cn/application-dev/security/accesstoken-overview.md#%E6%9D%83%E9%99%90%E7%AD%89%E7%BA%A7%E8%AF%B4%E6%98%8E) + +## distributedBundle.getRemoteAbilityInfo + +getRemoteAbilityInfo(elementName: ElementName, callback: AsyncCallback\): void; + +以异步方法根据给定的ElementName获取有关远程设备AbilityInfo信息。使用callback异步回调。 + +**系统接口：** 此接口为系统接口。 + +**需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED + +**系统能力：** SystemCapability.BundleManager.DistributedBundleFramework + +**参数：** + +| 名称 | 类型 | 必填 | 描述 | +| ----------- | ------------------------------------------------------------ | ---- | -------------------------------------------------- | +| elementName | [ElementName](js-apis-bundleManager-elementName.md) | 是 | ElementName信息。 | +| callback | AsyncCallback<[RemoteAbilityInfo](js-apis-bundleManager-remoteAbilityInfo.md)> | 是 | 回调函数，操作成功返回err为null，data为RemoteAbilityInfo对象；否则为错误对象。 | + +**错误码：** + +以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errcode-bundle.md)。 + +| 错误码ID | 错误新息(此处仅提供错误抛出的关键信息) | +|---------------|-------------------------| +| 201 | Permission denied.| +| 401 | The parameter check failed. | +| 801 | Capability not supported. | +| 17700001 | The specified bundle name is not found | +| 17700003 | The specified ability name is not found. | +| 17700007 | The specified device id is not found. | +| 17700027 | The distributed service is not running. | + +**示例：** + +```js +try { + distributedBundle.getRemoteAbilityInfo( + { + deviceId: '1', + bundleName: 'com.example.application', + abilityName: 'MainAbility' + }, (err, data) => { + if (err) { + console.error('Operation failed:' + JSON.stringify(err)); + } else { + console.info('Operation succeed:' + JSON.stringify(data)); + } + }); +} catch (err) { + console.error('Operation failed:' + JSON.stringify(err)); +} +``` + +## distributedBundle.getRemoteAbilityInfo + +getRemoteAbilityInfo(elementName: ElementName): Promise\; + +以异步方法根据给定的ElementName获取有关远程设备AbilityInfo信息。使用Promise异步回调。 + +**系统接口：** 此接口为系统接口。 + +**需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED + +**系统能力：** SystemCapability.BundleManager.DistributedBundleFramework + +**参数：** + +| 名称 | 类型 | 必填 | 描述 | +| ----------- | -------------------------------------------- | ---- | ----------------------- | +| elementName | [ElementName](js-apis-bundleManager-elementName.md) | 是 | ElementName信息。 | + +**返回值：** + +| 类型 | 说明 | +| ------------------------------------------------------------ | --------------------------------- | +| Promise\<[RemoteAbilityInfo](js-apis-bundleManager-remoteAbilityInfo.md)> | Promise对象，返回RemoteAbilityInfo对象。 | + +**错误码：** + +以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errcode-bundle.md)。 + +| 错误码ID | 错误新息(此处仅提供错误抛出的关键信息) | +|---------------|-------------------------| +| 201 | Permission denied.| +| 401 | The parameter check failed. | +| 801 | Capability not supported. | +| 17700001 | The specified bundle name is not found | +| 17700003 | The specified ability name is not found. | +| 17700007 | The specified device id is not found. | +| 17700027 | The distributed service is not running. | + +**示例：** + +```js +try { + distributedBundle.getRemoteAbilityInfo( + { + deviceId: '1', + bundleName: 'com.example.application', + abilityName: 'MainAbility' + }).then(data => { + console.info('Operation succeed:' + JSON.stringify(data)); + }).catch(err => { + console.error('Operation failed:' + JSON.stringify(err)); + }); +} catch (err) { + console.error('Operation failed:' + JSON.stringify(err)); +} +``` + +## distributedBundle.getRemoteAbilityInfo + +getRemoteAbilityInfo(elementNames: Array\, callback: AsyncCallback\>): void; + +以异步方法根据给定的ElementName获取有关远程设备AbilityInfo数组信息。使用callback异步回调。 + +**系统接口：** 此接口为系统接口。 + +**需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED + +**系统能力：** SystemCapability.BundleManager.DistributedBundleFramework + +**参数：** + +| 名称 | 类型 | 必填 | 描述 | +| ------------ | ------------------------------------------------------------ | ---- | -------------------------------------------------- | +| elementNames | Array<[ElementName](js-apis-bundleManager-elementName.md)> | 是 | ElementName信息,最大数组长度为10 | +| callback | AsyncCallback\> | 是 | 回调函数，调用成功返回err为null，data为RemoteAbilityInfo数组对象；否则返回错误对象。 | + +**错误码：** + +以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errcode-bundle.md)。 + +| 错误码ID | 错误新息(此处仅提供错误抛出的关键信息) | +|---------------|-------------------------| +| 201 | Permission denied.| +| 401 | The parameter check failed. | +| 801 | Capability not supported. | +| 17700001 | The specified bundle name is not found | +| 17700003 | The specified ability name is not found. | +| 17700007 | The specified device id is not found. | +| 17700027 | The distributed service is not running. | + +**示例：** + +```js +try { + distributedBundle.getRemoteAbilityInfo( + [ + { + deviceId: '1', + bundleName: 'com.example.application1', + abilityName: 'MainAbility1' + }, + { + deviceId: '1', + bundleName: 'com.example.application2', + abilityName: 'MainAbility' + } + ], (err, data) => { + if (err) { + console.error('Operation failed:' + JSON.stringify(err)); + } else { + console.info('Operation succeed:' + JSON.stringify(data)); + } + }); +} catch (err) { + console.error('Operation failed:' + JSON.stringify(err)); +} +``` + +## distributedBundle.getRemoteAbilityInfo + +getRemoteAbilityInfo(elementNames: Array\): Promise\>; + +以异步方法根据给定的ElementName和locale获取有关远程设备AbilityInfo数组信息。使用Promise异步回调。 + +**系统接口：** 此接口为系统接口。 + +**需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED + +**系统能力：** SystemCapability.BundleManager.DistributedBundleFramework + +**参数：** + +| 名称 | 类型 | 必填 | 描述 | +| ------------ | --------------------------------------------------- | ---- | ----------------------- | +| elementNames | Array<[ElementName](js-apis-bundleManager-elementName.md)> | 是 | ElementName信息,最大数组长度为10。 | + +**返回值：** + +| 类型 | 说明 | +| ------------------------------------------------------------ | --------------------------------- | +| Promise\> | Promise对象，返回RemoteAbilityInfo数组对象。 | + +**错误码：** + +以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errcode-bundle.md)。 + +| 错误码ID | 错误新息(此处仅提供错误抛出的关键信息) | +|---------------|-------------------------| +| 201 | Permission denied.| +| 401 | The parameter check failed. | +| 801 | Capability not supported. | +| 17700001 | The specified bundle name is not found | +| 17700003 | The specified ability name is not found. | +| 17700007 | The specified device id is not found. | +| 17700027 | The distributed service is not running. | + +**示例：** + +```js +try { + distributedBundle.getRemoteAbilityInfo( + [ + { + deviceId: '1', + bundleName: 'com.example.application', + abilityName: 'MainAbility' + }, + { + deviceId: '1', + bundleName: 'com.example.application2', + abilityName: 'MainAbility' + } + ]).then(data => { + console.info('Operation succeed:' + JSON.stringify(data)); + }).catch(err => { + console.error('Operation failed:' + JSON.stringify(err)); + }); +} catch (err) { + console.error('Operation failed:' + JSON.stringify(err)); +} +``` + +## distributedBundle.getRemoteAbilityInfo + +getRemoteAbilityInfo(elementName: ElementName, locale: string, callback: AsyncCallback\): void; + +以异步方法根据给定的ElementName和locale获取有关远程设备AbilityInfo信息。使用callback异步回调。 + +**系统接口：** 此接口为系统接口。 + +**需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED + +**系统能力：** SystemCapability.BundleManager.DistributedBundleFramework + +**参数：** + +| 名称 | 类型 | 必填 | 描述 | +| ----------- | ------------------------------------------------------------ | ---- | -------------------------------------------------- | +| elementName | [ElementName](js-apis-bundleManager-elementName.md) | 是 | ElementName信息。 | +| locale | string |是 | 语言地区 | +| callback | AsyncCallback<[RemoteAbilityInfo](js-apis-bundleManager-remoteAbilityInfo.md)> | 是 | 回调函数，操作成功返回err为null，data为RemoteAbilityInfo对象；否则为错误对象。 | + +**错误码：** + +以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errcode-bundle.md)。 + +| 错误码ID | 错误新息(此处仅提供错误抛出的关键信息) | +|---------------|-------------------------| +| 201 | Permission denied.| +| 401 | The parameter check failed. | +| 801 | Capability not supported. | +| 17700001 | The specified bundle name is not found | +| 17700003 | The specified ability name is not found. | +| 17700007 | The specified device id is not found. | +| 17700027 | The distributed service is not running. | + +**示例：** + +```js +try { + distributedBundle.getRemoteAbilityInfo( + { + deviceId: '1', + bundleName: 'com.example.application', + abilityName: 'MainAbility' + }, 'zh-Hans-CN', (err, data) => { + if (err) { + console.error('Operation failed:' + JSON.stringify(err)); + } else { + console.info('Operation succeed:' + JSON.stringify(data)); + } + }); +} catch (err) { + console.error('Operation failed:' + JSON.stringify(err)); +} +``` + +## distributedBundle.getRemoteAbilityInfo + +getRemoteAbilityInfo(elementName: ElementName, locale: string): Promise\; + +以异步方法根据给定的ElementName和locale获取有关远程设备AbilityInfo信息。使用Promise异步回调。 + +**系统接口：** 此接口为系统接口。 + +**需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED + +**系统能力：** SystemCapability.BundleManager.DistributedBundleFramework + +**参数：** + +| 名称 | 类型 | 必填 | 描述 | +| ----------- | -------------------------------------------- | ---- | ----------------------- | +| elementName | [ElementName](js-apis-bundleManager-elementName.md) | 是 | ElementName信息。 | +| locale | string |是 | 语言地区 | + +**返回值：** + +| 类型 | 说明 | +| ------------------------------------------------------------ | --------------------------------- | +| Promise\<[RemoteAbilityInfo](js-apis-bundleManager-remoteAbilityInfo.md)> | Promise对象，返回RemoteAbilityInfo对象。 | + +**错误码：** + +以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errcode-bundle.md)。 + +| 错误码ID | 错误新息(此处仅提供错误抛出的关键信息) | +|---------------|-------------------------| +| 201 | Permission denied.| +| 401 | The parameter check failed. | +| 801 | Capability not supported. | +| 17700001 | The specified bundle name is not found | +| 17700003 | The specified ability name is not found. | +| 17700007 | The specified device id is not found. | +| 17700027 | The distributed service is not running. | + +**示例：** + +```js +try { + distributedBundle.getRemoteAbilityInfo( + { + deviceId: '1', + bundleName: 'com.example.application', + abilityName: 'MainAbility' + }, 'zh-Hans-CN').then(data => { + console.info('Operation succeed:' + JSON.stringify(data)); + }).catch(err => { + console.error('Operation failed:' + JSON.stringify(err)); + }); +} catch (err) { + console.error('Operation failed:' + JSON.stringify(err)); +} +``` + +## distributedBundle.getRemoteAbilityInfo + +getRemoteAbilityInfo(elementNames: Array\, locale: string, callback: AsyncCallback\>): void; + +以异步方法根据给定的ElementName和locale获取有关远程设备AbilityInfo数组信息。使用callback异步回调。 + +**系统接口：** 此接口为系统接口。 + +**需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED + +**系统能力：** SystemCapability.BundleManager.DistributedBundleFramework + +**参数：** + +| 名称 | 类型 | 必填 | 描述 | +| ------------ | ------------------------------------------------------------ | ---- | -------------------------------------------------- | +| elementNames | Array<[ElementName](js-apis-bundleManager-elementName.md)> | 是 | ElementName信息,最大数组长度为10 | +| locale | string |是 | 语言地区 | +| callback | AsyncCallback\> | 是 | 回调函数，调用成功返回err为null，data为RemoteAbilityInfo数组对象；否则返回错误对象。 | + +**错误码：** + +以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errcode-bundle.md)。 + +| 错误码ID | 错误新息(此处仅提供错误抛出的关键信息) | +|---------------|-------------------------| +| 201 | Permission denied.| +| 401 | The parameter check failed. | +| 801 | Capability not supported. | +| 17700001 | The specified bundle name is not found | +| 17700003 | The specified ability name is not found. | +| 17700007 | The specified device id is not found. | +| 17700027 | The distributed service is not running. | + +**示例：** + +```js +try { + distributedBundle.getRemoteAbilityInfo( + [ + { + deviceId: '1', + bundleName: 'com.example.application1', + abilityName: 'MainAbility1' + }, + { + deviceId: '1', + bundleName: 'com.example.application2', + abilityName: 'MainAbility' + } + ], 'zh-Hans-CN', (err, data) => { + if (err) { + console.error('Operation failed:' + JSON.stringify(err)); + } else { + console.info('Operation succeed:' + JSON.stringify(data)); + } + }); +} catch (err) { + console.error('Operation failed:' + JSON.stringify(err)); +} +``` + +## distributedBundle.getRemoteAbilityInfo + +getRemoteAbilityInfo(elementNames: Array\, locale: string): Promise\>; + +以异步方法根据给定的ElementName和locale获取有关远程设备AbilityInfo数组信息。使用Promise异步回调。 + +**系统接口：** 此接口为系统接口。 + +**需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED + +**系统能力：** SystemCapability.BundleManager.DistributedBundleFramework + +**参数：** + +| 名称 | 类型 | 必填 | 描述 | +| ------------ | --------------------------------------------------- | ---- | ----------------------- | +| elementNames | Array<[ElementName](js-apis-bundleManager-elementName.md)> | 是 | ElementName信息,最大数组长度为10。 | +| locale | string |是 | 语言地区 | + +**返回值：** + +| 类型 | 说明 | +| ------------------------------------------------------------ | --------------------------------- | +| Promise\> | Promise对象，返回RemoteAbilityInfo数组对象。 | + +**错误码：** + +以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errcode-bundle.md)。 + +| 错误码ID | 错误新息(此处仅提供错误抛出的关键信息) | +|---------------|-------------------------| +| 201 | Permission denied.| +| 401 | The parameter check failed. | +| 801 | Capability not supported. | +| 17700001 | The specified bundle name is not found | +| 17700003 | The specified ability name is not found. | +| 17700007 | The specified device id is not found. | +| 17700027 | The distributed service is not running. | + +**示例：** + +```js +try { + distributedBundle.getRemoteAbilityInfo( + [ + { + deviceId: '1', + bundleName: 'com.example.application', + abilityName: 'MainAbility' + }, + { + deviceId: '1', + bundleName: 'com.example.application2', + abilityName: 'MainAbility' + } + ], 'zh-Hans-CN').then(data => { + console.info('Operation succeed:' + JSON.stringify(data)); + }).catch(err => { + console.error('Operation failed:' + JSON.stringify(err)); + }); +} catch (err) { + console.error('Operation failed:' + JSON.stringify(err)); +} +``` diff --git a/zh-cn/application-dev/reference/errorcodes/errcode-bundle.md b/zh-cn/application-dev/reference/errorcodes/errcode-bundle.md new file mode 100644 index 0000000000000000000000000000000000000000..910c81cd3b2c326611f0ad360123526b357699ea --- /dev/null +++ b/zh-cn/application-dev/reference/errorcodes/errcode-bundle.md @@ -0,0 +1,446 @@ +# 包管理子系统通用错误码 + +## 201 权限校验失败 + +### 错误信息 +Permission denied. + +### 可能原因 +1. 调用目标接口时，未申请权限。 +2. 非会话请求方和响应方查询会话信息。 + +### 处理步骤 +1. 请申请相应接口要求的权限。 +2. 请取消非法查询，使用会话请求方和响应方查询会话信息。 + +## 401 参数检查失败 + +### 错误信息 +Parameter check failed. + +### 可能原因 +1. 必选参数没有传入，参数类型错误。 + +### 处理步骤 +1. 请按照参数类型、位置，传入合法的参数。 + +## 801 API不支持 + +### 错误信息 +Capability not supported. + +### 可能原因 +暂无 + +### 处理步骤 +1. 取消调用和调用替代接口。 + +## 17700001 指定的bundleName不存在 + +### 错误信息 +The specified bundle name is not found. + +### 错误描述 +调用接口时，传入的bundleName不存在。 + +### 可能原因 +1. 输入的bundleName有误 +2. 系统中对应的应用没有安装 + +### 处理步骤 +1. 检查bundleName拼写是否有误 +2. 确认对应的应用是否安装 + +## 17700002 指定的moduleName不存在 + +### 错误信息 +The specified module name is not found. + +### 错误描述 +调用接口时，传入的moduleName不存在。 + +### 可能原因 +1. 输入的moduleName有误 +2. 系统中对应的应用没有安装该模块 + +### 处理步骤 +1. 检查bundleName拼写是否有误 +2. 确认对应的应用是否安装该模块 + +## 17700003 指定的abilityName不存在 + +### 错误信息 +The specified ability name is not found. + +### 错误描述 +调用接口时，传入的abilityName不存在。 + +### 可能原因 +1. 输入的abilityName有误 +2. 系统中对应的应用没有安装 + +### 处理步骤 +1. 检查abilityName拼写是否有误 +2. 确认对应的应用是否安装该模块 + +## 17700004 指定的用户不存在 + +### 错误信息 +The specified user id is not found. + +### 错误描述 +调用接口时，传入的用户不存在。 + +### 可能原因 +1. 输入的用户有误，系统中没有该用户 + +### 处理步骤 +1. 检查用户拼写是否有误 +2. 确认系统中存在该用户 + +## 17700005 指定的appId不存在 + +### 错误信息 +The specified appId is not found. + +### 错误描述 +调用接口时，传入的appId为空字符串。 + +### 可能原因 +1. 传入的appId为空字符串 + +### 处理步骤 +1. 检查appId拼写是否有误 + +## 17700006 查询的权限不存在 + +### 错误信息 +The specified permission is not found. + +### 错误描述 +调用接口时，传入的权限不存在。 + +### 可能原因 +1. 传入的permission名称拼写有误 +2. 系统中不存在对应的权限 + +### 处理步骤 +1. 检查permission拼写是否有误 +2. 确认系统中是否有该权限 + +## 17700007 输入的设备Id有误 + +### 错误信息 +The specified deviceId is not found. + +### 错误描述 +调用接口时，传入的设备id有误。 + +### 可能原因 +1. 传入的deviceId拼写有误 +2. deviceId不存在 + +### 处理步骤 +1. 检查deviceId拼写是否有误 +2. 确认deviceId是否存在 + +## 17700010 文件解析失败导致应用安装失败 + +### 错误信息 +Failed to install the hap since the hap fails to be parsed. + +### 错误描述 +文件解析失败导致应用安装失败 + +### 可能原因 +1. hap包的格式不是zip格式 +2. hap包的配置文件不满足json格式 +3. hap包的配置文件缺少必要的字段 + +### 处理步骤 +1. 确认hap的格式是zip +2. 确认hap的配置文件满足json格式 +3. 检查IDE编译hap时是否有错误提示，缺省字段时会有相应的报错。 + +## 17700011 签名校验失败失败导致应用安装失败 + +### 错误信息 +Failed to install the hap since the hap signature fails to be verified. + +### 错误描述 +签名校验失败失败导致应用安装失败 + +### 可能原因 +1. hap包没有签名 +2. hap签名信息来源不可靠 +3. 升级的hap包与已安装的hap包签名信息不一致 +4. 多个hap的签名信息不一致 + +### 处理步骤 +1. 确认hap是否签名成功 +2. 确认多个hap签名时使用的证书相同 +3. 确认升级的hap签名证书与已安装的hap相同 + +## 17700012 安装包路径无效导致应用安装失败 + +### 错误信息 +Failed to install the hap since the path of the hap is invalid. + +### 错误描述 +安装包路径无效导致应用安装失败 + +### 可能原因 +1. 输入错误，hap包的文件路径不存在 +2. hap包的路径无法访问 + +### 处理步骤 +1. 确认hap是否存在 +2. 查看hap的可执行权限，是否可读 + +## 17700013 应用包过大导致应用安装失败 + +### 错误信息 +Failed to install the hap since the hap is too large. + +### 错误描述 +应用包过大导致应用安装失败 + +### 可能原因 +1. hap包过大，一个hap不能超过4GB。 + +### 处理步骤 +1. 确认hap包的大小 + +## 17700014 应用包后缀有误导致应用安装失败 + +### 错误信息 +Failed to install the hap since the extension name of the hap is not .hap. + +### 错误描述 +应用包后缀有误导致应用安装失败 + +### 可能原因 +1. hap包的文件后缀名不为.hap + +### 处理步骤 +1. 确认hap包的后缀是否为.hap + +## 17700015 多个hap包配置信息不同导致应用安装失败 + +### 错误信息 +Failed to install haps since the configuration information of multi haps is inconsistent. + +### 错误描述 +多个hap包配置信息不同导致应用安装失败。 + +### 可能原因 +1. 多个hap包中配置文件app下面的字段不一致 + +### 处理步骤 +1. 确认多个hap包中配置文件app下面的字段是否一致 + +## 17700016 系统磁盘空间不足导致应用安装失败 + +### 错误信息 +Failed to install the hap since the system disk space is insufficient. + +### 错误描述 +系统磁盘空间不足导致应用安装失败 + +### 可能原因 +1. 系统空间不足 + +### 处理步骤 +1. 确认系统是否有多余的空间 + +## 17700017 新安装的应用版本号过低导致应用安装失败 + +### 错误信息 +Failed to install the hap since the version of the newly installed hap is too early. + +### 错误描述 +新安装的应用版本号过低导致应用安装失败。 + +### 可能原因 +1. 新安装的应用版本号过低 + +### 处理步骤 +1. 确认新安装的应用版本号是否比已安装的同应用版本号高 + +## 17700020 预置应用无法卸载 + +### 错误信息 +The preinstalled app cannot be uninstalled. + +### 错误描述 +预置应用无法卸载。 + +### 可能原因 +1. 传入的bundleName是否拼写有误 +2. 对应的预置应用无法卸载 + +### 处理步骤 +1. 确认对应的预置应用是否可卸载 + +## 17700021 指定的uid无效 + +### 错误信息 +The specified uid is invalid. + +### 错误描述 +指定的uid无效 + +### 可能原因 +1. 传入的uid拼写有误 +2. 传入的uid在系统中不存在 + +### 处理步骤 +1. 检查uid的拼写 +2. 检查系统中是否存在该uid + +## 17700022 输入的待解析源文件无效 + +### 错误信息 +The input source file is invalid. + +### 错误描述 +输入的待解析源文件无效 + +### 可能原因 +1. 待解析的源文件不存在 +2. 待解析的源文件不符合zip格式 + +### 处理步骤 +1. 确认待解析的源文件是否存在 +2. 确认待解析的源文件符合zip格式 + +## 17700023 指定的默认应用不存在 + +### 错误信息 +The specified default app does not exist. + +### 错误描述 +指定的默认应用不存在 + +### 可能原因 +1. 设备没有设置对应的默认应用 + +### 处理步骤 +1. 确认设备是否设置了对应的默认应用 + +## 17700024 没有相应的配置文件 + +### 错误信息 +Failed to get profile since no profile in the hap. + +### 错误描述 +没有相应的配置文件 + +### 可能原因 +1. 输入的metadata name在配置文件中不存在 +2. 配置文件的内容不是json格式 + +### 处理步骤 +1. 确认要查询的ability或者extensionAbility中的metadata name是否存在 +2. 确认指定查询的profile文件的内容是否为json格式 + +## 17700025 输入的type无效 + +### 错误信息 +The specified type is invalid. + +### 错误描述 +输入的type无效 + +### 可能原因 +1. 输入的type拼写有误 +2. 输入的type不存在 + +### 处理步骤 +1. 确认输入的type是否拼写正确 + +## 17700026 指定应用被禁用 + +### 错误信息 +The specified bundle is disabled. + +### 错误描述 +指定应用被禁用 + +### 可能原因 +1. 设备上对应的应用已经被禁用，无法查询 + +### 处理步骤 +1. 确认设备上对应的应用是否被禁用 + +## 17700027 分布式服务未启动 + +### 错误信息 +The distributed service is not running. + +### 错误描述 +分布式服务未启动 + +### 可能原因 +1. 设备未组网 + +### 处理步骤 +1. 确认设备是否组网成功 + +## 17700027 分布式服务未启动 + +### 错误信息 +The distributed service is not running. + +### 错误描述 +分布式服务未启动 + +### 可能原因 +1. 设备未组网 + +### 处理步骤 +1. 确认设备是否组网成功 + +## 17700028 输入的ability与type不匹配 + +### 错误信息 +The distributed service is not running. + +### 错误描述 +输入的ability与type不匹配 + +### 可能原因 +1. 输入的ability和type拼写有误 + +### 处理步骤 +1. 确认输入的ability和type拼写是否有误 + +## 900001 输入待压缩的源文件或目录无效 + +### 错误信息 +The input source file is invalid. + +### 错误描述 +输入待压缩的源文件或目录无效 + +### 可能原因 +1. 输入的路径不存在 + +### 处理步骤 +1. 确认输入的路径是否存在 + +## 900002 输入压缩的目的文件无效 + +### 错误信息 +The input source file is invalid. + +### 错误描述 +输入压缩的目的文件无效 + +### 可能原因 +1. 输入压缩的目的文件无效 +2. 输入压缩的目的文件已存在 + +### 处理步骤 +1. 确认输入压缩的目的文件无效 +2. 确认输入压缩的目的文件是否已存在