当前位置：首页 > news >正文

准备HarmonyOS开发环境

news 2025/7/27 23:02:47

引言

在开始 HarmonyOS 开发之前，需要准备好开发环境。本章将详细指导你如何安装 HarmonyOS SDK、配置开发环境、创建 HarmonyOS 项目。

确保你的计算机上已经安装了 JDK。如果没有安装，请先安装 JDK。
配置 JAVA_HOME 环境变量。
- 打开“控制面板”。
- 点击“系统”。
- 点击“高级系统设置”。
- 点击“环境变量”。
- 在“系统变量”中，点击“新建”。
- 输入“变量名”为 JAVA_HOME。
- 输入“变量值”为 JDK 的安装路径。
- 点击“确定”按钮。

2.2 配置开发环境

运行已安装的DevEco Studio，首次使用，请选择Do not import settings，单击OK。
进入DevEco Studio操作向导页面，修改npm registry，DevEco Studio已预置对应的仓（默认的npm仓，可能出现部分开发者无法访问或访问速度缓慢的情况），直接单击Start using DevEco Studio进入下一步。
设置Node.js信息，可以指定本地已安装的Node.js（Node.js版本要求为v14.19.1及以上，且低于v15.0.0；对应的npm版本要求为6.14.16及以上，且低于7.0.0版本）；如果本地没有合适的版本，可以选择Download按钮，在线下载Node.js。本示例以下载Node.js为例，选择下载源和存储路径后，单击Next进入下一步。等待Node.js安装完成，然后单击Finish进入下一步。
在SDK Components Setup界面，设置OpenHarmony SDK和HarmonyOS SDK存储路径，单击Next进入下一步。
在弹出的SDK下载信息页面，单击Next，并在弹出的License Agreement窗口，阅读License协议，需同意License协议后（需同时接受OpenHarmony SDK和HarmonyOS SDK的License协议），单击Next开始下载SDK。
等待SDK下载完成后，单击Finish，完成SDK的下载，界面会进入到DevEco Studio欢迎页。
配置HDC工具环境变量（Windows添加环境变量，添加HDC端口变量名为：HDC_SERVER_PORT，变量值可设置为任意未被占用的端口，如7035）

2.3 配置模拟器

打开 HarmonyOS SDK。
在 SDK 中，找到模拟器的配置页面。
按照配置页面的指南，配置模拟器。

2.4 配置 IDE

打开 HarmonyOS SDK。
在 SDK 中，找到 IDE 的配置页面。
按照配置页面的指南，配置 IDE。

3. 创建 HarmonyOS 项目

创建 HarmonyOS 项目是开始开发的第一步。

3.1 选择项目模板

打开 HarmonyOS SDK。
在 SDK 中，找到“创建项目”页面。
在“创建项目”页面中，选择一个项目模板。

3.2 配置项目

输入项目的名称。
输入项目的包名。
选择项目的目标平台。

3.3 创建项目

点击“创建”按钮。
HarmonyOS SDK 会自动创建项目。

3.4 工程目录结构

entry：HarmonyOS工程模块，编译构建生成一个HAP包。
- src > main > ets：用于存放ArkTS源码。
- src > main > ets > MainAbility：应用/服务的入口。
- src > main > ets > pages：应用/服务包含的页面。
- src > main > resources：用于存放应用/服务所用到的资源文件，如图形、多媒体、字符串、布局文件等。关于资源文件的详细说明请参考资源文件的分类。
- src > main > config.json：模块配置文件。主要包含HAP包的配置信息、应用/服务在具体设备上的配置信息以及应用/服务的全局配置信息。具体的配置文件说明，详见配置文件说明（JS/ArkTS）。
- build-profile.json5：当前的模块信息、编译信息配置项，包括buildOption、targets配置等。
- hvigorfile.ts：模块级编译构建任务脚本，开发者可以自定义相关任务和代码实现。
build-profile.json5：应用级配置信息，包括签名、产品配置等。
hvigorfile.ts：应用级编译构建任务脚本。
构建页面：点击“entry > src > main > ets > pages”，打开“index.ets”文件

@Entry
@Component
struct Index {@State message: string = 'Hello World'build() {Row() {Column() {Text(this.message).fontSize(50).fontWeight(FontWeight.Bold)Button() {Text('Next').fontSize(30).fontWeight(FontWeight.Bold)}.type(ButtonType.Capsule).margin({top:20}).backgroundColor('#0D9FFB').width('40%').height('5%')}.width('100%')}.height('100%')}
}