开发主要版本更新

当您在潜在的新版本中所做的更改无法保证模块用户的向后兼容性时,您必须更新到主要版本。例如,如果您更改模块的公共 API 以破坏使用该模块先前版本的客户端代码,您将进行此更改.

注意: 每个发布类型 – 主要、次要、补丁或预发布 – 对模块的用户都有不同的含义。这些用户依靠这些差异来了解版本对他们自己的代码所代表的风险级别。换句话说,在准备发布时,请确保其版本号准确地反映了自上一版本以来更改的性质。有关版本号的更多信息,请参阅模块版本编号.

另请参见

主要版本更新的注意事项

仅在绝对必要时才应更新到新的主要版本。主要版本更新对您和您的模块用户来说都意味着重大的改动。在考虑主要版本更新时,请考虑以下事项:

主要版本的分支

在准备开发新的主要版本时,处理源代码最直接的方法是在先前主要版本的最新版本中分支存储库。

例如,在命令提示符下,您可以更改为模块的根目录,然后在那里创建一个新的 v2 分支。

$ cd mymodule
$ git checkout -b v2
Switched to a new branch "v2"

Diagram illustrating a repository branched from master to v2

分支源代码后,您需要对新版本的源代码进行以下更改:

有关发布步骤,请参阅发布模块 发布模块.