利用Jenkins实现鸿蒙HAR应用的自动化构建打包

打印 上一主题 下一主题

主题 994|帖子 994|积分 2982

利用Jenkins实现鸿蒙HAR应用的自动化构建打包

在软件开发范畴,自动化构建是提高开发服从和确保代码质量的重要本领。特殊是在鸿蒙(OpenHarmony)应用开发中,自动化构建更是不可或缺。本文将详细先容怎样利用Jenkins命令行工具实现鸿蒙HAR应用的自动化构建打包,让开发流程更加高效、可靠。
一、引言

随着鸿蒙系统的广泛应用,越来越多的开发者投入到鸿蒙应用的开发中。然而,手动构建和打包应用不但耗时耗力,还容易出错。因此,实现自动化构建成为开发者的迫切需求。Jenkins作为一款开源的自动化服务器软件,以其强盛的功能和灵活的插件体系,成为实现这一需求的理想选择。
二、环境准备

在开始之前,请确保你已经安装了以下软件和环境:


  • Jenkins:用于自动化构建的使命调度和实行。
  • DevEco Studio:鸿蒙开发的集成开发环境(IDE),包含了须要的工具和SDK。
  • Node.js:JavaScript运行环境,用于实行hvigorw等脚本。
三、焦点步调

实现鸿蒙HAR应用的自动化构建打包,焦点在于以下三个步调:初始化依赖、初始化工作环境、实行详细的构建使命。下面将详细先容每个步调的详细实现。
1. 初始化依赖

首先,须要利用ohpm命令来初始化项目所需的依赖。ohpm是鸿蒙的包管理工具,类似于npm或yarn。在Jenkins脚本中,可以利用以下命令来安装所有依赖:
  1. /Applications/DevEco-Studio.app/Contents/tools/ohpm/bin/ohpm install --all --registry https://ohpm.openharmony.cn/ohpm/ --strict_ssl true
