HarmonyOS 开发环境搭建

        HarmonyOS（鸿蒙操作系统）作为一种面向全场景多设备的智能操作系统，正逐渐在市场上崭露头角。为了进入HarmonyOS生态，开发者需要搭建一个高效的开发环境。本文将详细介绍如何搭建HarmonyOS开发环境，特别是如何安装和配置DevEco Studio。

前置条件

在开始搭建开发环境之前，请确保你的计算机满足以下要求：

• 操作系统：
  • Windows 10/11 64位
  • macOS (X86) 10.15及以上版本，macOS (ARM) 11及以上版本
• 内存：至少8GB，推荐16GB
• 硬盘：至少100GB可用空间
• 分辨率：1280*800像素及以上

1.下载与安装DevEco Studio

        DevEco Studio是基于IntelliJ IDEA Community开源版本打造，为HarmonyOS和OpenHarmony系统上的应用和服务提供一站式的开发平台。 

1.1.下载DevEco Studio

• 访问华为开发者联盟官网：https://developer.harmonyos.com

• 进入“开发”板块，选择“下载DevEco Studio”

• 这里根据你自己的操作系统选择对应的版本 ( 博主这里是Windows 11 64位 操作系统 )

1.2.安装DevEco Studio

• Windows系统：
  1. 解压缩包 devecostudio-windows-5.0.5.200.zip
  2. 双击下载的安装包运行（或右键以管理员身份运行）
  3. 选择安装路径（建议安装在非系统盘）
  4. 勾选需要安装的组件，点击“安装”直到完成
• macOS系统：
  1. 双击下载的“deveco-studio-xxxx.dmg”软件包
  2. 在安装界面中，将“DevEco-Studio.app”拖拽到“Applications”中，等待安装完成

博主这里以Windows 11 64位操作系统为例：

 

 这里可以自行选择安装目录（博主的安装在D盘）

这里勾选上更细PATH变量，就省的自己去配置环境变量了（懒人福荫） 

点击 安装 后，就可以静候佳音了 

OK，咱先存个档，等博主去重启Windows再说…… 

2.配置开发环境

2.1.运行DevEco Studio 

首次运行时，我们选择“Do not import settings”，点击“OK”

        好，这里接受“防沉迷”条款 ，接受了你就可以开始使用DevEco Studio 来开发你的第一款HarmonyOS应用了

3.创建第一个项目

安装完成后，可以开始创建第一个HarmonyOS项目：

3.1.启动DevEco Studio

• 如果是第一次启动DevEco Studio，点击 created project 创建项目
• 如果已经进入到DevEco Studio的开发界面，在右上角选择“File”>“New”>“New Project”

 3.2.选择模板

        选择Application应用开发，选择“Empty Ability”,点击Next进行下一步配置。如果你需要需要进行Native相关工程的开发，请选择“Native C++”模板，更多的模板详情和介绍，请参考华为Harmony OS开发指南 > 工程模板介绍

3.3.配置工程

• Compatible SDK选择“5.0.1(13)”，其他参数保持默认即可

【注意】：Bundle name是由“.” 分割的3个部分共同组成

点击Finish，工具会自动生成示例代码和相关资源，等待工程创建完成。

3.4.项目结构 [ ArkTS工程目录结构（Stage模型）]

 

 

• AppScope > app.json5：应用的全局配置信息，详见app.json5配置文件。
• entry：HarmonyOS工程模块，编译构建生成一个HAP包。
  • src > main > ets：用于存放ArkTS源码。
  • src > main > ets > entryability：应用/服务的入口。
  • src > main > ets > entrybackupability：应用提供扩展的备份恢复能力。
  • src > main > ets > pages：应用/服务包含的页面。
  • src > main > resources：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。关于资源文件，详见资源分类与访问。
  • src > main > module.json5：模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见module.json5配置文件。
  • build-profile.json5：当前的模块信息 、编译信息配置项，包括buildOption、targets配置等。
  • hvigorfile.ts：模块级编译构建任务脚本。
  • obfuscation-rules.txt：混淆规则文件。混淆开启后，在使用Release模式进行编译时，会对代码进行编译、混淆及压缩处理，保护代码资产。详见开启代码混淆。
  • oh-package.json5：用来描述包名、版本、入口文件（类型声明文件）和依赖项等信息。
• oh_modules：用于存放三方库依赖信息。

• build-profile.json5：工程级配置信息，包括签名signingConfigs、产品配置products等。其中products中可配置当前运行环境，默认为HarmonyOS。

• hvigorfile.ts：工程级编译构建任务脚本。

• oh-package.json5：主要用来描述全局配置，如：依赖覆盖（overrides）、依赖关系重写（overrideDependencyMap）和参数化配置（parameterFile）等。

4.调试和运行项目 

在编辑窗口右上角的侧边工具栏，点击Previewer，打开预览器。 

然后点击绿色的播放按钮运行项目：

博主这里选择phone设备（运行效果如图所示）：