第1章:鸿蒙开发环境搭建

说实话,每次带新人入门鸿蒙开发,环境搭建这一步总是最磨人的。我自己当年踩过的坑,现在想想都心疼那几天的时间。今天我就把经验掰开揉碎了讲给你听,保证你少走弯路。

1.1 DevEco Studio 的安装与配置

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

1.1.1 下载与安装

去华为开发者官网下载 DevEco Studio。注意选对版本——我建议直接上最新稳定版,别追 Beta。

  • Windows 用户:下载 .exe 安装包,双击运行。路径别带中文,否则后面编译会报一些莫名其妙的错。
  • macOS 用户:下载 .dmg 文件,拖到 Applications 文件夹就行。
  • Linux 用户:解压 tar.gz 包,运行 ./bin/studio.sh。嗯,Linux 用户应该不需要我多说了。
我的小习惯:安装路径我一般放在 D:\DevTools\DevEcoStudio(Windows)或 ~/DevTools/DevEcoStudio(Mac/Linux)。这样方便后续找配置文件。

1.1.2 首次启动配置

第一次启动会弹出一堆配置项。别慌,按顺序来:

  1. 主题选择:我选 Darcula,护眼。你随意。
  2. SDK 路径:这里先跳过,后面我们单独配。
  3. 插件安装:默认勾选的别动,额外推荐装个「Chinese (Simplified) Language Pack」——虽然我习惯英文界面,但新手看中文确实省力。

配置完成后,你会看到欢迎界面。嗯,到这里安装就算完成了。

1.2 HarmonyOS SDK 的下载

SDK 是开发的基础。没有它,你写的代码就是一堆文本。

1.2.1 通过 DevEco Studio 下载

打开 DevEco Studio,点击顶部菜单 Tools → SDK Manager。你会看到这样的界面:

SDK Platforms 标签页:
  - 勾选 HarmonyOS 3.1.0 (API 9) 或更高版本
  - 勾选 HarmonyOS 2.2.0 (API 8)(兼容旧项目用)

SDK Tools 标签页:
  - 勾选 SDK Platform-Tools
  - 勾选 SDK Build-Tools
  - 勾选 SDK Command-line Tools

点击 Apply,开始下载。这个过程取决于你的网速,我当年第一次下等了快半小时。

注意:SDK 下载路径不要有空格和中文。我曾经因为路径里有「鸿蒙SDK」四个字,编译时死活报错,排查了一下午才发现是路径编码问题。

1.2.2 手动下载 SDK

如果你网络不好,也可以去华为开发者官网手动下载 SDK 包。下载后解压,然后在 SDK Manager 里指定路径就行。

我个人更推荐自动下载,因为版本依赖关系会自动处理。手动下载容易漏掉某些组件,到时候编译报错你都不知道缺了啥。

1.3 模拟器与真机调试

代码写完了,总得跑起来看看效果吧?这里有两种方式。

1.3.1 模拟器调试

DevEco Studio 自带模拟器,支持手机、平板、智慧屏等多种设备类型。

启动方式很简单:

  1. 点击工具栏的 Device Manager 图标(一个小手机图标)
  2. 在弹窗里点击 + 号,选择设备类型
  3. 点击 Launch,等待模拟器启动

模拟器启动后,点击运行按钮,应用就会自动安装并启动。

避坑指南:模拟器默认分辨率是 1080p,如果你的电脑屏幕是 2K 或 4K,建议在模拟器设置里把分辨率调低一点。否则界面会小到让你怀疑人生。

1.3.2 真机调试

真机调试才是正经开发者的日常。模拟器再像,也比不上真机。

步骤:

  1. 开启开发者模式:在手机设置里连续点击「版本号」7 次,直到提示「您已进入开发者模式」。
  2. 开启 USB 调试:进入「系统和更新 → 开发人员选项」,打开 USB 调试开关。
  3. 连接电脑:用数据线连上电脑。如果是 Windows,可能需要安装华为手机助手驱动。
  4. 授权:手机上会弹出授权提示,点击「允许」。

连接成功后,DevEco Studio 的设备列表里就会出现你的手机。点击运行,应用就会安装到手机上。

我曾经踩过的坑:有一次怎么都连不上手机,折腾了半天才发现是数据线的问题——那根线只能充电,不能传数据。所以,请务必用原装数据线。

1.3.3 两种方式的对比

对比项 模拟器 真机
启动速度 较慢(首次启动约 1-2 分钟) 即插即用
性能表现 受限于电脑配置 真实设备性能
传感器支持 有限(如 GPS、陀螺仪模拟不准确) 完整支持
调试便利性 截图、录屏方便 需要数据线连接
适用场景 UI 调试、功能验证 性能测试、传感器相关功能

我的建议是:前期用模拟器快速验证 UI 和基本逻辑,后期一定要上真机跑一遍。你想想看,用户用的可是真机,不是模拟器。

本章小结

环境搭建这件事,说白了就是「一次配置,长期受益」。虽然第一次配起来有点繁琐,但配好了后面就顺了。

嗯,我记得自己第一次配环境时,光 SDK 就下了三遍——第一遍路径带中文,第二遍漏了 Build-Tools,第三遍才成功。所以你现在跟着我的步骤走,应该一次就能搞定。

下一章我们开始写第一个鸿蒙应用,到时候你会觉得,嗯,环境搭建这点苦没白吃。