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

embedded/2025/2/10 21:05:19/

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

在软件开发领域，自动化构建是提高开发效率和确保代码质量的重要手段。特别是在鸿蒙（OpenHarmony）应用开发中，自动化构建更是不可或缺。本文将详细介绍如何使用Jenkins命令行工具实现鸿蒙HAR应用的自动化构建打包，让开发流程更加高效、可靠。

一、引言

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

二、环境准备

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

  • Jenkins：用于自动化构建的任务调度和执行。
  • DevEco Studio：鸿蒙开发的集成开发环境（IDE），包含了必要的工具和SDK。
  • Node.js：JavaScript运行环境，用于执行hvigorw等脚本。
三、核心步骤

实现鸿蒙HAR应用的自动化构建打包，核心在于以下三个步骤：初始化依赖、初始化工作环境、执行具体的构建任务。下面将详细介绍每个步骤的具体实现。

1. 初始化依赖

首先，需要使用ohpm命令来初始化项目所需的依赖。ohpm是鸿蒙的包管理工具，类似于npm或yarn。在Jenkins脚本中，可以使用以下命令来安装所有依赖：

/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脚本中，可以使用以下命令来同步项目配置并初始化工作环境：

/Applications/DevEco-Studio.app/Contents/tools/node/bin/node /Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw.js --sync -p product=default --analyze=normal --parallel --incremental --daemon

这条命令会同步项目的配置信息，并根据指定的产品配置（product=default）初始化工作环境。同时，它还会开启并行构建、增量构建和守护进程等功能，以提高构建效率。

3. 执行具体的构建任务

最后，使用hvigorw脚本来执行具体的构建任务。在Jenkins脚本中，可以使用以下命令来构建并打包HAR应用：

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中执行完整的业务逻辑构建了。以下是一个示例脚本：

#!/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 ]; thenecho "依赖安装失败"exit 1
fi# 初始化工作环境
${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 ]; thenecho "工作环境初始化失败"exit 1
fi# 执行具体的构建任务
hvigorw --mode module -p product=default -p module=$moduleName@default -p buildMode=release assembleHar --analyze=normal --parallel --incremental --daemon# 检查构建任务是否成功
if [ $? -ne 0 ]; thenecho "构建任务失败"exit 1
fiecho "构建成功"

将这个脚本保存为build.sh，并在Jenkins中配置一个执行该脚本的构建任务，就可以实现鸿蒙HAR应用的自动化构建打包了。

五、总结与展望

通过本文的介绍，我们了解了如何使用Jenkins命令行工具实现鸿蒙HAR应用的自动化构建打包。这不仅提高了开发效率，还确保了代码质量。未来，随着鸿蒙系统的不断发展和完善，自动化构建工具也将更加智能和高效。我们可以期待更多的自动化工具和插件出现，为鸿蒙应用开发提供更加便捷和高效的解决方案。

希望本文对大家有所帮助！如果你有任何疑问或建议，请随时在评论区留言。

附录一

在DevEco Studio启动或项目初始化过程中，执行以下命令：

/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：清理缓存
    rm -rf ./oh_modules  # 删除依赖目录
ohpm clean           # 清理ohpm缓存
  • 步骤3：手动指定环境
    若系统全局安装了其他Node.js版本，可能路径冲突，应直接使用DevEco Studio内置的ohpm和Node.js。

5. 总结

此命令是鸿蒙项目依赖管理的核心步骤，确保所有模块和工具链正确安装。
如果编译过程中出现依赖相关错误（如uv_cwd或ENOENT），优先尝试重新执行此命令并检查网络环境。

附录二

在鸿蒙（HarmonyOS/OpenHarmony）应用开发中，您提到的命令是用于调用 DevEco Studio 内置的 hvigor 工具来执行项目构建任务。以下是该命令的详细解析：

命令结构

/Applications/DevEco-Studio.app/Contents/tools/node/bin/node 
/Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw.js 
--sync 
-p product=default 
--analyze=normal 
--parallel 
--incremental 
--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. 增量编译失败
  • 现象：修改代码后构建报错，但全量编译成功。
  • 解决：清理缓存重新同步：
    /Applications/DevEco-Studio.app/.../hvigorw.js clean
2. 守护进程（daemon）冲突
  • 现象：修改环境变量或工具链后，构建行为异常。
  • 解决：终止守护进程：
    /Applications/DevEco-Studio.app/.../hvigorw.js --stop
3. 并行编译（parallel）的资源竞争
  • 现象：多模块同时编译时，偶发文件锁冲突（如 ENOENT 或 EACCES）。
  • 解决：降低并行线程数（默认根据 CPU 核心数自动分配）：
    --parallel --max-workers=2  # 限制为 2 个线程

