标签和版本升级的正确顺序

发布于 2024-11-29 07:55:43 字数 291 浏览 1 评论 0原文

我在 github 上有一个使用 rebar 的 library ,但它从未通过 git 进行标记。截至撰写本文时,app.src 文件表明它是版本 0.1(从未更改过)。

我想做一些提交,这将更改一些函数定义。我需要使用标签和应用程序版本,这样不会对用户产生负面影响,但我不清楚我应该标记、碰撞等的顺序。

我现在和将来要采取什么步骤为了确保用户可以编码到他们选择的版本?

I have a library on github which uses rebar, but it has never been tagged via git. As of this writing, the app.src file indicates it is version 0.1 (this has never been changed).

I'd like to make some commits which will change some of the function definitions. I need to use tags and application versions so this doesn't negatively impact users, but I'm unclear on the order I'm supposed to tag, bump, etc.

What steps do I take now and in the future in order to ensure that users can code to the version of their choice?

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(1

沦落红尘 2024-12-06 07:55:43

我在我的存储库中使用以下方案:

  • XYZ,其中 X 是主要的,Y 是次要的,Z 是补丁版本(从
    语义版本控制)
  • 我更改 .app.src 文件和标签的顺序如下:

    1. 进行更改,在 .app.src 文件中添加版本号并使用
      不错的提交消息。
    2. 使用与 .app.src 文件中相同的版本号提交的标记。我输入一个
      以下形式的标记消息:

      <前><代码>版本 XYZ

      - 新功能1
      - 新功能1
      - 修复这个和那个

      然后使用我的签名(使用 -s 标志)对标签进行 GPG 签名

    3. 使用 git push && 推送提交git push --tags 将提交和标签上传到服务器。

我不使用语义版本控制的“vX.YZ”方案作为标签,因为我认为它是多余的,而且看起来不太好。

一旦您有了正确的标记和版本控制(您选择的),您的用户应该能够依赖按原样使用 Git 标记。

您可以在这里看到结果:https://github.com/eproxus/meck(您需要下载用于查看标签消息并验证 GPG 签名的代码)。

I use the following scheme in my repositories:

  • X.Y.Z where X is major, Y is minor and Z is patch releases (taking some ideas from
    Semantinc Versioning)
  • The order I change .app.src files and tags is as following:

    1. Make the change, bump version number in the .app.src file and commit it with a
      nice commit message.
    2. Tag that commit using the same version number as in the .app.src file. I enter a
      tag message of the following form:

      Version X.Y.Z
      
      - New Feature 1
      - New Feature 1
      - Fix this and that
      

      The tag is then GPG signed with my signature (using the -s flag)

    3. Push the commit with git push && git push --tags to upload both the commit and the tag to the server.

I don't use semantic versioning's "vX.Y.Z" scheme as tags because I think it's superflous and doesn't look very good.

Once you have proper tagging and versioning (of your choice) your users should be able to rely on using the Git tags as is.

You can see the results here: https://github.com/eproxus/meck (you need to download the code to see the tag messages and verify the GPG signature).

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文