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

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

本篇将讲解在 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)。

    image-20241026104357691.pngimage-20241026104357691.png

  2. 安装 JDK:下载完成后,双击安装文件,按提示完成安装。

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

    java -version
    
1.2 设置 JAVA_HOME 环境变量
  1. 确认 Shell 类型:在终端中运行以下命令,确定使用的 Shell 类型:

    echo $SHELL
    
  2. 配置 JAVA_HOME:根据 Shell 类型编辑相应配置文件(zsh 编辑 ~/.zshrcbash 编辑 ~/.bash_profile)。

    • 打开终端并编辑配置文件:
      nano ~/.zshrc
      
    • 在文件末尾添加:
      export JAVA_HOME=<jdk-path>
      export PATH=$JAVA_HOME/bin:$PATH
      
  3. 应用配置:保存并刷新配置:

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

二、配置 hvigorw 命令行工具

2.1 下载并解压 hvigorw

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

image-20241026104357692.pngimage-20241026104357692.png

2.2 添加 hvigorw 到系统环境变量
  1. 设置路径:在 macOS 终端中编辑配置文件,确保 hvigorw 可全局访问:

    export PATH=~/command-line-tools/bin:$PATH
    
  2. 验证安装:可以通过以下命令快速确认工具已正确配置,即使未进入项目路径也能执行:

    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 配置是否成功:

    cd /path/to/HelloWorld
    hvigorw -v
    
  2. 清理并构建项目

    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 - 应用依赖与资源管理


目录
相关文章
|
12天前
|
缓存 搜索推荐 索引
「Mac畅玩鸿蒙与硬件12」鸿蒙UI组件篇2 - Image组件的使用
在鸿蒙应用开发中,Image 组件用于加载和显示图片资源,并提供多种属性来控制图片的显示效果和适配方式。本篇将带你学习如何在鸿蒙应用中加载本地和远程图片、设置图片样式以及实现简单的图片轮播功能。
51 7
「Mac畅玩鸿蒙与硬件12」鸿蒙UI组件篇2 - Image组件的使用
|
14天前
|
自然语言处理 开发者
「Mac畅玩鸿蒙与硬件11」鸿蒙 UI 组件篇1 - Text 和 Button 组件详解
本篇将详细介绍鸿蒙应用开发中的 Text 和 Button 组件。通过本篇内容,你将学习如何使用 Text 组件显示文本、格式化文本样式,以及如何使用 Button 组件处理点击事件并自定义样式。掌握这些基本组件的用法将为后续的 UI 开发奠定基础。
41 4
「Mac畅玩鸿蒙与硬件11」鸿蒙 UI 组件篇1 - Text 和 Button 组件详解
|
14天前
|
开发工具 开发者 git
「Mac畅玩鸿蒙与硬件10」鸿蒙开发环境配置篇10 - 项目实战:计数器应用
本篇将通过一个简单的计数器应用,带你体验鸿蒙开发环境的实际操作流程。本项目主要练习组件的使用、事件响应和状态管理,帮助开发者熟悉基本的应用构建流程。
51 3
「Mac畅玩鸿蒙与硬件10」鸿蒙开发环境配置篇10 - 项目实战:计数器应用
|
14天前
|
存储 开发工具 数据安全/隐私保护
「Mac畅玩鸿蒙与硬件9」鸿蒙开发环境配置篇9 - 使用 Git 进行版本控制
在 HarmonyOS 项目开发中,Git 版本控制可以帮助开发者规范地管理代码变更,确保协作流程顺畅。本篇将详细介绍从创建项目、提交代码到 Git 远程仓库,再到修改、推送更新的完整操作流程,重点演示如何使用 Git 和 GitHub 进行身份验证和版本管理。
49 3
「Mac畅玩鸿蒙与硬件9」鸿蒙开发环境配置篇9 - 使用 Git 进行版本控制
|
14天前
|
编解码 缓存 自然语言处理
「Mac畅玩鸿蒙与硬件8」鸿蒙开发环境配置篇8 - 应用依赖与资源管理
本篇将介绍如何在 HarmonyOS 项目中高效管理资源文件和依赖,以确保代码结构清晰并提升应用性能。资源管理涉及图片、字符串、多语言文件等,通过优化文件加载和依赖管理,可以显著提升项目的加载速度和运行效率。
42 1
「Mac畅玩鸿蒙与硬件8」鸿蒙开发环境配置篇8 - 应用依赖与资源管理
|
7天前
|
编解码 开发工具 计算机视觉
鸿蒙5.0版开发:命令行工具(mediatool工具)
在HarmonyOS 5.0的开发中,命令行工具mediatool基于FFmpeg库,提供了丰富的媒体处理功能,如视频和音频的转码、封装格式转换、提取媒体信息等。本文详细介绍mediatool的功能和使用方法,并提供代码示例。
26 6
|
2月前
|
iOS开发 MacOS Windows
Mac air使用Boot Camp安装win10 ,拷贝 Windows 文件时出错
Mac air使用Boot Camp安装win10 ,拷贝 Windows 文件时出错
|
14天前
|
开发工具 iOS开发 开发者
「Mac畅玩鸿蒙与硬件2」鸿蒙开发环境配置篇2 - 在 Mac 上安装 DevEco Studio
本篇将专注于如何在 Mac 上安装鸿蒙开发工具 DevEco Studio,确保开发环境能够顺利搭建。完成安装后,可以正式开始鸿蒙应用的开发工作。
51 1
「Mac畅玩鸿蒙与硬件2」鸿蒙开发环境配置篇2 - 在 Mac 上安装 DevEco Studio
|
1月前
|
机器学习/深度学习 Python
【10月更文挑战第5天】「Mac上学Python 6」入门篇6 - 安装与使用Anaconda
本篇将详细介绍如何在Mac系统上安装和配置Anaconda,如何创建虚拟环境,并学习如何使用 `pip` 和 `conda` 管理Python包,直到成功运行第一个Python程序。通过本篇,您将学会如何高效地使用Anaconda创建和管理虚拟环境,并使用Python开发。
64 4
【10月更文挑战第5天】「Mac上学Python 6」入门篇6 - 安装与使用Anaconda
|
1月前
|
IDE 开发工具 iOS开发
【10月更文挑战第3天】「Mac上学Python 3」入门篇3 - 安装Python与开发环境配置
本篇将详细介绍如何在Mac系统上安装Python,并配置Python开发环境。内容涵盖Python的安装、pip包管理工具的配置与国内镜像源替换、安装与配置PyCharm开发工具,以及通过PyCharm编写并运行第一个Python程序。通过本篇的学习,用户将完成Python开发环境的搭建,为后续的Python编程工作打下基础。
174 2
【10月更文挑战第3天】「Mac上学Python 3」入门篇3 - 安装Python与开发环境配置