开发 HASS.Agent 集成¶
概述¶
HASS.Agent 的集成开发与你在 HACS 上找到的所有自定义组件相同。基本思路是运行一个包含你开发版本的集成的 HA 开发容器。在你编码和编辑时，你可以在开发 HA 中测试你的更改。一旦完成，你将复制文件到仓库并创建一个 PR。
前置条件¶
- 开发 HA 容器 一个运行着基本 HA 安装的 docker 或其他容器，仅用于开发。你可以通过遵循 HA 开发文档 来获取该设置。
- VSCode 推荐使用，因为它与开发容器和运行任务以及与 HASS 接口的工作流程集成简单。可以继续不使用 VSCode 并使用任何文本编辑器，但我们不为其他编辑器提供教程。
Github 和文件¶
git 和本地文件夹的设置方式与大多数 Python 应用的标准方式略有不同，但并不难理解。
组织仓库¶
组织仓库是 HASS.Agent GitHub 组织 中找到的那个，它包含当前版本的集成，并且是你将从中分叉的。
你的仓库¶
你将分叉组织仓库，并拥有你自己的版本进行开发，完成工作后，你将向组织提交 PR。
本地目录¶
本地文件与你可能习惯的方式略有不同。它的工作方式是有一个文件夹，该文件夹反映了你的仓库分叉，然后在 HA 开发容器中有实际的集成。git 不直接跟踪开发容器中的文件夹的原因是，像 README 和 GitHub 工作流程这样的内容会导致 HA 出错。我们将在 设置 部分更详细地讨论这一点。