「Mac畅玩鸿蒙与硬件7」鸿蒙开发环境配置篇7 - 使用命令行工具和本地模拟器管理项目

本篇将讲解在 macOS 上配置 HarmonyOS 开发环境的流程,聚焦 hvigorw 命令行工具的使用。我们将以创建 HelloWorld 项目为例,演示使用 hvigorw 进行项目构建、清理操作,并通过 DevEco Studio 的本地模拟器进行预览,帮助提升项目开发与调试效率。

关键词
  • HarmonyOS 命令行工具
  • hvigorw
  • Java 环境配置
  • DevEco Studio 本地模拟器
  • 项目构建与预览

一、配置 Java 环境

hvigorw 依赖 Java 环境(JRE)运行构建任务,因此必须先在 Mac 的终端中安装并配置。

1.1 安装 Java
  1. 下载 JDK :前往 Oracle Java 下载页面 下载适用于 macOS 的 Java Development Kit(JDK)。
  1. 安装 JDK:下载完成后,双击安装文件,按提示完成安装。

  2. 验证安装 :打开终端,运行以下命令确认 Java 是否安装成功:

    bash 复制代码
    java -version
1.2 设置 JAVA_HOME 环境变量
  1. 确认 Shell 类型 :在终端中运行以下命令,确定使用的 Shell 类型 echo $SHELL
  2. 配置 JAVA_HOME :根据 Shell 类型编辑相应配置文件(zsh 编辑 ~/.zshrcbash 编辑 ~/.bash_profile)。
  • 打开终端并编辑配置文件:

    bash 复制代码
    nano ~/.zshrc
  • 在文件末尾添加:

    bash 复制代码
    export JAVA_HOME=<jdk-path>
    export PATH=$JAVA_HOME/bin:$PATH
  1. 应用配置 :保存并刷新配置:

    bash 复制代码
    source ~/.zshrc   # 对于 zsh
    source ~/.bash_profile   # 对于 bash

二、配置 hvigorw 命令行工具

2.1 下载并解压 hvigorw

DevEco Studio 下载页面 获取 Command Line Tools 压缩包并解压到 ~/command-line-tools

2.2 添加 hvigorw 到系统环境变量
  1. 设置路径 :在 macOS 终端中编辑配置文件,确保 hvigorw 可全局访问:
bash 复制代码
 export PATH=~/command-line-tools/bin:$PATH
  1. 验证安装:可以通过以下命令快速确认工具已正确配置,即使未进入项目路径也能执行:
bash 复制代码
ohpm -v

若显示 ohpm 版本信息,即表示 hvigorw 工具已成功安装配置。


三、创建 HelloWorld 项目并验证 hvigorw

对于项目创建和构建,既可以在 DevEco Studio 中通过内置终端或运行工具执行 hvigorw 命令,也可以在 Mac 的终端中完成。以下是推荐的不同场景下的使用方式:

3.1 在 DevEco Studio 中创建项目
  1. 打开 DevEco Studio,选择 New Project
  2. 在模板选择页面中选择 Empty Ability,填写基本信息后点击 Finish 创建项目。
3.2 使用 hvigorw 构建项目
  • 推荐场景:刚创建项目或正在 DevEco Studio 中进行开发时,在 DevEco Studio 的内置终端执行以下命令,可避免频繁切换工具。
  • 其他场景:若无需启动 DevEco Studio 或需在脚本/自动化流程中执行命令,可直接在 macOS 终端中操作。
  1. 进入项目目录 (如 HelloWorld 项目)并验证 hvigorw 配置是否成功:
bash 复制代码
cd /path/to/HelloWorld
hvigorw -v
  1. 清理并构建项目
bash 复制代码
hvigorw clean
hvigorw assembleHap -p buildMode=debug

buildMode=debug 为调试模式,发布可使用 buildMode=release


四、在 DevEco Studio 模拟器中预览应用

  1. 启动本地模拟器 :在 Tools > Device Manager 中选择 本地模拟器并启动。
  2. 运行项目 :在 DevEco Studio 中点击 Run,应用将自动安装到模拟器中并启动。

五、hvigorw 工具的实用场景

  • 自动化构建:适用于 CI/CD 环境的自动化流水线。
  • 增量编译与并行构建:减少编译时间,加速开发流程。
  • 构建日志分析:提供构建流程详细日志,帮助解决性能瓶颈。
  • 测试与覆盖率:支持集成测试并生成代码覆盖率报告,持续跟踪项目质量。

小结

本篇介绍了在 macOS 上配置 HarmonyOS 开发环境及 hvigorw 工具的使用,演示了项目创建、构建、模拟器预览。hvigorw 工具适用于自动化构建和持续集成场景,而 DevEco Studio 的模拟器便于调试和预览应用。


下一篇预告

下一篇将介绍如何在鸿蒙项目中管理应用的依赖和资源文件,帮助开发者优化项目资源结构,提升项目的运行效率。


上一篇「Mac畅玩鸿蒙与硬件6」鸿蒙开发环境配置篇6 - 理解鸿蒙项目结构
下一篇「Mac畅玩鸿蒙与硬件8」鸿蒙开发环境配置篇8 - 应用依赖与资源管理

相关推荐
coder_pig7 小时前
跟🤡杰哥一起学Flutter (三十四、玩转Flutter手势✋)
前端·flutter·harmonyos
simple丶7 小时前
【HarmonyOS】鸿蒙蓝牙连接与通信技术
harmonyos·arkts·arkui
二二孚日8 小时前
自用华为ICT云赛道Big Data第五章知识点-Flume海量日志聚合
大数据·华为
前端世界8 小时前
HarmonyOS开发实战:鸿蒙分布式生态构建与多设备协同发布全流程详解
分布式·华为·harmonyos
Jalor9 小时前
Flutter + 鸿蒙 | Flutter 跳转鸿蒙原生界面
flutter·harmonyos
二二孚日10 小时前
自用华为ICT云赛道Big Data第四章知识点-Flink流批一体分布式实时处理引擎
大数据·华为
zhanshuo10 小时前
开发者必看!如何在HarmonyOS中快速调用摄像头功能
harmonyos
HMSCore10 小时前
借助HarmonyOS SDK,《NBA巅峰对决》实现“分钟级启动”到“秒级进场”
harmonyos
zhanshuo10 小时前
鸿蒙UI开发全解:JS与Java双引擎实战指南
前端·javascript·harmonyos
HarmonyOS小助手11 小时前
闯入鸿蒙:浪漫、理想与「草台班子」
harmonyos·鸿蒙·harmonyos next·鸿蒙生态