前言Github Actions 官方文档以下所有的官方文档的总入口对很多细节都进行了详细说明但是如果你是第一次接触看了很多关于细节的东西不知所云导致很快忘记。本篇文章从我项目的代码从总体上认识一下Actions。文章最后我会把一些重要的官方文档贴出 学会这些基础的再看其他的文档也就更能掌握Github Actions当代码push后符合配置的条件就会自动运行指定的操作。Github Actions 提供了免费硬件查看配置 来实在持续集成的操作。这些流程通过项目中的yml文件来配置。术语workflow表示一次持续集成的过程job表示构建任务每个 workflow 可以由一个或者多个 job 组成可支持并发执行 job所有 job 执行完也就代表着 workflow 结束step每个 job 由一个或多个 step 组成按顺序依次执行action每个step 由一个action组成 github 已经提供了一个[action 市场]可以搜索到各种第三方 actions自由组合这些actions来实现更复杂的操作查阅了很多文章GitHub Actions 入门教程Github Actions 尝鲜都说每个 step 由一个或多个 action 组成但是在具体的开发过程中发现steps的列表中并没有字段让我们设置多个actionuses只能设置一个action。更有文章甚至把step和action搞混每个 step 由一个或多个 action 组成按顺序依次执行这里 action 需要特别说明一下action 是可以是自定义脚本或引用第三方的脚本依赖着 github 开源社区许多 action 都可以直接复用也可自己编写github 已经提供了一个action 市场可以搜索到各种第三方 actions并且官方也提供了许多 actions。示例下面通过示例来看看具体如何使用。下面是Android的持续集成yml文件# workflow的名称会显示在github 的项目的Actions的右边列表中如下图name:DEBUG_CI# 在满足以下条件触发这个workflowon:push:# 在指定的远程分支上发生推送branches:-dev# 指定文件发生修改paths:-config.gradlejobs:# 多个job如果有多个每个以“-”开头first-job:# 该job 运行的系统环境支持ubuntu 、windows、macOSruns-on:ubuntu-lateststeps:# 下面是多个step 每个以“-”开头# step检查分支-uses:actions/checkoutv1# step设置jdk版本# step 名称-name:set up JDK 1.8# 引用公共actionuses:actions/setup-javav1with:# 设置参数java-version:1.8# step打包apk-name:Build with Gradle# 运行命令run:chmod x gradlew./gradlewassembleDebug#step上传apk 到action在右上角查看# 官方文档 https://help.github.com/cn/actions/automating-your-workflow-with-github-actions/persisting-workflow-data-using-artifacts#uploading-build-and-test-artifacts-name:Upload APKuses:actions/upload-artifactv1with:name:apppath:app/build/outputs/apk/debug/xw-debug.apk# step向蒲公英上传文件-name:Upload To Pgyeruses:JantHsueh/upload-file-actionmasterwith:url:https://www.pgyer.com/apiv2/app/uploadmethod:POST# ${{ secrets.pgyer_key }} 使用秘钥如何设置下面会介绍forms:{_api_key:${{ secrets.pgyer_key }},buildInstallType:3}fileForms:{file:app/build/outputs/apk/debug/xw-debug.apk}#step 获取apk版本号-name:Get Apk Info#step idid:apkuses:JantHsueh/get-apk-info-actionmasterwith:apkPath:app/build/outputs/apk/debug/xw-debug.apk#获取指定时区的时间-name:Get Timeid:timeuses:JantHsueh/get-time-actionmasterwith:timeZone:8# 调用接口修改数据库的版本号-name:Update SoftwareVersionuses:JantHsueh/webrequest-actionmasterwith:url:https://www.adsff123.com/app/guest/updateSoftwareVersionmethod:POST# ${{ steps.apk.outputs.versionCode }} 使用id为apk的step的输出参数versionCodepayload:{id:1,softwareType:1,recommend:1,versionDesc:App自动发布成功时间 ${{ steps.time.outputs.time}} \n5分钟后再点更新 \n8分钟后也可以 \n10分钟后最好,version:${{ steps.apk.outputs.versionNum }},versionNum:${{ steps.apk.outputs.versionCode }}}headers:{Content-Type: application/json,authorization:${{ secrets.update_software_version_key }},platform:android}#获取git log-name:Get git logid:git_loguses:JantHsueh/get-git-log-actionmasterwith:tag:release# 向钉钉发送消息-name:dingtalkuses:JantHsueh/webrequest-actionmasterwith:url:${{secrets.dingtalk_webhook}}method:POSTpayload:{msgtype: text, text: {content: 西雾代理商-测试版(debug)-App更新-版本号: ${{ steps.apk.outputs.versionNum }},可直接在App中更新到最新版 \n 距上个正式版的更新记录: \n${{ steps.git_log.outputs.log }}}}headers:{Content-Type: application/json}每个step 使用的action 如下编译打包执行命令 chmod x gradlew ./gradlew assembleDebug上传到蒲公英 https://github.com/JantHsueh/upload-file-action 这个action 可以上传任何文件到任何地址可自由设置参数获取apk信息 https://github.com/JantHsueh/get-apk-info-action获取指定时区的时间 https://github.com/JantHsueh/get-time-action获取git 的提交log日志 https://github.com/JantHsueh/get-git-log-action向钉钉发送消息 https://github.com/JantHsueh/webrequest-action每一项都给出github地址使用方式我在README.md都写了详细说明欢迎大家start这些Actions项目配置workflow上面介绍的workflow YAML文件需要放在项目根目录下.github/workflows/例如.github/workflows/debug-workflow.yml官方文档: 配置工作流程不同job之间对的数据传递官方文档 使用构件持久化工作流程数据action参数的输出输入参考了 官方文档创建 JavaScript Action中 —— 在工作流程中测试您的操作 的示例设置秘钥官方文档 Creating and using encrypted secrets自定义Action有两种创建Action的方式创建 JavaScript Action就是在Node.js 开发功能创建 Docker 容器 Action这种是创建一个docker 容器可以实现的操作就非常自由了Action 返回值是json如何使用在上面的示例中都是返回一个参数例如一个int一个string那如果返回json该如何引用呢官方文档没有明确的说明我在这个项目中看到有这样的使用大概是下面这样是在Ubuntu命令下解析json。但是我想把json中的指定参数作为下一个step 中action的参数传入始终不行。run:|$output${{steps.webhook.outputs.output}}|ConvertFrom-JsonWrite-HostTime from output $($output.time) statusCode $($output.statusCode) data $($output.data)请点赞、收藏感谢大家的支持有任何疑问可在评论区回复结语主要的基本内容就这些掌握这些后再去细看官方文档思路会更清楚。官方文档很多都是中文的而且写得也很清楚就不再赘述