三 Home Assistant 设置开发环境

设置开发环境
如果您想要为 Home Assistant 开发新功能或组件，就需要设置开发环境。继续阅读以了解如何设置。
准备环境
在 Linux 上开发
安装核心依赖项。

$ sudo apt-get install python3-pip python3-dev python3-venv

为了运行下面的script/setup，您还需要一些其他依赖项。

$ sudo apt-get install libssl-dev libxml2-dev libxslt1-dev libjpeg-dev libffi-dev libudev-dev

不同的发行版有不同的软件包安装机制，有时软件包名称也不同。例如，Centos 会使用：

$ sudo yum install epel-release && sudo yum install python34 python34-devel mysql-devel

如果您计划进行前端开发，还存在其他依赖项，请阅读前端部分以了解更多信息。
在 Windows 上开发
如果您将 Windows 用作开发平台，请确保已安装正确的 Microsoft Visual C++ 构建工具。有关详细信息，请查看 Python 网站上的 Windows 编译器部分。如果未正确完成此操作，使用tox进行验证将失败。
另外，请确保安装或升级setuptools Python 软件包。它包含兼容性改进并添加了对编译器的自动使用：

$ pip install --upgrade setuptools

在 OS X 上开发
安装 Homebrew，然后使用它来安装 Python 3：

$ brew install python3

设置本地仓库
访问 Home Assistant 仓库并点击 “Fork”。一旦完成 Fork，使用以下命令设置源代码的本地副本：

$ git clone https://github.com/YOUR_GIT_USERNAME/home-assistant.git
$ cd home-assistant
$ git remote add upstream https://github.com/home-assistant/home-assistant.git

设置虚拟环境（可选）
如果您计划使用venv为环境提供隔离。在home-assistant目录中，创建并激活虚拟环境。

$ python3 -m venv venv
$ source venv/bin/activate

设置并运行

$ cd home-assistant
$ script/setup

运行hass以调用本地安装。
日志记录
默认情况下，Home Assistant 中的日志记录是为在生产环境中运行而调整的（默认设置为 INFO，一些模块设置为更不详细的日志记录级别）。
您可以使用日志记录器组件将日志记录调整为 DEBUG，以查看有关正在发生的事情的更多详细信息。
总结
详细说明了为 Home Assistant 搭建开发环境的流程。涵盖在不同操作系统下准备环境的方法，如 Linux 需安装多种依赖包且不同发行版有别，Windows 要确保安装特定构建工具及升级软件包，OS X 借助 Homebrew 安装 Python 3。接着介绍了设置本地仓库的步骤，以及可选的虚拟环境设置操作，还有如何进行安装运行和对日志记录的相关设置。整体为开发者提供了从环境准备到项目启动及调试的全面指导，有助于顺利开展 Home Assistant 的开发工作，无论是新功能还是组件开发都能依此进行环境搭建。