【教程】使用 Visual Studio Code - Dev Containers 调试 xiaomi home

[nuomi1]

经过两小时的调试，终于成功在 Dev Containers 运行并断点小米集成。下面提供简要流程，希望可以帮到大家～

以下操作均在 macOS 15.2 / Visual Studio Code 1.96.0 / OrbStack 1.9.2 完成，其他系统（环境、软件）可参考摸索：

1. mkdir -p ~/Documents/GitHub // 创建目录，可自定义
2. cd ~/Documents/GitHub // 进入目录
3. git clone https://github.com/home-assistant/core home-assistant/core // 克隆 Home Assistant 到本地
4. git clone https://github.com/XiaoMi/ha_xiaomi_home XiaoMi/ha_xiaomi_home // 克隆小米智能到本地
5. code home-assistant/core // 使用 Visual Studio Code 打开 Home Assistant 项目
6. 编辑 home-assistant/core/.devcontainer/devcontainer.json 文件 // 此时不要直接构建 Dev 容器
   1. 在 runArgs 数组的末尾增加 "--network=host" 命令 // 允许容器直接使用宿主机的网络（包括局域网）
   2. 增加 "mounts": ["source=${localEnv:HOME}/Documents/GitHub/XiaoMi/ha_xiaomi_home/custom_components/xiaomi_home,target=${containerWorkspaceFolder}/config/custom_components/xiaomi_home,type=bind"] 字段，与 runArgs 同层级 // source 目录可自定义，target 不可修改
7. 编辑 home-assistant/core/Dockerfile.dev 文件
   1. 在 apt-get install 末尾增加 iputils-ping // 使用 ping 命令
8. 回到 Visual Studio Code，键入 ⇧+⌘+P 呼出命令面板，执行 Rebuild Container 命令构建 Dev 容器
9. 在 Dev 容器中运行 Home Assistant
10. 待提示启动成功后使用 http://localhost:8123 打开 Home Assistant 网页
11. 按照 登录时“无法访问此页面”的问题解决办法 #6 提示登录获取 Token

---

diff --git forkSrcPrefix/.devcontainer/devcontainer.json forkDstPrefix/.devcontainer/devcontainer.json
index 44c38afdec6303bafad4156ee09970470eeee92f..ae6b25f46cd3c5948daba3cea550133ab96abe8c 100644
--- forkSrcPrefix/.devcontainer/devcontainer.json
+++ forkDstPrefix/.devcontainer/devcontainer.json
@@ -16,7 +16,8 @@
     "-e",
     "GIT_EDITOR=code --wait",
     "--security-opt",
-    "label=disable"
+    "label=disable",
+    "--network=host"
   ],
   "customizations": {
     "vscode": {
@@ -67,5 +68,8 @@
         ]
       }
     }
-  }
-}
+  },
+  "mounts": [
+    "source=${localEnv:HOME}/Documents/GitHub/XiaoMi/ha_xiaomi_home/custom_components/xiaomi_home,target=${containerWorkspaceFolder}/config/custom_components/xiaomi_home,type=bind"
+  ]
+}

diff --git forkSrcPrefix/Dockerfile.dev forkDstPrefix/Dockerfile.dev
index 5a3f1a2ae6480be49d1ea389a7beea21befac50a..7760ba4c8b6e09eb962c47823ac6bfdfd0ca06cb 100644
--- forkSrcPrefix/Dockerfile.dev
+++ forkDstPrefix/Dockerfile.dev
@@ -32,6 +32,7 @@ RUN \
         libxml2 \
         git \
         cmake \
+        iputils-ping \
     && apt-get clean \
     && rm -rf /var/lib/apt/lists/*