前言

Home Assistant 是一款智能家居管理系统的开源库。
官方文档：

运行

环境：Debian + VSCode

备注：建议在 Linux 下运行，Windows 请按照官方文档安装配置 WSL（Windows Subsystem for Linux）

core+frontend

core 也即 ha 的核，是核心部分，frontend 是 core 可以装载的一个零件。在组装任何零件之前，首先需要把 core 跑起来。

1. 下载源码

从 github 下载源码到本地 core & frontend
在这里插入图片描述

安装 VSCode for Linux 与 Docker

安装 nvm（nodejs 版本管理工具）

2. 安装依赖

运行以下指令安装 Python 及相关组件：

sudo apt-get install python3-pip python3-dev python3-venv autoconf libssl-dev libxml2-dev libxslt1-dev libjpeg-dev libffi-dev libudev-dev zlib1g-dev pkg-config libavformat-dev libavcodec-dev libavdevice-dev libavutil-dev libswscale-dev libavresample-dev libavfilter-dev ffmpeg

使用 VSCode 打开 core 文件夹。（安装配置好了 Docker）VSCode 自动弹窗，确认“在 Container 中打开”。
在 VSCode 中 Ctrl+Shift+P 打开任务面板
Tasks: Run Task -> Install all Requirements 安装项目需要的所有依赖

3. 组装 frontend

组装 frontend 其实就是在已经打开的 core 中配置 frontend 源码的路径，告诉 core 可以在哪里找到零件。

在之前打开的 core 的容器中找到 .devcontainer/devcontainer.json，添加一个配置项，装载 frontend。

"mounts": [
    "source=~/frontend,target=/workspaces/frontend,type=bind,consistency=cached"
],

其中 ~/frontend 需要替换成您的 frontend 文件夹的路径（建议使用绝对路径）；
后面的 target 就是我们装载后 frontend 所在的路径（/workspaces/frontend）。

找到 config/configuration.yaml，告诉 core 零件的位置（使用上一步中 target 的路径即可）。

4. 配置 nodejs

在 frontend 文件夹下打开终端。
安装 nodejs：运行 nvm install 安装合适版本的 nodejs。（frontend 还是使用的 nodejs，所以需要安装使用 nodejs）
启用 nodejs：运行 nvm use
安装 bootstrap 依赖：运行 sh script/bootstrap