依赖管理基础

鸿蒙应用开发中，依赖管理通过oh-package.json5文件实现。该文件定义了项目所需的模块和库，支持本地路径、远程仓库或三方库引用。关键字段包括dependencies（运行时依赖）和devDependencies（开发环境依赖）。以下是一个基础示例：

{
  "dependencies": {
    "@ohos/lodash": "^4.17.21",
    "@ohos/network": "file:./local_modules/network"
  }
}

版本控制策略

采用语义化版本（SemVer）规范：主版本号.次版本号.修订号。

• 固定版本：明确指定版本号（如1.2.3），避免意外更新。
• 范围版本：使用^1.2.3允许次版本和修订号更新，~1.2.3仅允许修订号更新。
• 最新版本：慎用latest，可能导致兼容性问题。

依赖冲突解决

当多个模块依赖同一库的不同版本时，可通过resolutions字段强制指定版本（需工具链支持）。若冲突无法自动解决，需手动调整依赖树或联系库作者升级兼容版本。

本地调试技巧

开发阶段可使用npm link或直接引用本地路径：

{
  "dependencies": {
    "local-module": "file:../path/to/module"
  }
}

修改后执行npm install --force重新链接依赖。

持续集成优化

在CI/CD流程中，利用缓存加速依赖安装：

# 缓存HarmonyOS SDK和依赖
cache:
  paths:
    - $HOME/.ohpm/cache
    - $HOME/.local/share/hpm

配置.ohpmignore文件排除非必要文件（如测试代码、文档），减少打包体积。

常见问题排查

• 依赖安装失败：检查网络代理或镜像源（如华为镜像），清理缓存后重试。
• 运行时缺失模块：确认oh-package.json5和module.json5中声明的依赖一致。
• 版本漂移：定期执行ohpm audit检查依赖安全性，使用ohpm outdated查看可升级版本。