更新核心

update 组件允许您的 ESPHome 设备从远程源安装更新；设备可以自行获取更新并安装，而不是将更新”推送”到您的设备。

# 示例配置条目
update:
  - platform: ...

配置变量

• id (可选, ID)：手动指定用于代码生成的 ID。必须指定 id 和 name 中的至少一个。
• name (可选, string)：更新实体的名称。必须指定 id 和 name 中的至少一个。

NOTE

如果您为设备设置了 friendly_name，并且希望灯光使用该名称，可以设置 name: None。

• device_class (可选, string)：更新实体的设备类别。请参阅 https://www.home-assistant.io/integrations/binary_sensor/#device-class 获取可用选项列表。

• disabled_by_default (可选, boolean)：如果为 true，则此实体不应添加到任何客户端的前端（通常是 Home Assistant），除非用户手动启用（通过 Home Assistant UI）。默认为 false。

• entity_category (可选, string)：更新实体的类别。请参阅 https://developers.home-assistant.io/docs/core/entity/#generic-properties 获取可用选项列表。

• icon (可选, icon)：前端中更新实体使用的图标。

• internal (可选, boolean)：将此组件标记为内部组件。内部组件不会暴露给前端（如 Home Assistant）。指定 id 而不指定 name 会

• on_update_available (可选, 动作)：当有可用更新时要执行的自动化。

• 如果启用了 Webserver 并选择了版本 3，则支持 Webserver 组件的所有其他选项。请参阅 Webserver 版本 3。

自动化

update.perform 动作

此动作允许您触发更新实体开始更新过程。

配置变量：

• id (必填, ID)：更新实体的 ID。
• force_update (可选, boolean)：即使设备已运行相同版本也执行更新。默认为 false。

update.check 动作

此动作允许您触发更新实体检查（但不安装）更新。

配置变量：

• id (必填, ID)：更新实体的 ID。

update.is_available 条件

此条件检查设备是否有可用更新。

配置变量：

• id (必填, ID)：更新实体的 ID。

更新平台

• HTTP 请求
• ESP32 托管