七 Home Assistant 开始折腾

开发入门的目标是让你熟悉为 Home Assistant 开发的基础知识。在开始之前，请确保你熟悉其架构。
为了让我们的代码在 Home Assistant 中运行，我们将创建一个自定义组件。第一步是找到你的配置文件夹。你可以通过打开 Home Assistant 前端，点击服务开发者工具图标来找到配置文件夹的路径。它是 “Path to configuration.yaml” 文本后面的路径。
在你的配置目录中创建一个名为custom_components的新文件夹。可能已经存在一个这样的文件夹，这也没关系。这是 Home Assistant 在查找自定义代码时会查看的文件夹。
Home Assistant API 有两个变体：同步版本和异步版本（asyncio）。本开发课程将重点关注同步版本。
为了验证一切是否正常工作，让我们创建一个简单的 “Hello World” 组件。为此，在你的自定义组件文件夹中创建一个名为hello_world.py的文件。将以下内容复制粘贴到其中：

# 你的组件的域。等于你的组件的文件名。
DOMAIN = "hello_world"


def setup(hass, config):
    """设置hello_world组件。"""
    # 状态的格式为DOMAIN.OBJECT_ID。
    hass.states.set('hello_world.Hello_World', 'Works!')

    # 返回布尔值以指示初始化成功。
    return True

总结
是 Home Assistant 开发入门教程的开篇部分，旨在引导新手开发者开始进行 Home Assistant 的开发工作。首先强调了熟悉架构的重要性，接着详细说明了创建自定义组件的前期准备工作，包括找到配置文件夹（通过前端开发者工具图标获取路径）以及在其中创建用于存放自定义代码的custom_components文件夹。然后介绍了 Home Assistant API 的两种版本，并明确本教程聚焦于同步版本。最后通过创建一个简单的 “Hello World” 组件示例，展示了创建组件的基本步骤，即定义组件的域并编写setup函数来设置组件状态，为后续深入学习开发更复杂的组件和功能奠定了基础，让开发者对开发流程有初步的认识和实践体验。