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

SoraLuna

发布于 2024-11-5 19:46

浏览

1收藏

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

关键词

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

一、配置 Java 环境

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

1.1 安装 Java

下载 JDK：前往 Oracle Java 下载页面下载适用于 macOS 的 Java Development Kit（JDK）。
安装 JDK：下载完成后，双击安装文件，按提示完成安装。
验证安装：打开终端，运行以下命令确认 Java 是否安装成功：
```
java -version
```

1.2 设置 JAVA_HOME 环境变量

确认 Shell 类型：在终端中运行以下命令，确定使用的 Shell 类型：
```
echo $SHELL
```
配置 JAVA_HOME：根据 Shell 类型编辑相应配置文件（zsh 编辑 ~/.zshrc，bash 编辑 ~/.bash_profile）。
- 打开终端并编辑配置文件：
```
nano ~/.zshrc
```
- 在文件末尾添加：
```
export JAVA_HOME=<jdk-path>
export PATH=$JAVA_HOME/bin:$PATH
```

应用配置：保存并刷新配置：

source ~/.zshrc   # 对于 zsh
source ~/.bash_profile   # 对于 bash

二、配置 `hvigorw` 命令行工具

2.1 下载并解压 `hvigorw`

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

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

2.2 添加 `hvigorw` 到系统环境变量

设置路径：在 macOS 终端中编辑配置文件，确保 hvigorw 可全局访问：
```
export PATH=~/command-line-tools/bin:$PATH
```
验证安装：可以通过以下命令快速确认工具已正确配置，即使未进入项目路径也能执行：
```
ohpm -v
```
若显示 ohpm 版本信息，即表示 hvigorw 工具已成功安装配置。

三、创建 HelloWorld 项目并验证 `hvigorw`

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

3.1 在 DevEco Studio 中创建项目

打开 DevEco Studio，选择 New Project。
在模板选择页面中选择 Empty Ability，填写基本信息后点击 Finish 创建项目。

3.2 使用 `hvigorw` 构建项目

推荐场景：刚创建项目或正在 DevEco Studio 中进行开发时，在 DevEco Studio 的内置终端执行以下命令，可避免频繁切换工具。
其他场景：若无需启动 DevEco Studio 或需在脚本/自动化流程中执行命令，可直接在 macOS 终端中操作。

进入项目目录（如 HelloWorld 项目）并验证 hvigorw 配置是否成功：
```
cd /path/to/HelloWorld
hvigorw -v
```
清理并构建项目：
```
hvigorw clean
hvigorw assembleHap -p buildMode=debug
```
buildMode=debug 为调试模式，发布可使用 buildMode=release。