第1章:开发环境搭建
说实话,做鸿蒙分布式硬件开发,第一步就是搭环境。
我见过太多人,一上来就急着写代码,结果环境没配好,折腾半天连个Hello World都跑不起来。嗯,咱们别走弯路,一步步来。
1.1 DevEco Studio安装
DevEco Studio是华为官方推出的IDE,说白了就是咱们写鸿蒙代码的“主战场”。
我个人习惯用最新稳定版,别追新,稳定最重要。
安装步骤:
- 去华为开发者官网下载DevEco Studio安装包(Windows/Mac/Linux都支持)
- 双击安装,一路默认就行
- 安装完成后,启动时会自动检测JDK环境
- 如果没有JDK,它会提示你下载,点同意就行
小提示:我建议安装路径不要带中文,也不要有空格。以前有个学员路径里写了“新建文件夹”,结果编译死活报错,查了半天才发现是路径问题。
1.2 HarmonyOS SDK配置
SDK是什么?你可以理解成是鸿蒙系统的“工具箱”。没有它,你的代码没法跟鸿蒙设备沟通。
配置SDK其实很简单:
- 打开DevEco Studio,点菜单栏的 Tools → SDK Manager
- 在SDK Manager里,选择你要用的HarmonyOS版本
- 我一般选最新的稳定版,比如当前是API 9
- 勾选后点Apply,它会自动下载
注意:下载SDK需要联网,而且文件不小(大概2-3GB)。我曾经在客户现场用手机热点下载,等了快一个小时……建议提前准备好网络环境。
下载完成后,记得检查一下环境变量。打开终端,输入:
hdc -v
如果能显示版本号,说明SDK配置成功了。
1.3 模拟器配置
没有真机的时候,模拟器就是你的好帮手。
配置模拟器分三步:
- 在DevEco Studio里,点 Tools → Device Manager
- 选择 Emulator 标签页
- 点 + New Emulator,选择设备类型(手机、平板、智能手表等)
这里有个坑,我踩过:模拟器需要开启CPU虚拟化。如果你用的是Windows,记得去BIOS里打开Intel VT-x或AMD-V。不然模拟器启动时会报错,说“无法创建虚拟机”。
模拟器启动后的检查清单:
- 模拟器能正常开机吗?
- 能显示鸿蒙桌面吗?
- 鼠标点击有反应吗?
如果都OK,恭喜你,模拟器环境搭好了。
1.4 真机调试环境准备
说实话,模拟器再方便,也比不上真机。尤其是做分布式硬件开发,很多功能(比如设备发现、数据传输)在模拟器上根本测不了。
真机调试需要准备:
- 一台鸿蒙设备(手机、平板、开发板都行)
- 一根数据线(最好是原装的,别用那种只能充电的线)
- 开启开发者模式
开启开发者模式的方法:
- 打开设备上的 设置 → 关于手机
- 连续点击 版本号 7次
- 返回设置,就能看到 开发者选项 了
- 打开 USB调试 和 “仅充电”模式下允许ADB调试
重要提醒:我曾经有一次忘了开“仅充电模式下允许ADB调试”,结果插上线后设备只充电,DevEco Studio死活识别不到。折腾了半小时才发现是这个问题。
连接成功后,在DevEco Studio的Device Manager里,应该能看到你的设备。点一下 Run,如果能在真机上跑起来,说明环境全部就绪了。
1.5 常见问题与避坑指南
嗯,这里总结几个我遇到过的典型问题:
| 问题 | 原因 | 解决办法 |
|---|---|---|
| 模拟器启动黑屏 | CPU虚拟化未开启 | 进BIOS开启Intel VT-x/AMD-V |
| 真机连接不上 | USB调试未开启或数据线问题 | 检查开发者选项,换根数据线 |
| SDK下载失败 | 网络不稳定或磁盘空间不足 | 换个网络环境,清理磁盘空间 |
| 编译报错“找不到SDK” | 环境变量未配置 | 检查SDK路径,重新配置环境变量 |
我的经验:如果你用的是Mac,记得去 系统偏好设置 → 安全性与隐私 → 隐私 → 辅助功能 里,把DevEco Studio勾上。不然模拟器可能无法获取键盘输入。
好了,环境搭建就到这里。下一章咱们开始写第一个鸿蒙分布式应用,到时候你就知道,今天这些折腾都是值得的。
公众号:蓝海资料掘金营,微信deep3321