4、安装DevEco Device Tool：Windows端安装、Ubuntu端安装、插件依赖检查
好，咱们接着往下走。这一节要搞定的，是鸿蒙设备开发里最核心的工具——DevEco Device Tool。
说实话，这玩意儿我当年第一次装的时候，踩了不少坑。Windows端装完了，Ubuntu端又出问题，插件依赖检查更是让人头大。后来摸清了门道，才发现其实没那么复杂。今天我把这些经验全盘托出，你照着做就行。
4.1 为什么需要两个环境？
你可能会有疑问：为什么非得Windows和Ubuntu两边都装？
嗯，这里要解释一下。DevEco Device Tool的架构是客户端-服务端模式：
- Windows端：作为客户端，提供图形界面。你写代码、点按钮、看日志，都在这里。
- Ubuntu端：作为服务端，负责编译、烧录、调试。说白了，真正的“苦力活”是Linux干的。
我个人习惯把Ubuntu装在虚拟机里，或者用一台单独的Linux机器。Windows上装好客户端，通过网络连过去。这样两边各司其职，效率很高。
核心逻辑图：DevEco Device Tool 双端协作
4.2 Windows端安装
Windows端的安装，说白了就是个图形化安装包，一路点“下一步”就行。但有几个细节，我建议你注意一下。
4.2.1 下载安装包
去华为官方开发者网站，找到DevEco Device Tool的Windows版本。注意区分版本号，别下错了。我记得有一次项目组有人下了个Beta版，结果一堆bug，折腾了两天。
- 推荐版本：3.1 Release 或更新版本
- 文件格式：
.exe安装包 - 大小：约 200MB - 300MB
4.2.2 安装步骤
- 双击安装包，弹出安装向导。
- 选择安装路径。我个人习惯不装C盘，放在D盘或E盘，避免系统盘空间不足。
- 勾选组件：默认全选就行。如果你不需要某些插件，可以取消勾选，但新手不建议动。
- 等待安装完成。大概3-5分钟，看电脑性能。
小技巧：安装完成后，建议重启一下电脑。有些环境变量需要刷新，不重启的话可能找不到命令。
4.2.3 验证安装
打开命令行，输入：
deveco-device-tool --version如果输出版本号，说明安装成功。如果提示“不是内部或外部命令”，嗯，那就是环境变量没配好。去系统环境变量里，把安装目录下的 bin 文件夹路径加上就行。
4.3 Ubuntu端安装
Ubuntu端的安装，比Windows稍微复杂一点。毕竟Linux下很多东西要靠命令行搞定。
4.3.1 系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Ubuntu 20.04 LTS 或 22.04 LTS |
| Python版本 | 3.8 及以上 |
| 磁盘空间 | 至少 20GB 空闲 |
| 内存 | 建议 8GB 以上 |
4.3.2 安装步骤
打开终端，执行以下命令：
# 更新软件源
sudo apt update
# 安装依赖
sudo apt install -y python3 python3-pip python3-venv
# 下载 DevEco Device Tool Linux 版
wget https://.../deveco-device-tool_linux.tar.gz
# 解压
tar -xzf deveco-device-tool_linux.tar.gz
# 进入目录
cd deveco-device-tool
# 运行安装脚本
sudo ./install.sh这里要注意：安装脚本需要 root 权限。我曾经有一次忘了加 sudo，结果装到一半报权限错误，还得重新来一遍。
4.3.3 启动服务端
安装完成后，启动服务端：
deveco-device-tool server start看到类似 Server started on port 22118 的提示，就说明成功了。这个端口号要记住，Windows端连接的时候要用。
注意：Ubuntu端的服务端默认监听 127.0.0.1，也就是只能本机访问。如果你想把服务暴露给局域网内的Windows机器，需要修改配置文件，把监听地址改成 0.0.0.0。但这样做有安全风险，建议只在信任的网络中使用。
4.4 插件依赖检查
装完了两个端，接下来就是最容易被忽略的一步——插件依赖检查。
你想想看，DevEco Device Tool本身是个大框架，它要依赖很多底层工具链。比如编译需要gcc、g++，烧录需要串口驱动，调试需要OpenOCD等等。这些插件如果没装全，后面编译的时候就会报各种莫名其妙的错误。
4.4.1 检查命令
在Ubuntu端执行：
deveco-device-tool check这个命令会自动扫描当前环境，列出缺失的依赖项。输出结果大概长这样：
[INFO] Checking dependencies...
[OK] Python 3.8.10
[OK] pip 21.0.1
[WARN] gcc not found
[ERROR] OpenOCD not installed
[OK] make 4.2.14.4.2 常见缺失项及修复
| 缺失项 | 修复命令 | 说明 |
|---|---|---|
| gcc / g++ | sudo apt install build-essential |
C/C++ 编译器，编译源码必备 |
| OpenOCD | sudo apt install openocd |
调试和烧录工具，连接开发板用 |
| make | sudo apt install make |
构建工具，管理编译流程 |
| ninja | sudo apt install ninja-build |
比make更快的构建工具，鸿蒙推荐使用 |
| 串口驱动 | sudo apt install minicom |
串口通信工具，用于查看开发板日志 |
4.4.3 我的经验之谈
我曾经在一个项目里，因为漏装了 ninja，结果编译鸿蒙源码时速度慢得像蜗牛。后来装上ninja，编译时间直接缩短了三分之二。所以，ninja一定要装，别偷懒。
另外，如果你用的是虚拟机里的Ubuntu，记得检查一下USB设备是否透传给了虚拟机。不然插上开发板，Ubuntu端根本识别不到串口。这个坑我踩过，折腾了一下午才发现是VMware的USB设置没开。
快速检查清单：
- ✅ Windows端安装完成，能正常打开界面
- ✅ Ubuntu端安装完成，服务端启动成功
- ✅ 插件依赖检查全部通过（绿色OK）
- ✅ 串口驱动安装，开发板能被识别
这三步走完，环境搭建就算基本完成了。后面就是配置项目、导入源码、开始编译。
好，这一节的内容就到这儿。记住，环境搭建是基础中的基础，别嫌麻烦。每一步都检查到位，后面开发的时候才能顺风顺水。