2、开发环境搭建:安装DevEco Studio,配置鸿蒙SDK,创建第一个Hello World项目

说实话,很多初学者卡在第一步——环境搭建。我见过太多人兴致勃勃想学鸿蒙,结果装个工具就折腾了两天,最后放弃了。其实没那么复杂,今天我就带你一步步搞定。

2.1 下载DevEco Studio

DevEco Studio是华为官方推出的IDE,基于IntelliJ IDEA。说白了,如果你用过Android Studio,上手会非常快。

去哪里下载?直接去华为开发者官网,找到DevEco Studio的下载页面。注意区分Windows和Mac版本。我个人习惯用Windows,但Mac用户也别担心,操作基本一致。

重要提醒:下载前确认你的电脑配置。建议至少8GB内存,20GB空闲磁盘。我有一台4GB的老笔记本,跑起来确实吃力,后来换了16GB才舒服。

2.2 安装DevEco Studio

下载完成后,双击安装包。嗯,这里要注意几个点:

  • 安装路径:不要有中文和空格。我曾经因为路径带了个“项目”两个字,结果编译报错,查了半天才发现是路径问题。
  • 组件选择:默认勾选就行,别乱改。
  • 启动后:第一次打开会提示导入设置,选“不导入”即可。

安装完成后,你会看到一个欢迎界面。别急着点“新建项目”,先配置SDK。

2.3 配置鸿蒙SDK

SDK是什么?你可以理解为开发所需的“工具箱”。没有它,你写的代码跑不起来。

配置步骤很简单:

  1. 打开DevEco Studio,点击“Configure” -> “SDK Manager”。
  2. 在SDK Manager中,选择“HarmonyOS”选项卡。
  3. 勾选你需要的API版本。我个人建议选最新的稳定版,比如API 9或API 10。
  4. 点击“Apply”,等待下载完成。

小技巧:下载SDK时,网络不好的话可以挂个代理。我遇到过下载到一半卡住的情况,重新点一下“Apply”就能继续。

配置完成后,记得检查一下环境变量。Windows用户需要把ohpmhvigor的路径加到PATH里。为什么要这么做?因为后面编译项目时会用到这些命令。

2.4 创建第一个Hello World项目

好了,环境搭好了,我们来写第一个程序。你想想看,学任何语言都是从Hello World开始的,鸿蒙也不例外。

操作步骤:

  1. 点击“Create New Project”。
  2. 选择“Empty Ability”模板。这是最基础的模板,适合新手。
  3. 填写项目名称:比如“HelloWorld”。
  4. 选择保存路径。注意,路径同样不要有中文。
  5. 点击“Finish”,等待项目初始化。

项目创建完成后,你会看到这样的目录结构:

HelloWorld/
├── entry/
│   ├── src/
│   │   ├── main/
│   │   │   ├── ets/
│   │   │   │   └── pages/
│   │   │   │       └── index.ets
│   │   │   └── resources/
│   │   └── module.json5
│   └── build-profile.json5
├── oh_modules/
└── build-profile.json5

打开index.ets文件,你会看到一些默认代码。别怕,我们把它改成最简单的Hello World:

@Entry
@Component
struct Index {
  build() {
    Column() {
      Text('Hello, HarmonyOS!')
        .fontSize(30)
        .fontWeight(FontWeight.Bold)
    }
    .width('100%')
    .height('100%')
    .justifyContent(FlexAlign.Center)
  }
}

这段代码做了什么?@Entry表示这是入口页面,@Component声明这是一个组件。build()方法里,我们用Column布局,里面放了一个Text文本。说白了,就是居中显示一行字。

注意:鸿蒙的语法和Flutter有点像,但又不完全一样。如果你之前学过Flutter,会觉得亲切;如果没学过,也别慌,后面我会详细讲。

2.5 运行项目

代码写完了,怎么看到效果?有两种方式:

  • 使用模拟器:DevEco Studio自带模拟器,点击工具栏的“Run”按钮,选择模拟器即可。我第一次用模拟器时,发现启动有点慢,耐心等一会儿就好。
  • 使用真机:如果你有鸿蒙手机或平板,可以连接USB调试。记得在手机上开启“开发者模式”和“USB调试”。

运行成功后,你会看到屏幕上显示“Hello, HarmonyOS!”。那一刻,说实话,挺有成就感的。

2.6 避坑指南

我在教学过程中,发现大家常遇到这几个问题:

  • SDK下载失败:检查网络,或者换个时间再试。我曾经半夜下载,速度飞快。
  • 模拟器启动黑屏:可能是显卡驱动问题,更新一下驱动试试。
  • 编译报错:看看是不是路径有中文,或者SDK版本不匹配。

我的建议:遇到问题先看控制台的错误日志。别急着百度,日志里往往就有答案。如果实在解决不了,去华为开发者社区提问,那里有很多热心人。

2.7 本章知识体系

为了让你更直观地理解本章内容,我画了一张流程图:

下载DevEco Studio 安装DevEco Studio 配置鸿蒙SDK 创建Hello World项目 编写代码 运行项目 ✅ 完成!

这张图展示了从下载到运行的全流程。你跟着箭头走,一步都不要跳,基本不会出错。

2.8 总结

环境搭建这件事,说白了就是“一次配置,长期受益”。虽然第一次有点繁琐,但配好了之后,后面写代码就顺畅了。我个人建议你把DevEco Studio的快捷键也熟悉一下,比如Ctrl+S保存、Ctrl+Shift+F10运行,能省不少时间。

好了,现在你的开发环境已经搭好了,第一个Hello World也跑起来了。接下来,你就可以正式开始鸿蒙开发之旅了。

专注资料整理