准备HarmonyOS开发环境

引言

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

目录

• 1. 安装 HarmonyOS SDK
• 2. 配置开发环境
• 3. 创建 HarmonyOS 项目
• 4. 总结

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 开发了。