📚 课程目录第1章 Matter开发环境搭建与首个示例应用编译

1. Matter开发环境搭建与首个示例应用编译

任务说明

本案例目标是在 Ubuntu 22.04 LTS 系统上从零搭建 Matter 开发环境：安装编译 Matter SDK 所需的系统依赖，获取 SDK 源码，编译出 chip-tool 可执行文件，并通过 chip-tool 的基础命令验证开发环境可用。完成本案例后，你将拥有一个可继续开发 Matter 设备或测试器的标准环境。

环境准备

本案例以 Ubuntu 22.04 LTS（x86_64）为基准。请确保系统已安装 git、curl 和网络连接。Matter SDK 编译需要约 8GB 磁盘空间和 4GB 以上内存。以下步骤均在终端中执行。

安装系统依赖

Matter SDK 依赖较多，使用 apt 安装基础编译工具链和库：

sudo apt update
sudo apt install -y git gcc g++ pkg-config libssl-dev libdbus-1-dev \
    libglib2.0-dev libavahi-client-dev ninja-build python3-venv \
    python3-pip unzip wget

安装完成后，确认 Python 版本为 3.8 以上：

python3 --version

获取 Matter SDK 源码

Matter SDK 使用子模块管理依赖，克隆时需带 --recursive 参数。本案例使用 v1.2.0.1 稳定版本标签：

cd ~
git clone --recursive https://github.com/project-chip/connectedhomeip.git
cd connectedhomeip
git checkout v1.2.0.1
git submodule update --init --recursive

源码获取完成后，进入 SDK 根目录并激活编译环境（该命令会创建 Python 虚拟环境并安装编译所需工具）：

cd ~/connectedhomeip
source scripts/activate.sh

激活过程首次运行会下载并安装编译工具链，需要数分钟时间。看到 Environment activated 提示即表示成功。

编译 chip-tool

chip-tool 是 Matter 官方提供的命令行测试工具，用于与 Matter 设备交互。在 SDK 根目录执行以下命令编译（首次编译约需 10-20 分钟，取决于机器性能）：

cd ~/connectedhomeip
source scripts/activate.sh
scripts/build/build_examples.py --target linux-x64-chip-tool build

编译完成后，可执行文件位于：

~/connectedhomeip/out/linux-x64-chip-tool/chip-tool

验证开发环境

验证分为两步：首先确认 chip-tool 可执行文件存在且能运行，然后通过 chip-tool 的版本命令确认其功能正常。

执行以下命令检查文件与运行状态：

ls -l ~/connectedhomeip/out/linux-x64-chip-tool/chip-tool
~/connectedhomeip/out/linux-x64-chip-tool/chip-tool version

预期输出：第一条命令显示可执行文件存在且有执行权限；第二条命令输出类似 v1.2.0.1 的版本号字符串。若两条命令均正常返回，则开发环境搭建成功。

验证判定标准

满足以下全部条件即判定本案例通过：

chip-tool 文件存在且为 ELF 可执行文件（file 命令可确认）；
chip-tool version 命令正常输出版本号且退出码为 0；
编译过程中无致命错误，最终生成的可执行文件可被 shell 直接调用。

常见问题排查

若编译过程中出现 submodule 相关错误，可回到 SDK 根目录重新执行 git submodule update --init --recursive。若 activate.sh 执行失败，检查 Python 版本是否满足要求，并确认 python3-venv 已正确安装。编译内存不足时，可临时增加 swap 空间或关闭其他占用内存的应用。