第二章 开发环境搭建:DevEco Studio的安装与配置、HarmonyOS SDK的下载、模拟器与真机调试环境准备
说实话,很多新手在学鸿蒙开发时,第一个劝退点往往不是代码本身,而是环境搭建。我见过太多人卡在安装这一步,折腾半天连个Hello World都跑不起来。今天我就把这一整套流程掰开揉碎了讲清楚,你跟着一步步来,半小时内肯定能跑起来。
2.1 DevEco Studio的安装与配置
DevEco Studio是华为官方推出的IDE,说白了就是鸿蒙版的Android Studio。它基于IntelliJ IDEA,如果你用过Android Studio或WebStorm,上手会非常快。
2.1.1 下载与安装
去华为开发者官网下载DevEco Studio。注意区分版本——目前有Windows版和macOS版。我个人习惯用Windows,但mac用户也别担心,操作流程几乎一样。
安装过程很简单,双击安装包,一路Next就行。但这里有个关键点:安装路径不要有中文和空格。我见过有人把路径写成「D:\鸿蒙开发工具」,结果编译时各种报错,排查了半天才发现是路径问题。
2.1.2 首次启动配置
安装完成后首次启动,会弹出一个配置向导。你需要做三件事:
- 选择主题:我个人喜欢暗色主题,保护眼睛。当然你选亮色也行,不影响功能。
- 配置Node.js路径:DevEco Studio依赖Node.js来运行一些脚本。如果你电脑里没有Node.js,它会提示你下载。建议安装LTS版本。
- 设置SDK路径:这个稍后我们会详细讲。
2.2 HarmonyOS SDK的下载
SDK就是开发工具包,里面包含了编译、调试、打包所需的一切。没有它,你写的代码就是一堆文本。
2.2.1 通过DevEco Studio下载SDK
打开DevEco Studio,进入「Settings」→「Appearance & Behavior」→「System Settings」→「HarmonyOS SDK」。你会看到这样一个界面:
| SDK组件 | 说明 | 是否必选 |
|---|---|---|
| HarmonyOS SDK | 核心SDK,包含API和工具 | ✅ 必选 |
| Toolchains | 编译工具链(如hvigor) | ✅ 必选 |
| Previewer | 预览器,用于快速查看UI效果 | ✅ 推荐 |
| Emulator | 模拟器镜像 | ✅ 推荐 |
勾选你需要的组件,点击「Apply」就开始下载了。嗯,这里要注意:下载速度可能很慢。我曾经在公司网络下等了两个小时才下完。建议你换个网络环境,或者用华为镜像站加速。
2.2.2 手动配置SDK路径
如果你已经下载了SDK压缩包,可以手动解压并配置路径。在SDK设置界面,点击「Edit」按钮,选择你的SDK目录即可。
2.3 模拟器与真机调试环境准备
环境搭好了,总得跑起来看看效果吧?这里有两种方式:模拟器和真机。
2.3.1 模拟器配置
DevEco Studio自带模拟器,支持手机、平板、智慧屏等多种设备类型。打开模拟器管理器(在工具栏的「Device Manager」图标),点击「+」新建模拟器。
你会看到这样的配置选项:
- 设备类型:Phone、Tablet、Wearable、TV等。做元服务开发,选Phone就行。
- 系统版本:建议选最新的API版本(目前是API 9或API 10)。
- 分辨率:1080x1920是主流,够用了。
配置好后点击「Finish」,模拟器就会启动。第一次启动会比较慢,因为要加载系统镜像。耐心等一两分钟就好。
2.3.2 真机调试配置
模拟器虽然方便,但有些功能(比如传感器、NFC)模拟不了。这时候就得用真机了。
真机调试需要做以下准备:
- 开启开发者模式:在手机「设置」→「关于手机」里,连续点击「版本号」7次,直到提示「您已进入开发者模式」。
- 开启USB调试:在「设置」→「系统和更新」→「开发人员选项」里,打开「USB调试」开关。
- 连接电脑:用USB数据线连接手机和电脑。手机上会弹出一个授权窗口,点击「允许」。
连接成功后,DevEco Studio的「Device Manager」里会显示你的设备。点击「Run」按钮,应用就会安装到手机上并自动启动。
2.3.3 调试技巧
调试是开发中必不可少的一环。这里分享几个我常用的调试技巧:
- Logcat日志:在DevEco Studio底部工具栏打开「Logcat」,可以实时查看应用日志。用
HiLog打印日志,比console.log更专业。 - 断点调试:在代码行号旁边点击,设置断点。然后点击「Debug」按钮,程序会停在断点处,你可以逐行执行、查看变量值。
- 布局检查器:在模拟器或真机上运行应用后,点击「Layout Inspector」可以查看UI层级结构,排查布局问题非常方便。
好了,环境搭建就讲到这里。下一章我们会正式开始写代码,从创建第一个鸿蒙元服务项目开始。到时候你会发现,前面这些准备工作都是值得的。