复制代码
这条命令会从指定的ohpm堆栈(https://ohpm.openharmony.cn/ohpm/)下载并安装所有在oh-package.json5中声明的依赖。
2. 初始化工作环境

接下来,利用hvigorw脚本来初始化工作环境。hvigorw是鸿蒙的构建工具,用于实行构建、编译等使命。在Jenkins脚本中,可以利用以下命令来同步项目配置并初始化工作环境:
  1. /Applications/DevEco-Studio.app/Contents/tools/node/bin/node
  2. /Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw.js
  3. --sync
  4. -p product=default
  5. --analyze=normal
  6. --parallel
  7. --incremental
  8. --daemon
复制代码
这条命令会同步项目的配置信息,并根据指定的产品配置(product=default)初始化工作环境。同时,它还会开启并行构建、增量构建和保卫进程等功能,以提高构建服从。
3. 实行详细的构建使命

最后,利用hvigorw脚本来实行详细的构建使命。在Jenkins脚本中,可以利用以下命令来构建并打包HAR应用:
  1. hvigorw --mode module -p product=default -p module=$moduleName@default -p buildMode=release assembleHar --analyze=normal --parallel --incremental --daemon
复制代码
这条命令会根据指定的模块(module=$moduleName@default)和产品配置(product=default),以发布模式(buildMode=release)构建并打包HAR应用。同样地,它也开启了并行构建、增量构建和保卫进程等功能。
四、脚本实现

将上述三个步调解合到一个脚本中,就可以在Jenkins中实行完备的业务逻辑构建了。以下是一个示例脚本:
  1. #!/bin/bash# 设置DevEco Studio路径DEVECO_STUDIO_PATH="/Applications/DevEco-Studio.app/Contents/tools"# 初始化依赖${DEVECO_STUDIO_PATH}/ohpm/bin/ohpm install --all --registry https://ohpm.openharmony.cn/ohpm/ --strict_ssl true# 查抄依赖安装是否乐成if [ $? -ne 0 ]; then    echo "依赖安装失败"    exit 1fi# 初始化工作环境${DEVECO_STUDIO_PATH}/node/bin/node ${DEVECO_STUDIO_PATH}/hvigor/bin/hvigorw.js --sync -p product=default --analyze=normal --parallel --incremental --daemon# 查抄工作环境初始化是否乐成if [ $? -ne 0 ]; then    echo "工作环境初始化失败"    exit 1fi# 实行详细的构建使命hvigorw --mode module -p product=default -p module=$moduleName@default -p buildMode=release assembleHar --analyze=normal --parallel --incremental --daemon
  2. # 查抄构建使命是否乐成if [ $? -ne 0 ]; then    echo "构建使命失败"    exit 1fiecho "构建乐成"
复制代码
将这个脚本保存为build.sh,并在Jenkins中配置一个实行该脚本的构建使命,就可以实现鸿蒙HAR应用的自动化构建打包了。
五、总结与展望

通过本文的先容,我们相识了怎样利用Jenkins命令行工具实现鸿蒙HAR应用的自动化构建打包。这不但提高了开发服从,还确保了代码质量。将来,随着鸿蒙系统的不断发展和美满,自动化构建工具也将更加智能和高效。我们可以等待更多的自动化工具和插件出现,为鸿蒙应用开发提供更加便捷和高效的解决方案。
希望本文对大家有所帮助!如果你有任何疑问或发起,请随时在批评区留言。
附录一

在DevEco Studio启动或项目初始化过程中,实行以下命令:
  1. /Applications/DevEco-Studio.app/Contents/tools/ohpm/bin/ohpm install --all --registry https://ohpm.openharmony.cn/ohpm/ --strict_ssl true
复制代码
作用是为鸿蒙(HarmonyOS/OpenHarmony)项目安装或更新所有依赖包。以下是详细解析:

1. 命令的组成部门

参数/路径说明/Applications/DevEco-Studio.app/.../ohpm调用DevEco Studio内置的 ohpm(OpenHarmony Package Manager)工具,专用于管理鸿蒙生态的依赖包。install --all安装项目配置文件(如oh-package.json5)中界说的所有依赖项(包括dependencies和devDependencies)。--registry https://ohpm.openharmony.cn/ohpm/指定鸿蒙官方包堆栈作为依赖源,确保下载合法的鸿蒙组件。--strict_ssl true启用严酷的SSL证书验证,防止网络劫持或下载来源被篡改。
2. 该命令的典范场景

(1) 初始化项目时



  • 当首次打开项目或检测到oh_modules(依赖目录)缺失时,DevEco Studio会自动触发此命令,确保依赖完备。
  • 类似npm install或yarn install的作用,但针对鸿蒙生态的包管理。
(2) 更新依赖配置后



  • 如果修改了oh-package.json5文件(如添加/删除依赖项),手动实行此命令可同步依赖。
(3) 解决依赖冲突或缺失



  • 当编译失败并提示缺少模块或版本不兼容时,重新运行此命令可实验修复依赖树。

3. 关键留意事项

(1) 依赖源的合法性



  • 必须利用鸿蒙官方堆栈(https://ohpm.openharmony.cn/ohpm/)以确保依赖包与鸿蒙系统兼容。
  • 不要随意切换第三方堆栈,否则可能引入非鸿蒙适配的代码,导致编译失败。
(2) --strict_ssl true的作用



  • 若本地网络有SSL证书拦截(如公司代理),可能须要临时关闭此参数(设为false),但会降低安全性。
  • 保举优先配置系统信任的证书,而非禁用SSL验证。
(3) 与npm的区别



  • ohpm是鸿蒙专用的包管理器,与Node.js的npm无直接关系。
  • 鸿蒙的Native模块(如C++库)和HAR/HSP包必须通过ohpm管理,无法利用npm替代。

4. 常见题目

Q1: 能否省略此命令?



  • 。除非项目无任何依赖项,否则缺少依赖会导致编译失败(如ERROR: ENOENT: no such file)。
Q2: 实行失败怎么办?



  • 步调1:查抄网络
    确保能访问https://ohpm.openharmony.cn,尤其留意代理或防火墙设置。
  • 步调2:清理缓存
    1. rm -rf ./oh_modules  # 删除依赖目录
    2. ohpm clean           # 清理ohpm缓存
    复制代码
  • 步调3:手动指定环境
    若系统全局安装了其他Node.js版本,可能路径冲突,应直接利用DevEco Studio内置的ohpm和Node.js。

5. 总结

此命令是鸿蒙项目依赖管理的焦点步调,确保所有模块和工具链正确安装。
如果编译过程中出现依赖相干错误(如uv_cwd或ENOENT),优先实验重新实行此命令并查抄网络环境。
附录二

在鸿蒙(HarmonyOS/OpenHarmony)应用开发中,您提到的命令是用于调用 DevEco Studio 内置的 hvigor 工具来实行项目构建使命。以下是该命令的详细解析:

命令布局

  1. /Applications/DevEco-Studio.app/Contents/tools/node/bin/node
  2. /Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw.js
  3. --sync
  4. -p product=default
  5. --analyze=normal
  6. --parallel
  7. --incremental
  8. --daemon
复制代码

各部门作用

1. node 和 hvigorw.js 路径



  • /Applications/DevEco-Studio.app/.../node
    利用 DevEco Studio 内置的 Node.js 环境,制止因系统全局 Node.js 版本不兼容导致题目。
  • /Applications/DevEco-Studio.app/.../hvigorw.js
    hvigor 是华为为鸿蒙开发定制的构建工具(类似 Android 的 Gradle),负责管理依赖、编译代码、打包资源等使命。

2. 焦点参数解析

参数作用--sync同步项目配置,确保所有模块的依赖关系和配置(如 build-profile.json5)一致。常用于首次拉取代码或修改依赖后。-p product=default指定构建的 产品形态。default 表示利用默认配置(如调试模式),其他可能值如 release(发布模式)。--analyze=normal启用构建过程分析,但仅输出常规日志(非详细)。若需调试,可改为 --analyze=verbose。--parallel启用多线程并行构建,加速大型项目的编译速率。--incremental增量编译模式,仅编译修改过的文件,减少构建时间。但若缓存异常可能导致失败,需定期清理(如 hvigor clean)。--daemon以保卫进程模式运行 hvigor,首次启动稍慢,但后续构建会复用进程提升速率。
该命令的典范场景

1. 项目初始化或配置变动后



  • 首次拉取代码或修改 build-profile.json5、oh-package.json5 等文件后,需实行 --sync 确保配置同步。
2. 一样平常开发构建



  • 利用 --incremental 和 --parallel 加速构建,适合频繁修改代码的场景。
3. 调试构建题目



  • 若构建失败,移除 --incremental 和 --daemon 进行全量编译,或添加 --debug 参数获取详细日志。

常见题目与留意事项

1. 增量编译失败



  • 现象:修改代码后构建报错,但全量编译乐成。
  • 解决:清理缓存重新同步:
    1. /Applications/DevEco-Studio.app/.../hvigorw.js clean
    复制代码
2. 保卫进程(daemon)冲突



  • 现象:修改环境变量或工具链后,构建行为异常。
  • 解决:终止保卫进程:
    1. /Applications/DevEco-Studio.app/.../hvigorw.js --stop
    复制代码
3. 并行编译(parallel)的资源竞争



  • 现象:多模块同时编译时,偶发文件锁冲突(如 ENOENT 或 EACCES)。
  • 解决:降低并行线程数(默认根据 CPU 焦点数自动分配):
    1. --parallel --max-workers=2  # 限制为 2 个线程
    复制代码

与 DevEco Studio 图形化操作的关系



  • GUI 操作等价性:在 DevEco Studio 中点击 Build > Build Project 时,IDE 底层会生成类似命令,但可能省略部门参数(如默认启用 --daemon)。
  • 手动调用的优势:在自动化脚本或调试复杂题目时,手动指定参数更灵活。

总结

此命令是鸿蒙项目构建的焦点步调,通过 hvigor 工具实现:

  • 同步配置(--sync)
  • 按产品形态构建(-p product=default)
  • 优化构建速率(--parallel、--incremental、--daemon)
若构建不稳定,可实验以下操作:
4. 清理缓存:hvigor clean
5. 关闭增量编译:移除 --incremental
6. 查看详细日志:添加 --debug 参数。
附录三 .鸿蒙构建-Error: ENOENT: no such file or directory, uv_cwd

工程在进行构建的时间碰到这个题目:Error: ENOENT: no such file or directory, uv_cwd
详细报错其实是在 node 里面,因此在网络上主要有以下几种解决方式

  • 如果是在终端运行的话,可以重启终端,看是否解决
  • 暴力终止所有 node 进程:killall node (本人用此方法解决题目)
  • 重启电脑。还真别说,我以为靠谱。跟上一种方法有异曲同工之妙。但如果你不想每次都重启,可能还是优先看看上面的方法吧
上面参考了其他博主的题目。

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
回复

使用道具 举报

0 个回复

倒序浏览

快速回复

您需要登录后才可以回帖 登录 or 立即注册

本版积分规则

数据人与超自然意识

金牌会员
这个人很懒什么都没写!
快速回复 返回顶部 返回列表