与 DevEco Studio 图形化操作的关系

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

总结

此命令是鸿蒙项目构建的核心步骤，通过 hvigor 工具实现：

  1. 同步配置（--sync）
  2. 按产品形态构建（-p product=default）
  3. 优化构建速度（--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 里面，因此在网络上主要有以下几种解决方式

  1. 如果是在终端运行的话，可以重启终端，看是否解决

  2. 暴力终止所有 node 进程：killall node （本人用此方法解决问题）

  3. 重启电脑。还真别说，我觉得靠谱。跟上一种方法有异曲同工之妙。但如果你不想每次都重启，可能还是优先看看上面的方法吧

上面参考了其他博主的问题。


http://www.ppmy.cn/embedded/161165.html

相关文章

网络编程 day3

网络编程 day3

思维导图 以select函数模型为例 思维导图2 对应 epoll模型 应使用的函数 题目 使用epoll函数实现 两个客户端 通过服务器 实现聊天 思路 在原先代码基础上 实现 服务器 发向 客户端 使用客户端在服务器上的 套接字描述符 实现 客户端 接收 服务器…
阅读更多...
LabVIEW污水生化处理在线监测

LabVIEW污水生化处理在线监测

污水处理是环保领域的重要工作，传统污水处理方法在监测方面存在实时性差、操作不便等问题。为解决这些问题，本项目设计并实现了一套基于LabVIEW的污水生化处理在线监测平台，能够实时监测污水处理过程中的关键参数，如温度、pH值、溶…
阅读更多...
Vue 3 中的 reactive 和 ref 有什么区别？

Vue 3 中的 reactive 和 ref 有什么区别？

在 Vue 3 中，reactive 和 ref 是用于创建响应式状态的两个 API。虽然它们的目标都是使数据响应式，但它们的使用场景和实现方式有所不同。以下是它们之间的主要区别： 目录 何时使用 reactive 和 ref基本用法响应式对象的类型总结何时使用 reactive 和 ref reactive：适用于创…
阅读更多...
【JDBC】数据库连接的艺术：深入解析数据库连接池、Apache-DBUtils与BasicDAO

【JDBC】数据库连接的艺术：深入解析数据库连接池、Apache-DBUtils与BasicDAO

文章目录 前言🌍 一.连接池❄️1. 传统获取Conntion问题分析❄️2. 数据库连接池❄️3.连接池之C3P0技术🍁3.1关键特性🍁3.2配置选项🍁3.3使用示例 ❄️4. 连接池之Druid技术🍁 4.1主要特性🍁 4.2 配置选项…
阅读更多...
Vue 响应式渲染 - Vue3 Class和style

Vue 响应式渲染 - Vue3 Class和style

Vue 渐进式JavaScript 框架 基于Vue2的学习笔记 - Vue响应式渲染 - Vue3 Class和style 目录 Vue3 class和style 初始化方式 初始化方式修改 动态切换class-对象写法 设置元素 设置变量 后期动态添加属性 总结 Vue3 class和style 引用Vue3版本在多个class之间切换 初始…
阅读更多...
Flink-WordCount源码解析

Flink-WordCount源码解析

一、源码下载 下载地址：Apache Download Mirrors 二、idea构建 使用idea打开解压后的源码，并设置好jdk和maven配置，静等下载依赖即可。 三、WordCount源码探寻 WordCount示例是对文本文件上的单词进行计算，可以在流式和批处理…
阅读更多...
mysql系统库介绍,数据字典(介绍,存储方式,常见表,访问权限),系统表(介绍,不同功能的表)

mysql系统库介绍,数据字典(介绍,存储方式,常见表,访问权限),系统表(介绍,不同功能的表)

目录 mysql系统库 介绍 数据字典 介绍 不同版本下的存储方式 常见的数据字典表 访问权限 系统表 介绍 权限授予系统表 对象信息系统表 服务器端帮助系统表 时区系统表 mysql系统库 介绍 MySQL 默认创建 的特殊数据库，主要用于存储服务器运行时所需的信…
阅读更多...
青少年编程与数学 02-008 Pyhon语言编程基础 25课题、文件操作

青少年编程与数学 02-008 Pyhon语言编程基础 25课题、文件操作

青少年编程与数学 02-008 Pyhon语言编程基础 25课题、文件操作 一、文件操作二、文本文件读取文本文件写入文本文件追加文本到文件修改文本文件复制文本文件文件编码错误处理 三、JSON文件读取JSON文件写入JSON文件修改JSON文件处理大型JSON文件错误处理 四、练习1. 将JSON文件…
阅读更多...
最新文章

Copyright @ 2022~2023