4.4 KiB
title
| title |
|---|
| 后向兼容政策 |
随着Solana开发人员生态系统的发展，围绕打破API和行为更改（影响为Solana构建的应用程序和工具）的明确期望也将越来越高。 在一个完美的世界中，Solana的开发可以以非常快的速度继续进行，而不会给现有开发人员造成任何问题。 但是，将需要做出一些妥协，因此，本文档尝试澄清和整理新发行版的过程。
期望值
- Solana软件版本包括API，SDK和CLI工具(带有一些exceptions)。
- Solana软件版本遵循语义版本控制，更多详细信息请参见下文。
- 适用于
MINOR版本的软件将与同一MAJOR版本上的所有软件兼容。
弃用过程
- 在任何
PATCH或MINOR版本中，功能、API、端点等都可以标记为已弃用。 - 根据代码升级的难度，某些功能将在几个发布周期内被弃用。
- 在未来的
MAJOR版本中，不赞成使用的功能将以不兼容的方式删除。
发布时间
Solana RPC API、Rust SDK、CLI工具和BPF程序SDK均已更新并随每个Solana软件版本一起提供，并且应始终在特定MINOR版本的PATCH更新之间兼容。
发布频道
edge软件，其中包含最先进的功能，没有向后兼容策略- 在Solana Tour de SOL测试网集群上运行的
beta软件 - 在Solana Mainnet Beta和Devnet集群上运行的
stable软件
主要版本(x.0.0)
MAJOR版本(例如2.0.0)可能包含重大更改并删除了以前不推荐使用的功能。 客户端SDK和工具将开始使用在先前MAJOR版本中启用的新功能和端点。
次要版本(1.x.0)
新功能和建议实施已添加到_new_版本的MINOR版本(例如1.4.0)中，并且首先在Solana的Tour de SOL测试网集群上运行。 在测试网上运行时，MINOR版本被认为在beta发布渠道中。 在对这些更改进行了修补并证明是可靠的之后，MINOR版本将升级到stable发布渠道并部署到Mainnet Beta集群。
修补程序版本(1.0.x)
低风险功能，不间断的更改以及安全性和错误修复作为PATCH版本发行版(例如1.0.11)的一部分提供。 补丁可以同时应用于beta和stable发布渠道。
RPC API
补丁发布：
- Bug修复
- 安全修复
- 端点/功能弃用
次要版本：
- 新的RPC端点和功能
主要版本：
- 删除过时的功能
Rust Crates
solana-sdk- 用于创建交易和解析帐户状态的Rust SDKsolana-program- 用于编写程序的Rust SDKsolana-client- 用于连接RPC API的Rust客户端solana-cli-config- 用于管理Solana CLI配置文件的Rust客户端
补丁发布：
- Bug修复
- 安全修复
- 性能提升
次要版本：
- 新的 API
主要版本：
- 删除过时的API
- 向后不兼容的行为更改
CLI 工具
补丁发布：
- 错误和安全修复
- 性能提升
- 弃用子命令/参数
次要版本：
- 新的子命令
主要版本：
- 切换到先前主要版本中引入的新RPC API端点/配置。
- 删除过时的功能
Runtime功能
Solana新的runtime功能已进行功能切换并手动激活。 Runtime功能包括：引入新的本机程序，sysvars和syscalls；并改变他们的行为。 功能激活与群集无关，因此可以在Mainnet-beta上激活之前在Testnet上建立置信度。
发布过程如下：
- 新版本中包含新的runtime功能，默认情况下已禁用
- 一旦有足够的抵押验证程序升级到新版本，就可以通过指令手动激活runtime功能开关
- 该功能在下一个纪元开始时生效
基础架构变更
公共API节点
Solana提供了公开可用的RPC API节点，供所有开发人员使用。 Solana团队将尽最大努力将任何更改传达给主机，端口，限速行为，可用性等。 但是，我们建议开发人员依靠自己的验证器节点来阻止对Solana操作的节点的依赖。
本地集群脚本和Docker映像
重大更改将仅限于MAJOR版本更新。 MINOR和PATCH更新应始终向后兼容。
例外
Web3 JavaScript SDK
Web3.JS SDK还遵循语义版本控制规范，但与Solana软件版本分开提供。
攻击向量
如果在现有代码中发现了新的攻击媒介，则可以根据问题的严重性来规避上述过程，以便快速部署修复程序。