HarmonyOS 开发环境搭建

news2024/11/17 17:15:32

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系统：
解压缩包 devecostudio-windows-5.0.5.200.zip
双击下载的安装包运行（或右键以管理员身份运行）
选择安装路径（建议安装在非系统盘）
勾选需要安装的组件，点击“安装”直到完成
macOS系统：
双击下载的“deveco-studio-xxxx.dmg”软件包
在安装界面中，将“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）等。