Home Assistant Cupertino 图标（SF Symbols）

Apple SF Symbols 图标用于 Home Assistant！（3000+ 图标）

安装

HACS（推荐）

• HACS 标签 > 菜单 > 自定义仓库
• 粘贴此仓库的URL
• 在下拉菜单中选择集成
• 从HACS安装cupertino-icons
• 重启 Home Assistant
• Home Assistant > 设置 > 集成 > 添加 > Cupertino Icons > 安装

这些图标现在应该可以在 Home Assistant 中使用了。如果没有显示，请尝试刷新页面、使用隐私浏览或重启 Home Assistant。

手动安装

• 复制 custom_components/cupertino 到你的 custom_components 文件夹中
• 重启 Home Assistant
• Home Assistant > 设置 > 集成 > 添加 > Cupertino Icons > 安装

这些图标现在应该可以在 Home Assistant 中使用了。如果没有显示，请尝试刷新页面、使用隐私浏览或重启 Home Assistant

用法

前缀：ios 例如：ios:lightbulb-fill | ios:cloud-moon-rain | ios:bed-double-fill

多色图标

SF Symbols 3+ 支持多色图标。此功能已移植到本仓库，以支持在 Home Assistant 中使用多色图标！

只需添加后缀 #color、#invert、#color-invert 或 #fullcolor 即可更改图标颜色！（感谢 thomasloven 提供灵感）

例如：

• ios:gear-badge-xmark#color
• ios:gear-badge-xmark#color-invert
• ios:gear-badge-xmark#fullcolor

图标参考

SF Symbols | Apple

您可以从 Apple 下载 MacOS 应用程序以获得更好的参考。

注意： 下划线（\_）和点号（.）必须用连字符（-）替换

重大更改

从 v3.0+ 开始，本仓库已从 lovelace/前端仓库更改为完整集成。如果您从旧版本升级：

• HACS > 卸载 "cupertino-icons"
• HACS > 菜单 > 自定义仓库
• 删除本仓库
• 按照上方 安装 说明操作

法律声明

受版权保护的图标未被导出且不包含在本仓库中。它们不会被包含。

更新日志

v5.0.1

• 品牌图标 #29（修复 #15）

v5.0.0

• 增加对 SF Symbols 7 的支持（感谢：@enzofrnt） #28
• 清理仓库中的 macOS Spotlight 文件

🎉 感谢所有为 v5.0 版本做出贡献的开发者！

v4.0.1

• 修复清单中的版本不匹配问题

v4.0.0

• 增加对 SF Symbols 6 的支持（鸣谢：@HoussamOtarid）
• 修复了 HA 2025.7.0 的弃用问题（鸣谢：@lnlyssg）

🎉 感谢所有为 v4.0 版本做出贡献的开发者！

v3.0.2

• 修复导致尺寸问题的错误

v3.0.1

• 修复了多色图标显示异常的错误

v3.0

• 升级到 SF Symbols 3.0
• 支持多色图标
• 支持图标选择器
• 重构和重组布局
• 重大变更： 仓库类型已从 frontend/lovelace 插件更改为完整集成。您可能需要卸载、从 HACS 删除仓库并重新安装。

--- Tranlated By Open Ai Tx | Last indexed: 2026-03-16 ---