HarmonyOS 鸿蒙Next中在云调试中应用无法安装，报错：9568305

HarmonyOS 鸿蒙Next中在云调试中应用无法安装，报错：9568305 安装失败，错误提示：error: failed to install bundle. code:9568305 error: Failed to install the HAP or HSP because the dependent module does not exist. default’s dependent module: common does not exist。

提示我common模块不存在，可是我的项目级oh-package.json中已经引入了正确的dependencies。cke_3134.png

包名是正确的。oh_modules中也有。为什么会提示依赖模块不存在呢？


更多关于HarmonyOS 鸿蒙Next中在云调试中应用无法安装，报错：9568305的实战教程也可以访问 https://www.itying.com/category-93-b0.html

5 回复

【背景知识】 动态共享包HSP可以实现在应用/元服务开发过程中部分功能按需动态下载，有助于提升应用性能，共享库使用时需要配置相关依赖dependencies。

【问题定位】 在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: dependent module does not exist”错误信息，依赖的模块不存在，根据错误信息日志判断是模块未安装导致的问题。

【分析结论】 运行/调试的应用依赖的动态共享包（SharedLibrary）模块未安装导致安装报错，如果一个工程中同一个设备存在多个模块（如存在entry和feature模块），且存在模块间的调用时，在调试阶段需要同时安装多个模块的Hap包到设备中。

【修改建议】 在Deploy Multi Hap中选择多个模块，启动调试时，DevEco Studio会将所有的模块都安装到设备上，设置方法如下：单击Run->Edit Configurations，在Deploy Multi Hap中，勾选Deploy Multi Hap Packages，选择多个模块

更多关于HarmonyOS 鸿蒙Next中在云调试中应用无法安装，报错：9568305的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


【错误原因】

在启动调试或运行应用/服务时，安装HAP出现错误，提示“error: dependent module does not exist”错误信息,这是因为存在分包构建安装时没有被勾选，运行/调试的应用依赖的动态共享包（SharedLibrary）模块未安装导致安装报错。

【处理步骤】

  1. 先安装依赖的动态共享包（SharedLibrary）模块，再在应用运行配置页勾选Keep Application Data，点击OK保存配置，再运行/调试。

    图片

  2. 在运行配置页，选择Deploy Multi Hap标签页，勾选Deploy Multi Hap Packages，选择依赖的模块，点击OK保存配置，再进行运行/调试。

    图片

  3. 单击Run > Edit Configurations，在General中，勾选Auto Dependencies。点击OK保存配置，再运行/调试。

    图片

参考文档：bm工具-调试命令-调测调优-系统 - 华为HarmonyOS开发者

云调试中遇到HAP安装失败报错9568305可能是依赖未正确安装

删除oh_modules文件夹和build构建缓存，执行以下命令重新安装依赖：

ohpm install

检查oh-package.json中common模块的版本号是否与远程仓库最新版本匹配

示例：

"dependencies": {

  "@ohos/common": "^2.1.0"  // 需确认版本号正确性

}

鸿蒙Next云调试中应用安装报错9568305通常与签名验证相关。该错误表明应用的签名信息与云端环境不匹配，可能由于调试证书未正确配置或应用未使用华为官方要求的签名方式。请检查项目的签名配置是否遵循鸿蒙Next的签名规范，并确认云调试环境已正确关联企业开发者账号。

根据错误提示9568305，安装失败是因为依赖模块common不存在。虽然您确认了oh-package.json中已正确引入依赖且oh_modules目录中存在对应模块，但可能的原因包括：

  1. 依赖版本不匹配：检查common模块的版本是否与项目要求的版本一致。在oh-package.json中确认依赖的版本号，并确保与远程仓库或本地路径匹配。

  2. 模块未正确安装或同步：尝试删除oh_modules目录并重新运行ohpm install，确保所有依赖被完整下载和链接。

  3. 云调试环境问题：云调试环境可能未能正确同步或解析依赖。检查云调试平台是否支持所有依赖模块，并确认网络连接正常。

  4. HAP/HSP构建配置：确认模块的bundleName和moduleName在模块配置文件中的定义是否一致，避免命名冲突或路径错误。

建议重新验证依赖配置和云环境同步状态，以解决此问题。

回到顶部