Home Assistant 库比蒂诺图标

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

多色图标！（v3.0+）

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

图标参考

v3.0 更新

• Home Assistant Cupertino Icons 现已升级至 SF Symbols v3.0，包含 3167 个图标！（不含受版权保护的图标）
• 支持 Home Assistant 的图标选择器（2021.11.0+）

SF Symbols | Apple SF Symbols Reference | SFSymbols.com

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

注意： 下划线（\_）和点号（.）必须替换为短横线（-）

重大变更

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

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

法律声明

某些图标受 Apple 版权保护，禁止修改后使用。这些图标未被导出，也未包含在本仓库中。它们不会被包含。

---

待办事项

☑️ 升级至 SF Pro Symbols v2.1 ☑️ 升级至 SF Pro Symbols v3.0 ☑️ 支持多色 ☑️ 图标选择器

更新日志

v4.0.1

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

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
• 支持多色图标
• 支持图标选择器
• 重构和优化布局
• 重大变更： 仓库类型已由前端/lovelace 插件更改为完整集成。你需要卸载、从 HACS 删除仓库并重新安装。

--- Tranlated By Open Ai Tx | Last indexed: 2025-07-29 ---