第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 用户应该不需要我多说了。
1.1.2 首次启动配置
第一次启动会弹出一堆配置项。别慌,按顺序来:
- 主题选择:我选 Darcula,护眼。你随意。
- SDK 路径:这里先跳过,后面我们单独配。
- 插件安装:默认勾选的别动,额外推荐装个「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,开始下载。这个过程取决于你的网速,我当年第一次下等了快半小时。
1.2.2 手动下载 SDK
如果你网络不好,也可以去华为开发者官网手动下载 SDK 包。下载后解压,然后在 SDK Manager 里指定路径就行。
我个人更推荐自动下载,因为版本依赖关系会自动处理。手动下载容易漏掉某些组件,到时候编译报错你都不知道缺了啥。
1.3 模拟器与真机调试
代码写完了,总得跑起来看看效果吧?这里有两种方式。
1.3.1 模拟器调试
DevEco Studio 自带模拟器,支持手机、平板、智慧屏等多种设备类型。
启动方式很简单:
- 点击工具栏的 Device Manager 图标(一个小手机图标)
- 在弹窗里点击 + 号,选择设备类型
- 点击 Launch,等待模拟器启动
模拟器启动后,点击运行按钮,应用就会自动安装并启动。
1.3.2 真机调试
真机调试才是正经开发者的日常。模拟器再像,也比不上真机。
步骤:
- 开启开发者模式:在手机设置里连续点击「版本号」7 次,直到提示「您已进入开发者模式」。
- 开启 USB 调试:进入「系统和更新 → 开发人员选项」,打开 USB 调试开关。
- 连接电脑:用数据线连上电脑。如果是 Windows,可能需要安装华为手机助手驱动。
- 授权:手机上会弹出授权提示,点击「允许」。
连接成功后,DevEco Studio 的设备列表里就会出现你的手机。点击运行,应用就会安装到手机上。
1.3.3 两种方式的对比
| 对比项 | 模拟器 | 真机 |
|---|---|---|
| 启动速度 | 较慢(首次启动约 1-2 分钟) | 即插即用 |
| 性能表现 | 受限于电脑配置 | 真实设备性能 |
| 传感器支持 | 有限(如 GPS、陀螺仪模拟不准确) | 完整支持 |
| 调试便利性 | 截图、录屏方便 | 需要数据线连接 |
| 适用场景 | UI 调试、功能验证 | 性能测试、传感器相关功能 |
我的建议是:前期用模拟器快速验证 UI 和基本逻辑,后期一定要上真机跑一遍。你想想看,用户用的可是真机,不是模拟器。
本章小结
环境搭建这件事,说白了就是「一次配置,长期受益」。虽然第一次配起来有点繁琐,但配好了后面就顺了。
嗯,我记得自己第一次配环境时,光 SDK 就下了三遍——第一遍路径带中文,第二遍漏了 Build-Tools,第三遍才成功。所以你现在跟着我的步骤走,应该一次就能搞定。
下一章我们开始写第一个鸿蒙应用,到时候你会觉得,嗯,环境搭建这点苦没白吃。