硬件準備

PC機需要支持藍牙4.0及以上版本，如果沒有的話需要購買一個USB藍牙適配器，而且需要支持Linux，可以參考購買這款藍牙適配器

準備工作

1.遞歸克隆Matter倉庫

執行如下命令：

git clone --recurse-submodules git@github.com:project-chip/connectedhomeip.git

如果克隆過程中發生報錯，請執行如下命令來同步子模塊：

git submodule update --init

由于我們的環境構建配置均是基于Matter1.0，所以我們需要切換到v1.0分支下

git checkout v1.0

2.Matter依賴項安裝

Matter 構建依賴于以下軟件包及環境庫：

sudo apt-get install git gcc g++ pkg-config libssl-dev libdbus-1-dev
libglib2.0-dev libavahi-client-dev ninja-build python3-venv python3-dev
python3-pip unzip libgirepository1.0-dev libcairo2-dev libreadline-dev

如果通過build_examples.py 和 -with-ui 變體進行構建，也要安裝 SDL2：

sudo apt-get install libsdl2-dev

3.Matter環境構建

執行scripts/activate.sh腳本。該腳本負責下載 GN、ninja，并使用用于構建和測試的庫設置 Python 環境。

source scripts/activate.sh

如果顯示環境已過期可執行如下命令進行更新（一般如果沒提示環境已過期的提示不建議執行這一步，編譯會花一段時間）：

source scripts/bootstrap.sh

4.安裝zap

注意：zap 包目前不可用arm64（比如在 Raspberry PI 上編譯時）。

Step1：ZAP需要Node.js來運行，請先確保你的計算機上已經安裝了Node.js。可以使用以下命令：

node -v

如果安裝的話不出意外會出現版本號。

Step2：zap安裝

cd connectedhomeip/scripts/tools/zap
python3 zap_download.py

下面是安裝日志：

root@kurisaw-virtual-machine:/home/kurisaw/Desktop/esp/esp-gitee-tools/esp-matter/connectedhomeip/connectedhomeip/scripts/tools/zap# python3 zap_download.py
2023-06-19 13:28:22 root INFO Found required zap version to be: v2023.04.27-nightly
2023-06-19 13:28:22 root INFO Fetching: https://github.com/project-chip/zap/releases/download/v2023.04.27-nightly/zap-linux.zip
2023-06-19 13:29:20 root INFO Data downloaded, extracting ...
2023-06-19 13:29:25 root INFO Done extracting.
export ZAP_INSTALL_PATH=/home/kurisaw/Desktop/esp/esp-gitee-tools/esp-matter/connectedhomeip/connectedhomeip/.zap/zap-v2023.04.27-nightly
Step3：配置zap環境變量
我們看上面 zap 安裝日志，其中最后導出了zap 的安裝路徑為/home/kurisaw/Desktop/esp/esp-gitee-tools/esp-matter/connectedhomeip/connectedhomeip/.zap/zap-v2023.04.27-nightly，在此目錄下有個 zap 腳本，我們這個位置一定要記住！！

設置ZAP_DEVELOPMENT_PATH環境變量（這里的路徑需要根據上面安裝zap后提示的路徑進行設置，不能一昧照抄）

export ZAP_DEVELOPMENT_PATH=/home/kurisaw/Desktop/esp/esp-gitee-tools/esp-matter/connectedhomeip/connectedhomeip/.zap/zap-v2023.04.27-nightly
Step4：運行zap引導程序

執行如下代碼：

./run_zaptool.sh

效果如下：

Step4：為了方便我們后續使用zap，我們設置root終端下自啟動：
sudo su
vi ~/.bashrc
在.bashrc文件最末添加如下代碼，也就是配置zap環境變量

export ZAP_DEVELOPMENT_PATH=/home/kurisaw/Desktop/esp/esp-gitee-tools/esp-matter/connectedhomeip/connectedhomeip/.zap/zap-v2023.04.27-nightly
保存退出！

應用程序構建
在官方文檔中提供有兩種構建方式：

通過腳本構建
使用 Gn 和 Ninja 命令構建

1.通過腳本構建

./build_script.sh EXAMPLE_DIR OUTPUT_DIR [ARGUMENTS]
build_script.sh 是腳本的文件名；
EXAMPLE_DIR 是示例項目的目錄路徑；
OUTPUT_DIR 是構建輸出的目錄路徑；
[ARGUMENTS] 是可選的其他參數，用于設置gn和ninja命令的選項。

1.1 構建示例
./scripts/examples/gn_build_example.sh examples/placeholder/linux out/debug/simulated/ chip_tests_zap_config="app1"
"

1.2 運行構建

./out/simulated/chip-app1

2.通過 gn 和 ninja 構建應用程序

2.1 構建示例

source scripts/activate.sh
gn gen --check --root=examples/placeholder/linux out/simulated --args="chip_tests_zap_config="app1""
ninja -C out/simulated

2.2 運行構建

cd
./out/app1/chip-app1

測試應用程序
在前面的應用程序構建那一節中我們已經完成了應用程序的構建并且成功運行了構建，同時我們在日志中也可以看到生成了QR碼的鏈接，我們將其復制到瀏覽器打開即可得到二維碼

我們使用chip tool結合生成的QR碼進行調試，重新打開一個終端，使用默認的chip tool工具（記住不是之前構建應用程序生成的chip tool），通過QR碼可以快捷迅速地將虛擬設備添加到網絡中，我們使用chip tool對設備進行調試：

cd out/debug
./chip-tool onoff on 0x654321 1
./chip-tool onoff off 0x654321 1
./chip-tool onoff read accepted-command-list 0x654321 1
./chip-tool onoff read on-time 0x654321 1