升级 Font Awesome

了解 Font Awesome 版本结构

Font Awesome 遵循一种修改过的语义版本方案，该方案会影响升级的方法。了解此结构对于成功升级至关重要。

来源： README.md48-67

一般升级注意事项

在升级 Font Awesome 之前，请考虑以下关键点

版本状态:
- 版本 6：当前活动版本
- 版本 5：长期支持 (LTS) - 仅限关键错误修复
- 版本 3 和 4：生命周期结束 (EOL) - 未计划进一步更新
破坏性变更:
- 次要版本更新可能包含重大更改（与标准 SemVer 不同）
- 补丁版本永远不会引入重大更改
图标保留:
- 在次要版本或补丁版本中永远不会移除图标
- 图标设计可能在任何版本中都会发生变化
文档:
- 始终参考变更日志以获取有关更改的详细信息

来源： README.md14-22 README.md56-67 UPGRADING.md3

升级决策图

来源： README.md14-22 README.md31-35

Web 实现升级

Web 实现是最常用的 Font Awesome 版本，包含用于 Web 项目的 CSS、JavaScript 和 SVG 文件。

Web 实现的升级路径

来源： README.md34 UPGRADING.md7

Web 升级的关键考虑因素

在升级 Font Awesome 的 Web 实现时，请考虑以下几点

CSS 类更改:
- 类命名约定在主要版本之间可能会发生变化
- 检查已弃用或重命名的类
JavaScript API 更改:
- 函数签名和方法名称可能会更改
- 导入语句可能需要更新
SVG 图标:
- 图标名称可能会被标准化或更改
- SVG 结构可能在版本之间进行优化
打包大小:
- 更新的版本可能有不同的捆绑大小
- 如果可用，考虑使用 tree-shaking

来源： README.md34 UPGRADING.md7

桌面实现升级

Font Awesome 的桌面实现用于原生桌面应用程序，需要特定的升级考虑。

桌面实现的升级路径

来源： README.md35 UPGRADING.md8

桌面升级的关键考虑因素

在升级 Font Awesome 的桌面实现时，请考虑以下几点

字体文件更改:
- 字体文件格式可能会改变
- 字形映射可能已更新
集成方法:
- 字体如何集成到您的桌面应用程序中
- 系统级字体安装与应用程序捆绑
许可注意事项:
- 确保符合 SIL OFL 1.1 字体许可证
- 署名要求

来源： README.md35 README.md75-77 UPGRADING.md8

特定版本升级说明

从 v5 升级到 v6

从 Font Awesome 5 (LTS) 升级到 Font Awesome 6 的主要区别

方面	更改
图标名称	某些图标可能已标准化命名约定
CSS 类	新类可能可用，旧类可能已弃用
JavaScript API	可能的功能签名更改
图标样式	可能提供更多样式
捆绑包结构	不同的文件组织和优化选项

从 v3/v4 升级到 v6

从 EOL 版本（3.x 或 4.x）升级到 v6 时

方面	更改
CSS 框架	CSS 类和结构的完全重写
图标名称	显著的图标名称更改和标准化
图标样式	现在提供多种样式（Solid、Regular 等）
JavaScript API	全新的 JavaScript API 和功能
集成方法	集成和优化新方法
浏览器支持	更新的浏览器兼容性要求

来源： README.md14-19

其他资源

有关升级 Font Awesome 的更详细信息，请参阅这些资源

官方文档:
- Web 升级指南
- 桌面升级指南
版本信息:
- 有关 Font Awesome 如何处理版本的信息，请参阅版本策略
更改历史:
- 有关版本之间的详细更改，请参阅变更日志和版本历史记录
问题报告:
- 如果在升级过程中遇到问题，请通过贡献指南提交问题

来源： README.md31-35 UPGRADING.md1-10