0.92 集成变化

E部落 · 发表于 2019-4-26 15:45:58

本帖最后由 E部落于 2019-4-26 15:48 编辑

以下为机器翻译：

我们完成了伟大的迁移。结果将作为Home Assistant 0.92的一部分发布。发布有点延迟，因为我们有很多东西需要解决！完成迁移后，我们现在认为共享相同名称的组件和平台是同一集成的一部分。每个集成都是单个Python文件或带有的文件夹__init__.py。文件。我们更新了文档并引入了一个新的集成部分。

Home Assistant 0.92引入了一个新manifest.json的集成。此文件是自定义组件的可选文件，集成使用它来指定元数据：名称，文档链接，依赖项，要求和代码所有者。我们正在探索利用manifest.json其他未来功能，例如跟踪重大更改或允许自定义组件提供配置流并被发现。

通过所有这些更改，我们不得不放弃一些弃用的东西并改变一些行为：

平台不能再位于实体组件的目录中，例如light/my_platform.py。相反，创建一个新的my_platform你custom_components文件夹中创建一个空__init__.py文件，移动light/my_platform.py到my_platform/light.py。
平台不再具有依赖性或要求。而是manifest.json在my_platform文件夹中创建一个指定它们，或者为文件添加REQUIREMENTS或DEPENDENCIES常量__init__.py。
现在，平台将始终要求首先设置组件（如果可用）。
不再可能为单个Python文件中包含的组件提供翻译。将它们转换为目录中的集成。
如果要覆盖内置集成，则需要manifest.json为自定义集成指定a 。请注意，我们强烈建议不要覆盖内置集成。相反，如果要运行与自定义更改的集成，请更改集成名称。例如，如果要运行自定义版本的MQTT集成，请mqtt在Home Assistant中命名：
- 将mqtt文件夹的内容从Home Assistant存储库复制到新文件夹<config>/custom_components/mqtt_custom/
- 打开mqtt_custom/manifest.json并更改值domain从mqtt到mqtt_custom
- 打开mqtt_custom/__init__.py并更改值DOMAIN从mqtt到mqtt_custom
- 您引用的配置中的任何位置mqtt，引用mqtt_custom。因此，用于mqtt_custom:指定主机并platform: mqtt_custom在指定平台时使用。