引言
在开始 HarmonyOS 开发之前,需要准备好开发环境。本章将详细指导你如何安装 HarmonyOS SDK、配置开发环境、创建 HarmonyOS 项目。
目录
-
- 安装 HarmonyOS SDK
-
- 配置开发环境
-
- 创建 HarmonyOS 项目
-
- 总结
1. 安装 HarmonyOS SDK
HarmonyOS SDK 是开发 HarmonyOS 应用的软件开发工具包。它包括了编译器、模拟器、调试器等工具。
1.1 下载 HarmonyOS SDK
- 打开华为 HarmonyOS 官方网站。
- 跳转到开发者社区。
- 在开发者社区,找到 HarmonyOS SDK 的下载页面。
- 选择适合你的操作系统的版本。
- 点击"下载"按钮,下载 HarmonyOS SDK。
1.2 安装 HarmonyOS SDK
- 打开下载的 HarmonyOS SDK 安装包。
- 双击安装文件,启动安装程序。
- 按照安装程序的指南,选择安装路径,接受许可协议。
- 点击"安装"按钮,开始安装 HarmonyOS SDK。
- 安装完成后,点击"完成"按钮。
2. 配置开发环境
配置开发环境是一个重要的步骤,它会影响到你的开发效率。
2.1 配置 JDK
- 确保你的计算机上已经安装了 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%') }
}
4. 总结
本章详细指导了你如何安装 HarmonyOS SDK、配置开发环境、创建 HarmonyOS 项目。现在,你已经准备好开始 HarmonyOS 开发了。