第二章 开发环境搭建：工欲善其事，必先利其器
说实话，做鸿蒙车机开发这几年，我踩过最多的坑，反而不是代码逻辑，而是环境搭建。你想想看，一个IDE装半天，SDK下载到一半断了，模拟器死活起不来……这些破事能让你一上午白干。所以这一章，我带你一步步把环境整利索，后面写代码才痛快。
2.1 DevEco Studio 安装与配置
DevEco Studio 是华为官方基于 IntelliJ IDEA 定制的 IDE。说白了，如果你用过 Android Studio，上手这个基本零成本。但有几个细节，我当年第一次装的时候可没少折腾。
2.1.1 下载与安装
去华为开发者官网下载 DevEco Studio 最新版。注意，车机开发建议用 3.1 及以上版本，因为对 API 9 的支持更稳定。
- Windows 用户：直接双击 exe，一路 Next。但记得安装路径不要有中文或空格，否则后面编译会报一些莫名其妙的错。
- macOS 用户：下载 dmg 文件，拖到 Applications 文件夹就行。我个人习惯把 SDK 目录也放在 Applications 下，方便管理。
- Linux 用户：解压 tar.gz，运行 bin 目录下的 studio.sh。嗯，这里要注意，如果提示缺少依赖，先装好 OpenJDK 11。
2.1.2 基础配置
第一次启动，会引导你配置几个关键项：
- SDK 路径：默认在用户目录下，但我建议单独放一个盘，比如 D:\HarmonyOS\SDK。因为后面下载的 SDK 包会越来越大，C 盘容易爆。
- Node.js 路径：DevEco Studio 需要 Node.js 来运行一些脚本。如果你电脑没装，它会自动帮你下载一个内置版本。我个人习惯用自己装的 LTS 版，更可控。
- ohpm 配置：ohpm 是鸿蒙的包管理工具，类似 npm。配置好镜像源，下载依赖会快很多。
2.2 HarmonyOS SDK 下载与管理
SDK 是开发的基础。车机开发需要下载的 SDK 包和手机端不太一样，多了几个车机专属的组件。
2.2.1 需要下载哪些 SDK
| SDK 组件 | 版本要求 | 说明 |
|---|---|---|
| HarmonyOS SDK | API 9 及以上 | 核心 SDK，必须下载 |
| SystemUI SDK | API 9 | 车机系统 UI 组件，用于开发状态栏、导航栏等 |
| Automotive SDK | API 9 | 车机专属 API，如车辆信息、空调控制等 |
| Toolchains | 最新版 | 编译工具链，包括 hvigor、ohpm 等 |
你可能会问，为什么 Automotive SDK 要单独下载？因为车机场景和手机不一样，比如获取车速、控制车窗这些接口，普通应用根本用不到。华为把它们独立出来，也是为了安全考虑。
2.2.2 下载步骤
在 DevEco Studio 里，打开 Settings → SDK Manager，勾选你需要的组件，点击 Apply 就开始下载了。这里有个坑——下载速度可能很慢。我建议你：
- 用有线网络，别用 Wi-Fi，稳定性差很多
- 如果下载到一半失败，别慌，点 Resume 继续就行
- 实在不行，去华为官网手动下载 zip 包，解压后放到 SDK 目录里
🔑 关键点：下载完成后，一定要检查 SDK 目录结构。正常的路径应该是：
D:\HarmonyOS\SDK\
├── ets
├── js
├── native
├── toolchains
└── ohpm如果缺少某个文件夹，说明下载不完整，需要重新下载。
2.3 模拟器与真机调试环境准备
环境搭好了，总得跑起来看看效果吧？车机开发有两种调试方式：模拟器和真机。我个人的经验是，前期用模拟器快速验证，后期必须上真机。
2.3.1 模拟器配置
DevEco Studio 自带模拟器，但车机模拟器需要单独创建。步骤如下：
- 点击工具栏的 "Device Manager" 图标
- 选择 "Emulator" 标签页，点击 "+" 新建
- 在设备类型里选择 "Car"，然后选一个车机模板，比如 "1280x720" 的横屏
- 配置内存和存储，建议至少 4GB 内存，否则模拟器会卡
启动模拟器后，你会看到一个车机中控屏的界面。嗯，第一次看到它的时候，我还挺兴奋的——终于能在电脑上跑车机了。
2.3.2 真机调试准备
真机调试，说白了就是把你的应用装到车机上跑。但车机不是手机，连接方式有点不一样。
第一步：开启开发者模式
在车机的设置里，找到 "关于本机"，连续点击 "版本号" 7 次，直到提示 "您已进入开发者模式"。这个操作和手机一模一样。
第二步：连接电脑
用 USB 线把车机和电脑连起来。注意，有些车机需要专用的调试线，普通的 USB 数据线可能不行。我遇到过好几次，线插上去没反应，换一根就好了。
第三步：授权调试
在车机上会弹出一个授权对话框，勾选 "始终允许"，点击确定。如果没弹，检查一下 USB 调试开关有没有打开。
2.3.3 远程调试（进阶）
如果你像我一样，车机在车上，电脑在办公室，总不能天天跑车里调试吧？这时候可以用远程调试。
DevEco Studio 支持通过 Wi-Fi 或网络连接设备。具体做法：
- 车机和电脑连同一个局域网
- 在车机上获取 IP 地址
- 在 DevEco Studio 的 Device Manager 里，选择 "Remote Device"，输入 IP 和端口
不过说实话，远程调试的稳定性一般，偶尔会断连。我建议只用来做简单的 UI 验证，复杂的逻辑调试还是老老实实用 USB 线。
2.4 常见问题与解决方案
最后，我把这些年遇到的环境问题整理了一下，你遇到类似情况可以直接查：
| 问题 | 原因 | 解决方法 |
|---|---|---|
| SDK 下载失败 | 网络不稳定或镜像源不对 | 切换国内镜像源，或手动下载 zip |
| 模拟器启动黑屏 | 显卡驱动或内存不足 | 更新显卡驱动，增加模拟器内存 |
| 真机连接不上 | USB 线或驱动问题 | 换线，安装华为 USB 驱动 |
| 编译报错 "ohpm not found" | ohpm 环境变量未配置 | 手动配置 ohpm 到 PATH |
好了，环境搭建这部分就到这里。你跟着走一遍，应该半小时内就能搞定。下一章我们开始写第一个 Hello World 应用，到时候你就知道，前面这些折腾都是值得的。