动作自动释放

GitHub 自动发布

此操作通过自动上传资产、生成变更日志、处理预发布等来简化 GitHub 发布流程。

内容

1. 使用示例
2. 支持的参数
3. 事件触发器
4. 版本控制
5. 如何获得帮助
6. 执照

注意： marvinpinto/action-automatic-releases存储库是包含此操作和其他操作的 marvinpinto/actions monorepo 自动生成的镜像。请在那里提交问题并拉取请求。

使用示例

当变更发生在 master 上时自动生成预发布

一旦更改发生在master上，此示例工作流程就会启动。运行构建和测试项目的步骤后：

1. 它将创建（或替换）一个名为latest的 git 标签。
2. 根据此标签与上一个latest标签之间的所有提交生成变更日志。
3. 生成与latest标签关联的新版本（删除任何以前的关联版本）。
4. 使用指定的标题更新此新版本（例如Development Build ）。
5. 上传LICENSE.txt和任何jar文件作为发布资产。
6. 将此版本标记为pre-release 。

您可以在 marvinpinto/actions 上查看此工作流程的工作示例。

---
name : " pre-release "

on :
  push :
    branches :
      - " master "

jobs :
  pre-release :
    name : " Pre Release "
    runs-on : " ubuntu-latest "

    steps :
      # ...
      - name : " Build & test "
        run : |
          echo "done!"

      - uses : " marvinpinto/action-automatic-releases@latest "
        with :
          repo_token : " ${{ secrets.GITHUB_TOKEN }} "
          automatic_release_tag : " latest "
          prerelease : true
          title : " Development Build "
          files : |
            LICENSE.txt
            *.jar

当标签推送到存储库时创建新的 GitHub 版本

与前面的示例类似，一旦新标签推送到 GitHub，此工作流程就会启动。构建并测试您的项目后：

1. 从此标记与上一个 semver 标记之间的所有提交生成变更日志。
2. 生成新版本并将其与此标签关联。
3. 上传LICENSE.txt和任何jar文件作为发布资产。

marvinpinto/actions 上再次有一个这样的例子。

---
name : " tagged-release "

on :
  push :
    tags :
      - " v* "

jobs :
  tagged-release :
    name : " Tagged Release "
    runs-on : " ubuntu-latest "

    steps :
      # ...
      - name : " Build & test "
        run : |
          echo "done!"

      - uses : " marvinpinto/action-automatic-releases@latest "
        with :
          repo_token : " ${{ secrets.GITHUB_TOKEN }} "
          prerelease : false
          files : |
            LICENSE.txt
            *.jar 

支持的参数

范围	描述	默认
repo_token **	GitHub Action 令牌，例如"${{ secrets.GITHUB_TOKEN }}" 。	null
draft	将此版本标记为草稿？	false
prerelease	将此版本标记为预版本吗？	true
automatic_release_tag	用于自动发布的标签名称，例如latest 。	null
title	发布标题；如果未指定，则默认为标签名称。	标签名称
files	作为发布资产的一部分上传的文件。	null

输出

可以通过${{ steps..outputs. }}访问以下输出值：

姓名	描述	类型
automatic_releases_tag	此操作刚刚处理的发布标签	细绳
upload_url	用于将其他资产上传到版本的 URL	细绳

笔记：

• 带**的参数为必填项。
• files参数支持多行 glob 模式，请参阅存储库示例。

事件触发器

GitHub Actions 框架允许您对许多事件组合触发此（和其他）操作。例如，您可以为候选版本标签创建特定的预版本（例如*-rc* ）、在主版本发生更改时生成版本（上面的示例）、夜间版本等等。通读 GitHub Actions 的工作流语法以获取想法和高级示例。

版本控制

该项目在 master 上的每次提交都会触发自动构建以及名为latest的标记发布。如果您不想生活在最前沿，您可以使用稳定版本。请参阅可用版本的发行版。

"">

- uses : " marvinpinto/action-automatic-releases@ " 

如何获得帮助

该项目的主要自述文件包含大量与调试和提交问题相关的信息。如果您仍然遇到困难，请尝试在 keybase 上联系我，我会尽力帮助您。

执照

该项目的源代码是根据 MIT 许可证发布的。该项目与 GitHub 没有关联。