使用GitHub的API,我不能得到发布列表,但我可以得到标签列表。

它们之间有什么区别?


它们之间有什么区别?

标记是指向特定提交的指针。这个指针可以添加一些额外的信息(标记创建者的身份、描述、GPG签名等等)。

标签是git的概念,而发布是GitHub更高级别的概念。

正如GitHub博客的官方公告所述:“发行版是具有变更日志和二进制资产的一流对象,它们呈现了Git工件之外的完整项目历史。”

发布是根据现有标签创建的,并公开发布说明和从GitHub下载软件或源代码的链接。

使用GitHub的API,我不能得到发布列表,但我可以得到标签列表。

当前版本的GitHub API没有公开一种管理发布(创建、更新……)的方法。我很确定用不了多久就会暴露的。

但是,目前可以列出特定存储库的版本和标记。

例如,下面的url将列出来自ReactiveUI的6个版本(截至今天)

https://api.github.com/repos/reactiveui/ReactiveUI/releases

而这个将列出来自同一个存储库的54个标记(截至目前)

https://api.github.com/repos/reactiveui/ReactiveUI/tags

创建一个版本目前处于一个涉及手工操作的过程中(添加发布说明,上传包,……)。这解释了为什么标签不能透明地视为发布。


如果你想要获得API更改的通知,你可以订阅GitHub API changes博客。

然而,如果你等不及了,GitHub API主页上写着“如果你有任何问题或请求,请联系技术支持。”这可以通过电子邮件到support@github.com或此联系表格来完成。

更新:

GitHub API现在允许操作版本。请看公告。