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

说实话,很多初学者在学鸿蒙开发时,第一步就被环境搭建给卡住了。我见过不少朋友下载了错误的版本,或者SDK配置了半天就是跑不起来。其实没那么复杂,今天我就带你一步步搞定它。

2.1 DevEco Studio 的下载与安装

DevEco Studio 是华为官方推出的IDE,说白了就是咱们写鸿蒙代码的“战场”。它基于IntelliJ IDEA,如果你用过Android Studio,上手会非常快。

2.1.1 下载前的准备工作

我个人习惯在动手前先确认三件事:

  • 操作系统:Windows 10/11(64位)、macOS(10.15+)或Ubuntu 18.04+。我建议用Windows,因为遇到问题好找资料。
  • 内存:至少8GB,16GB会更舒服。我之前用8GB的笔记本跑模拟器,卡得想砸电脑。
  • 硬盘空间:预留30GB以上。SDK和模拟器都很占地方。

2.1.2 下载步骤

  1. 打开浏览器,访问华为开发者联盟官网。
  2. 找到“开发工具” -> “DevEco Studio”。
  3. 选择对应操作系统的版本下载。注意区分“标准版”和“预览版”,我建议用标准版,稳定。
小技巧:下载时别用迅雷之类的多线程工具,容易下载到损坏的包。直接用浏览器自带的下载就行。

2.1.3 安装过程

双击安装包,一路Next就行。不过有几个地方要注意:

  • 安装路径不要有中文和空格。我习惯放在 D:\DevEcoStudio 这种纯英文路径下。
  • 勾选“创建桌面快捷方式”,方便以后启动。
  • 安装完成后先别急着打开,咱们还要配SDK。

2.2 配置鸿蒙SDK

SDK就是开发工具包,没有它,你写的代码就是一堆废纸。嗯,这里要注意:鸿蒙的SDK和Android的SDK是两码事,别搞混了。

2.2.1 首次启动配置

第一次打开DevEco Studio,它会自动弹出SDK配置向导。你想想看,如果网络不好,这一步可能会卡很久。我曾经在公司内网配了半小时没反应,最后发现是防火墙拦了。

  1. 选择“HarmonyOS SDK”路径。我建议单独建一个文件夹,比如 D:\HarmonyOS\SDK
  2. 勾选你需要的API版本。目前主流是API 9和API 10。新手建议全选,省得后面缺东西。
  3. 点击“Next”,等待下载完成。这个过程大概10-20分钟,取决于你的网速。
避坑指南:我曾经遇到过SDK下载到一半失败的情况。别慌,关掉重来,它会断点续传。如果反复失败,试试换个网络环境,或者手动下载SDK包。

2.2.2 手动配置SDK

如果向导没成功,或者你后面想加新的SDK版本,可以手动配置:

  • 打开DevEco Studio,点击 File -> Settings -> Appearance & Behavior -> System Settings -> HarmonyOS SDK
  • 在这里你可以看到已安装的SDK版本,也可以点“Edit”修改路径。
  • 需要添加新版本时,点“Show Package Details”,勾选对应版本后点“Apply”。

2.3 创建第一个Hello World项目

环境搭好了,咱们来写个Hello World庆祝一下。说实话,看到“Hello World”在模拟器上跑起来的那一刻,还是挺有成就感的。

2.3.1 新建项目

  1. 点击“Create New Project”。
  2. 选择模板。我建议新手选“Empty Ability”,它最干净,没有多余代码。
  3. 配置项目信息:
    • Project Name:比如 HelloWorld
    • Package Name:比如 com.example.helloworld
    • Save Location:选个好记的路径
    • Language:选Java或ArkTS。我建议ArkTS,这是鸿蒙的亲儿子语言。
    • API Version:选你刚才下载的版本,比如API 9。
  4. 点击“Finish”,等待项目构建完成。

2.3.2 项目结构一览

项目建好后,你会看到一堆文件夹。别怕,咱们只看几个关键的:

文件夹/文件 作用
entry/src/main/ets 存放ArkTS代码的地方,咱们主要在这里写逻辑
entry/src/main/resources 存放图片、字符串等资源文件
entry/src/main/config.json 应用的配置文件,比如应用名称、权限等

2.3.3 编写Hello World

打开 entry/src/main/ets/MainAbility/pages/index.ets,你会看到类似这样的代码:

@Entry
@Component
struct Index {
  @State message: string = 'Hello World'

  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}

这段代码很简单:@State 定义了一个响应式变量 messageText 组件把它显示出来。你改成 '你好,鸿蒙' 试试?

2.3.4 运行项目

点击工具栏上的三角形运行按钮,选择“Run 'entry'”。它会弹出设备选择窗口:

  • 模拟器:如果你没真机,选这个。第一次启动模拟器需要下载镜像,大概几百MB。
  • 真机:用USB连上手机,打开开发者模式,就能直接跑。
重点:真机调试时,记得在 config.json 里把 debuggable 设为 true,不然装不上。

2.4 本章知识体系

为了让你更直观地理解整个流程,我画了一张图:

下载DevEco Studio 配置鸿蒙SDK 创建Hello World 选择对应操作系统版本 安装到纯英文路径 选择API版本 等待下载完成 选择Empty Ability模板 编写代码并运行 环境搭建完成!可以开始开发了 记得定期更新SDK,保持与华为官方同步

你看,整个流程就是一条直线:下载 -> 配置 -> 运行。没有想象中那么复杂吧?

我的建议:第一次跑通后,别急着关。试着改改 fontSize 或者换个颜色,感受一下实时预览的效果。这样能帮你快速建立信心。

好了,环境搭好了,Hello World也跑起来了。接下来你就可以开始探索鸿蒙的世界了。记住,遇到问题别硬扛,多看看官方文档,或者去社区搜一搜。我当年就是这么过来的。


公众号:蓝海资料掘金营,微信deep3321