提交 f8c59fc7 编写于 作者: W wangtiantian

IssueNo:#I5V96P

Description:add distributed doc
Sig:SIG_ApplicaitonFramework
Feature or Bugfix:Feature
Binary Source:No
Signed-off-by: Nwangtiantian <wangtiantian19@huawei.com>
上级 06eb9cec
...@@ -24,7 +24,9 @@ SystemCapability.BundleManager.DistributedBundleFramework ...@@ -24,7 +24,9 @@ SystemCapability.BundleManager.DistributedBundleFramework
权限等级参考[权限等级说明](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) 权限等级参考[权限等级说明](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 ## distributedBundle.getRemoteAbilityInfo<sup>deprecated<sup>
> 从API version 9开始不再维护,建议使用[getRemoteAbilityInfo](js-apis-distributedBundle.md)替代。
getRemoteAbilityInfo(elementName: ElementName, callback: AsyncCallback&lt;RemoteAbilityInfo&gt;): void; getRemoteAbilityInfo(elementName: ElementName, callback: AsyncCallback&lt;RemoteAbilityInfo&gt;): void;
...@@ -51,7 +53,9 @@ SystemCapability.BundleManager.DistributedBundleFramework ...@@ -51,7 +53,9 @@ SystemCapability.BundleManager.DistributedBundleFramework
## distributedBundle.getRemoteAbilityInfo ## distributedBundle.getRemoteAbilityInfo<sup>deprecated<sup>
> 从API version 9开始不再维护,建议使用[getRemoteAbilityInfo](js-apis-distributedBundle.md)替代。
getRemoteAbilityInfo(elementName: ElementName): Promise&lt;RemoteAbilityInfo&gt; getRemoteAbilityInfo(elementName: ElementName): Promise&lt;RemoteAbilityInfo&gt;
...@@ -81,7 +85,9 @@ SystemCapability.BundleManager.DistributedBundleFramework ...@@ -81,7 +85,9 @@ SystemCapability.BundleManager.DistributedBundleFramework
| ------------------------------------------------------------ | --------------------------------- | | ------------------------------------------------------------ | --------------------------------- |
| Promise\<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo.md)> | Promise形式返回远程基本能力信息。 | | Promise\<[RemoteAbilityInfo](js-apis-bundle-remoteAbilityInfo.md)> | Promise形式返回远程基本能力信息。 |
## distributedBundle.getRemoteAbilityInfos ## distributedBundle.getRemoteAbilityInfos<sup>deprecated<sup>
> 从API version 9开始不再维护,建议使用[getRemoteAbilityInfo](js-apis-distributedBundle.md)替代。
getRemoteAbilityInfos(elementNames: Array&lt;ElementName&gt;, callback: AsyncCallback&lt;Array&lt;RemoteAbilityInfo&gt;&gt;): void; getRemoteAbilityInfos(elementNames: Array&lt;ElementName&gt;, callback: AsyncCallback&lt;Array&lt;RemoteAbilityInfo&gt;&gt;): void;
...@@ -108,7 +114,9 @@ SystemCapability.BundleManager.DistributedBundleFramework ...@@ -108,7 +114,9 @@ SystemCapability.BundleManager.DistributedBundleFramework
## distributedBundle.getRemoteAbilityInfos ## distributedBundle.getRemoteAbilityInfos<sup>deprecated<sup>
> 从API version 9开始不再维护,建议使用[getRemoteAbilityInfo](js-apis-distributedBundle.md)替代。
getRemoteAbilityInfos(elementNames: Array&lt;ElementName&gt;): Promise&lt;Array&lt;RemoteAbilityInfo&gt;&gt; getRemoteAbilityInfos(elementNames: Array&lt;ElementName&gt;): Promise&lt;Array&lt;RemoteAbilityInfo&gt;&gt;
......
# RemoteAbilityInfo # RemoteAbilityInfo
包含基本远程能力信息,通过接口[distributedBundle.getRemoteAbilityInfo](js-apis-distributedBundle.md)获取。 包含远程的ability信息,通过接口[distributedBundle.getRemoteAbilityInfo](js-apis-distributedBundle.md)获取。
> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:** > ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 > 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
...@@ -15,6 +15,6 @@ ...@@ -15,6 +15,6 @@
| 名称 | 类型 | 可读 | 可写 | 说明 | | 名称 | 类型 | 可读 | 可写 | 说明 |
| ----------- | -------------------------------------------- | ---- | ---- | ----------------------- | | ----------- | -------------------------------------------- | ---- | ---- | ----------------------- |
| elementName | [ElementName](js-apis-bundleManager-elementName.md) | 是 | 否 | 指明ability的ElementName信息 | | elementName | [ElementName](js-apis-bundleManager-elementName.md) | 是 | 否 | 指明远程ability的ElementName信息 |
| label | string | 是 | 否 | 指明ability的标签信息 | | label | string | 是 | 否 | 指明远程ability的标签信息 |
| icon | string | 是 | 否 | 指明的ability的图标信息 | | icon | string | 是 | 否 | 指明的远程ability的图标信息 |
# 包管理子系统通用错误码 # 包管理子系统通用错误码
## 201 权限校验失败
### 错误信息
Permission denied.
### 可能原因
1. 调用目标接口时,未申请权限。
2. 非会话请求方和响应方查询会话信息。
### 处理步骤
1. 请申请相应接口要求的权限。
2. 请取消非法查询,使用会话请求方和响应方查询会话信息。
## 401 参数检查失败
### 错误信息
Parameter check failed.
### 可能原因
1. 必选参数没有传入,参数类型错误。
### 处理步骤
1. 请按照参数类型、位置,传入合法的参数。
## 801 API不支持
### 错误信息
Capability not supported.
### 可能原因
暂无
### 处理步骤
1. 取消调用和调用替代接口。
## 17700001 指定的bundleName不存在 ## 17700001 指定的bundleName不存在
### 错误信息 **错误信息**<br/>
The specified bundle name is not found. The specified bundle name is not found.
### 错误描述 **错误描述**<br/>
调用接口时,传入的bundleName不存在。 调用接口时,传入的bundleName不存在。
### 可能原因 **可能原因**<br/>
1. 输入的bundleName有误 1. 输入的bundleName有误
2. 系统中对应的应用没有安装 2. 系统中对应的应用没有安装
### 处理步骤 **处理步骤**<br/>
1. 检查bundleName拼写是否有误 1. 检查bundleName拼写是否正确。
2. 确认对应的应用是否安装 2. 确认对应的应用是否安装
## 17700002 指定的moduleName不存在 ## 17700002 指定的moduleName不存在
### 错误信息 **错误信息**<br/>
The specified module name is not found. The specified module name is not found.
### 错误描述 **错误描述**<br/>
调用接口时,传入的moduleName不存在。 调用接口时,传入的moduleName不存在。
### 可能原因 **可能原因**<br/>
1. 输入的moduleName有误 1. 输入的moduleName有误
2. 系统中对应的应用没有安装该模块 2. 系统中对应的应用没有安装该模块
### 处理步骤 **处理步骤**<br/>
1. 检查bundleName拼写是否有误 1. 检查bundleName拼写是否正确。
2. 确认对应的应用是否安装该模块 2. 确认对应的应用是否安装该模块
## 17700003 指定的abilityName不存在 ## 17700003 指定的abilityName不存在
### 错误信息 **错误信息**<br/>
The specified ability name is not found. The specified ability name is not found.
### 错误描述 **错误描述**<br/>
调用接口时,传入的abilityName不存在。 调用接口时,传入的abilityName不存在。
### 可能原因 **可能原因**<br/>
1. 输入的abilityName有误 1. 输入的abilityName有误
2. 系统中对应的应用没有安装 2. 系统中对应的应用没有安装
### 处理步骤 **处理步骤**<br/>
1. 检查abilityName拼写是否有误 1. 检查abilityName拼写是否正确。
2. 确认对应的应用是否安装该模块 2. 确认对应的应用是否安装该模块
## 17700004 指定的用户不存在 ## 17700004 指定的用户不存在
### 错误信息 **错误信息**<br/>
The specified user id is not found. The specified user id is not found.
### 错误描述 **错误描述**<br/>
调用接口时,传入的用户不存在。 调用接口时,传入的用户不存在。
### 可能原因 **可能原因**<br/>
1. 输入的用户有误,系统中没有该用户 输入的用户名有误,系统中没有该用户。
### 处理步骤 **处理步骤**<br/>
1. 检查用户拼写是否有误 1. 检查用户名拼写是否正确。
2. 确认系统中存在该用户 2. 确认系统中存在该用户
## 17700005 指定的appId不存在 ## 17700005 指定的appId不存在
### 错误信息 **错误信息**<br/>
The specified appId is not found. The specified appId is not found.
### 错误描述 **错误描述**<br/>
调用接口时,传入的appId为空字符串。 调用接口时,传入的appId为空字符串。
### 可能原因 **可能原因**<br/>
1. 传入的appId为空字符串 传入的appId为空字符串。
### 处理步骤 **处理步骤**<br/>
1. 检查appId拼写是否有误 检查appId是否为空字符串。
## 17700006 查询的权限不存在 ## 17700006 查询的权限不存在
### 错误信息 **错误信息**<br/>
The specified permission is not found. The specified permission is not found.
### 错误描述 **错误描述**<br/>
调用接口时,传入的权限不存在。 调用接口时,传入的权限不存在。
### 可能原因 **可能原因**<br/>
1. 传入的permission名称拼写有误 1. 传入的permission名称拼写有误
2. 系统中不存在对应的权限 2. 系统中不存在对应的权限
### 处理步骤 **处理步骤**<br/>
1. 检查permission拼写是否有误 1. 检查permission拼写是否正确。
2. 确认系统中是否有该权限 2. 确认系统中是否有该权限
## 17700007 输入的设备Id有误 ## 17700007 输入的设备Id有误
### 错误信息 **错误信息**<br/>
The specified deviceId is not found. The specified deviceId is not found.
### 错误描述 **错误描述**<br/>
调用接口时,传入的设备id有误。 调用接口时,传入的设备id有误。
### 可能原因 **可能原因**<br/>
1. 传入的deviceId拼写有误 1. 传入的deviceId拼写有误
2. deviceId不存在 2. deviceId不存在
### 处理步骤 **处理步骤**<br/>
1. 检查deviceId拼写是否有误 1. 检查deviceId拼写是否正确。
2. 确认deviceId是否存在 2. 确认deviceId是否存在
## 17700010 文件解析失败导致应用安装失败 ## 17700010 文件解析失败导致应用安装失败
### 错误信息 **错误信息**<br/>
Failed to install the hap since the hap fails to be parsed. Failed to install the hap since the hap fails to be parsed.
### 错误描述 **错误描述**<br/>
文件解析失败导致应用安装失败 文件解析失败导致应用安装失败
### 可能原因 **可能原因**<br/>
1. hap包的格式不是zip格式 1. hap包的格式不是zip格式
2. hap包的配置文件不满足json格式 2. hap包的配置文件不满足json格式
3. hap包的配置文件缺少必要的字段 3. hap包的配置文件缺少必要的字段
### 处理步骤 **处理步骤**<br/>
1. 确认hap的格式是zip 1. 确认hap的格式是zip
2. 确认hap的配置文件满足json格式 2. 确认hap的配置文件满足[配置文件json格式](../../quick-start/stage-structure.md)
3. 检查IDE编译hap时是否有错误提示,缺省字段时会有相应的报错。 3. 检查DevEco Studio编译hap时是否有错误提示,缺省字段时会有相应的报错。
## 17700011 签名校验失败失败导致应用安装失败 ## 17700011 签名校验失败失败导致应用安装失败
### 错误信息 **错误信息**<br/>
Failed to install the hap since the hap signature fails to be verified. Failed to install the hap since the hap signature fails to be verified.
### 错误描述 **错误描述**<br/>
签名校验失败失败导致应用安装失败 签名校验失败失败导致应用安装失败
### 可能原因 **可能原因**<br/>
1. hap包没有签名 1. hap包没有签名
2. hap签名信息来源不可靠 2. hap签名信息来源不可靠
3. 升级的hap包与已安装的hap包签名信息不一致 3. 升级的hap包与已安装的hap包签名信息不一致
4. 多个hap的签名信息不一致 4. 多个hap的签名信息不一致
### 处理步骤 **处理步骤**<br/>
1. 确认hap是否签名成功 1. 确认hap是否签名成功
2. 确认多个hap签名时使用的证书相同 2. 确认多个hap签名时使用的证书相同
3. 确认升级的hap签名证书与已安装的hap相同 3. 确认升级的hap签名证书与已安装的hap相同
## 17700012 安装包路径无效导致应用安装失败 ## 17700012 安装包路径无效导致应用安装失败
### 错误信息 **错误信息**<br/>
Failed to install the hap since the path of the hap is invalid. Failed to install the hap since the path of the hap is invalid.
### 错误描述 **错误描述**<br/>
安装包路径无效导致应用安装失败 安装包路径无效导致应用安装失败
### 可能原因 **可能原因**<br/>
1. 输入错误,hap包的文件路径不存在 1. 输入错误,hap包的文件路径不存在
2. hap包的路径无法访问 2. hap包的路径无法访问
### 处理步骤 **处理步骤**<br/>
1. 确认hap是否存在 1. 确认hap是否存在
2. 查看hap的可执行权限,是否可读 2. 查看hap的可执行权限,是否可读
## 17700013 应用包过大导致应用安装失败 ## 17700013 应用包过大导致应用安装失败
### 错误信息 **错误信息**<br/>
Failed to install the hap since the hap is too large. Failed to install the hap since the hap is too large.
### 错误描述 **错误描述**<br/>
应用包过大导致应用安装失败 应用包过大导致应用安装失败
### 可能原因 **可能原因**<br/>
1. hap包过大,一个hap不能超过4GB。 hap包过大,一个hap不能超过4GB。
### 处理步骤 **处理步骤**<br/>
1. 确认hap包的大小 确认hap包的大小。
## 17700014 应用包后缀有误导致应用安装失败 ## 17700014 应用包后缀有误导致应用安装失败
### 错误信息 **错误信息**<br/>
Failed to install the hap since the extension name of the hap is not .hap. Failed to install the hap since the extension name of the hap is not .hap.
### 错误描述 **错误描述**<br/>
应用包后缀有误导致应用安装失败 应用包后缀有误导致应用安装失败
### 可能原因 **可能原因**<br/>
1. hap包的文件后缀名不为.hap hap包的文件后缀名不为.hap。
### 处理步骤 **处理步骤**<br/>
1. 确认hap包的后缀是否为.hap 确认hap包的后缀是否为.hap。
## 17700015 多个hap包配置信息不同导致应用安装失败 ## 17700015 多个hap包配置信息不同导致应用安装失败
### 错误信息 **错误信息**<br/>
Failed to install haps since the configuration information of multi haps is inconsistent. Failed to install haps since the configuration information of multi haps is inconsistent.
### 错误描述 **错误描述**<br/>
多个hap包配置信息不同导致应用安装失败。 多个hap包配置信息不同导致应用安装失败。
### 可能原因 **可能原因**<br/>
1. 多个hap包中配置文件app下面的字段不一致 多个hap包中配置文件app下面的字段不一致。
### 处理步骤 **处理步骤**<br/>
1. 确认多个hap包中配置文件app下面的字段是否一致 确认多个hap包中配置文件app下面的字段是否一致。
## 17700016 系统磁盘空间不足导致应用安装失败 ## 17700016 系统磁盘空间不足导致应用安装失败
### 错误信息 **错误信息**<br/>
Failed to install the hap since the system disk space is insufficient. Failed to install the hap since the system disk space is insufficient.
### 错误描述 **错误描述**<br/>
系统磁盘空间不足导致应用安装失败 系统磁盘空间不足导致应用安装失败
### 可能原因 **可能原因**<br/>
1. 系统空间不足 系统空间不足。
### 处理步骤 **处理步骤**<br/>
1. 确认系统是否有多余的空间 确认系统是否有足够的空间。
## 17700017 新安装的应用版本号过低导致应用安装失败 ## 17700017 新安装的应用版本号低于已安装的版本号导致应用安装失败
### 错误信息 **错误信息**<br/>
Failed to install the hap since the version of the newly installed hap is too early. Failed to install the hap since the version of the newly installed hap is too early.
### 错误描述 **错误描述**<br/>
新安装的应用版本号过低导致应用安装失败。 新安装的应用版本号低于已安装的版本号导致应用安装失败。
### 可能原因 **可能原因**<br/>
1. 新安装的应用版本号过低 新安装的应用版本号低于已安装的版本号。
### 处理步骤 **处理步骤**<br/>
1. 确认新安装的应用版本号是否比已安装的同应用版本号高 确认新安装的应用版本号是否比已安装的同应用版本号高。
## 17700020 预置应用无法卸载 ## 17700020 预置应用无法卸载
### 错误信息 **错误信息**<br/>
The preinstalled app cannot be uninstalled. The preinstalled app cannot be uninstalled.
### 错误描述 **错误描述**<br/>
预置应用无法卸载。 预置应用无法卸载。
### 可能原因 **可能原因**<br/>
1. 传入的bundleName是否拼写有误 1. 传入的bundleName拼写有误。
2. 对应的预置应用无法卸载 2. 对应的预置应用无法卸载
### 处理步骤 **处理步骤**<br/>
1. 确认对应的预置应用是否可卸载 1. 确认bundleName是否拼写正确。
1. 确认对应的预置应用是否可卸载。
## 17700021 指定的uid无效 ## 17700021 指定的uid无效
### 错误信息 **错误信息**<br/>
The specified uid is invalid. The specified uid is invalid.
### 错误描述 **错误描述**<br/>
指定的uid无效 指定的uid无效
### 可能原因 **可能原因**<br/>
1. 传入的uid拼写有误 1. 传入的uid拼写有误
2. 传入的uid在系统中不存在 2. 传入的uid在系统中不存在
### 处理步骤 **处理步骤**<br/>
1. 检查uid的拼写 1. 检查uid的拼写
2. 检查系统中是否存在该uid 2. 检查系统中是否存在该uid
## 17700022 输入的待解析源文件无效 ## 17700022 输入的待解析源文件无效
### 错误信息 **错误信息**<br/>
The input source file is invalid. The input source file is invalid.
### 错误描述 **错误描述**<br/>
输入的待解析源文件无效 输入的待解析源文件无效
### 可能原因 **可能原因**<br/>
1. 待解析的源文件不存在 1. 待解析的源文件不存在
2. 待解析的源文件不符合zip格式 2. 待解析的源文件不符合zip格式
### 处理步骤 **处理步骤**<br/>
1. 确认待解析的源文件是否存在 1. 确认待解析的源文件是否存在
2. 确认待解析的源文件符合zip格式 2. 确认待解析的源文件符合zip格式
## 17700023 指定的默认应用不存在 ## 17700023 指定的默认应用不存在
### 错误信息 **错误信息**<br/>
The specified default app does not exist. The specified default app does not exist.
### 错误描述 **错误描述**<br/>
指定的默认应用不存在 指定的默认应用不存在
### 可能原因 **可能原因**<br/>
1. 设备没有设置对应的默认应用 设备没有设置对应的默认应用。
### 处理步骤 **处理步骤**<br/>
1. 确认设备是否设置了对应的默认应用 确认设备是否设置了对应的默认应用。
## 17700024 没有相应的配置文件 ## 17700024 没有相应的配置文件
### 错误信息 **错误信息**<br/>
Failed to get profile since no profile in the hap. Failed to get profile since no profile in the hap.
### 错误描述 **错误描述**<br/>
没有相应的配置文件 没有相应的配置文件
### 可能原因 **可能原因**<br/>
1. 输入的metadata name在配置文件中不存在 1. 输入的metadata name在配置文件中不存在
2. 配置文件的内容不是json格式 2. 配置文件的内容不是json格式
### 处理步骤 **处理步骤**<br/>
1. 确认要查询的ability或者extensionAbility中的metadata name是否存在 1. 确认要查询的ability或者extensionAbility中的metadata name是否存在
2. 确认指定查询的profile文件的内容是否为json格式 2. 确认指定查询的profile文件的内容是否为json格式
## 17700025 输入的type无效 ## 17700025 输入的type无效
### 错误信息 **错误信息**<br/>
The specified type is invalid. The specified type is invalid.
### 错误描述 **错误描述**<br/>
输入的type无效 输入的type无效
### 可能原因 **可能原因**<br/>
1. 输入的type拼写有误 1. 输入的type拼写有误
2. 输入的type不存在 2. 输入的type不存在
### 处理步骤 **处理步骤**<br/>
1. 确认输入的type是否拼写正确 确认输入的type是否拼写正确。
## 17700026 指定应用被禁用 ## 17700026 指定应用被禁用
### 错误信息 **错误信息**<br/>
The specified bundle is disabled. The specified bundle is disabled.
### 错误描述 **错误描述**<br/>
指定应用被禁用 指定应用被禁用。
### 可能原因
1. 设备上对应的应用已经被禁用,无法查询
### 处理步骤
1. 确认设备上对应的应用是否被禁用
## 17700027 分布式服务未启动
### 错误信息
The distributed service is not running.
### 错误描述
分布式服务未启动
### 可能原因 **可能原因**<br/>
1. 设备未组网 设备上对应的应用已经被禁用,无法查询。
### 处理步骤 **处理步骤**<br/>
1. 确认设备是否组网成功 确认设备上对应的应用是否被禁用。
## 17700027 分布式服务未启动 ## 17700027 分布式服务未启动
### 错误信息 **错误信息**<br/>
The distributed service is not running. The distributed service is not running.
### 错误描述 **错误描述**<br/>
分布式服务未启动 分布式服务未启动。
### 可能原因
1. 设备未组网
### 处理步骤 **可能原因**<br/>
1. 确认设备是否组网成功 设备未组网。
**处理步骤**<br/>
确认设备是否组网成功。
## 17700028 输入的ability与type不匹配 ## 17700028 输入的ability与type不匹配
### 错误信息 **错误信息**<br/>
The distributed service is not running. The distributed service is not running.
### 错误描述 **错误描述**<br/>
输入的ability与type不匹配 输入的ability与type不匹配。
### 可能原因
1. 输入的ability和type拼写有误
### 处理步骤
1. 确认输入的ability和type拼写是否有误
## 900001 输入待压缩的源文件或目录无效
### 错误信息
The input source file is invalid.
### 错误描述
输入待压缩的源文件或目录无效
### 可能原因
1. 输入的路径不存在
### 处理步骤
1. 确认输入的路径是否存在
## 900002 输入压缩的目的文件无效
### 错误信息
The input source file is invalid.
### 错误描述
输入压缩的目的文件无效
### 可能原因 **可能原因**<br/>
1. 输入压缩的目的文件无效 输入的ability和type拼写有误。
2. 输入压缩的目的文件已存在
### 处理步骤 **处理步骤**<br/>
1. 确认输入压缩的目的文件无效 确认输入的ability和type拼写是否正确。
2. 确认输入压缩的目的文件是否已存在
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册