版本策略

相关源文件

• CHANGELOG.md
• README.md

目的与范围

本文档解释了 Font Awesome 的版本策略，包括版本号的分配方式、不同版本的当前支持状态以及适用于 Font Awesome 生态系统的特别注意事项。有关版本间升级的具体指导，请参阅 升级 Font Awesome。有关版本之间变更的详细历史记录，请参阅 变更日志和版本历史。

Font Awesome 的修改版语义化版本

Font Awesome 遵循语义化版本（SemVer）指南，并进行了重要修改，以适应其作为包含多种组件类型（图标、字体和代码）的综合图标库和工具包的独特性质。

来源： README.md48-68

版本支持状态

Font Awesome 为其各个版本维护着不同的支持级别

来源： README.md14-22

版本号和兼容性规则

主版本号（6.x.x）

Font Awesome 6 是一个“伞形发布”，包含了各种文件类型和技术。主版本号的更改通常包括重大的架构更改、大规模重新设计或库结构的实质性修改。

次版本号（6.y.0）

次版本号更新引入了新功能和增强功能。与标准的 SemVer 不同，Font Awesome 的次版本发布

• 可能包含向后不兼容的更改（并提供清晰的升级说明）
• 绝不会从库中移除图标
• 可能会更新现有图标的设计、外观或品牌标识

补丁版本号（6.0.z）

补丁版本发布解决 bug 和进行小型改进。在 Font Awesome 的版本控制中

• 补丁版本发布将永远不会破坏向后兼容性
• 绝不会移除图标
• 仍可能更新现有图标的设计或外观

以下是确定变更版本号的决策流程图

来源： README.md56-67

兼容性保证表

下表总结了 Font Awesome 在不同版本类型之间的兼容性保证

更改类型	主版本号	次版本号	补丁版本号
破坏性变更	✓	✓*	✗
新功能	✓	✓	✗
Bug修复	✓	✓	✓
图标移除	✓	✗	✗
图标设计更新	✓	✓	✓

*次版本号的破坏性更改要求在 UPGRADING.md 中提供清晰的升级说明

来源： README.md56-67

访问特定版本

Font Awesome 在关注当前版本开发的同时，也维护着之前的版本。用户可以访问

1. 当前版本（6.x）：可通过所有分发渠道获取
2. LTS 版本（5.x）：仅维护关键 bug 修复
3. 先前版本：可通过 GitHub release 获取

来源： README.md14-28

版本升级

在升级 Font Awesome 版本时，用户应查阅相应的升级指南

• 对于 Web 实现： Web 升级指南
• 对于桌面实现： 桌面升级指南

在升级可能包含向后不兼容更改的次版本时，应格外小心。UPGRADING.md 文件包含此类情况的具体说明。

来源： README.md30-35

变更日志和版本历史

Font Awesome 维护着详尽的变更日志，以记录版本之间的更改

• 当前变更日志可在 Font Awesome 网站上找到
• 历史版本可在 GitHub 仓库的 release 页面找到

来源： README.md24-28 CHANGELOG.md1-5

版本在各个组件之间的兼容性

Font Awesome 的版本策略必须考虑到其三个不同的组件，每个组件都有不同的许可模式

来源： README.md70-84

版本控制系统确保所有组件（图标、字体和代码）在相同的版本号下保持兼容性，尽管它们的许可模式不同且可能以不同的速率发展。