手把手教你如何巧用Github的Action功能

概念

GitHub ActionsGitHub 于2018年10月推出的持续集成服务。

那么何谓持续集成呢?

持续集成

持续集成(Continuous integration),也就是我们经常说的CI。它是一种软件开发实践,可以让团队在持续的基础上收到反馈并进行改进,不必等到开发后期才寻找和修复缺陷,常运用于软件的敏捷开发中。Jenkins就是我们常用的持续集成平台工具。

理解了持续集成的概念之后,下面我简单讲一下使用持续集成的好处:

  • 提高效率,减少了重复性工作:一些重复性的工作写成脚本交给持续集成服务执行。
  • 减少了人工带来的错误:机器通过预先写好的脚本执行犯错的几率比人工低很多。
  • 减少等待的时间:一套完备的持续集成服务涵盖了开发、集成、测试、部署等各个环节。
  • 提高产品质量:很多大公司在代码提交后都会有一套代码检视脚本(俗称门禁)来检查代码的提交是否符合规范,从而从源头遏制问题的产生。

Actions

相比较持续集成这个大概念,GitHub推出的 Actions 就显得非常轻量和巧妙了。Actions就相当于持续集成中的某个特定功能的脚本,通过多个actions的自由组合,便可实现自己特定功能的持续集成服务。

同时,Github为了方便大家使用 Actions,还专门做了一个 Actions市场, 真的是非常方便!

image

GitHub Actions 有一些自己的术语:

  • 1.workflow(工作流程):持续集成一次运行的过程,就是一个workflow
  • 2.job(任务):一个workflow由一个或多个jobs构成,含义是一次持续集成的运行,可以完成多个任务。
  • 3.step(步骤):每个job由多个step构成,一步步完成。
  • 4.action(动作):每个step可以依次执行一个或多个命令(action)。

workflow文件

GitHub Actions 的配置文件叫做workflow文件,存放在代码仓库的.github/workflows目录, 如下图所示:

image

workflow文件采用YAML格式,文件名可以任意取,但是后缀名统一为.yml,比如上图的package.yml

workflow文件的配置字段非常多,详见官方文档 。下面是一些基本字段:

  • 1.name: workflow的名称。如果省略该字段,默认为当前workflow的文件名。
  • 2.on: 触发workflow的条件,通常是某些事件,例如:releasepushpull_request等。详细内容可以参照 官方文档
  • 3.jobs: workflow文件的主体内容,表示要执行的一项或多项任务。
    • jobs.<job_id>.name: job_id是任务的id,name是任务的描述。
    • jobs.<job_id>.runs-on: runs-on运行所需要的虚拟机环境,它是必填字段。
    • jobs.<job_id>.needs: needs指定当前任务的依赖关系,即运行顺序。
    • jobs.<job_id>.steps: steps指定每个任务的运行步骤,可以包含一个或多个步骤。

Actions的应用

如何使用Action发布flutter插件

之前我写过一篇《Flutter Plugin插件开发填坑指南》 ,讲的就是如何开发一个flutter插件并进行发布。但由于我们发布插件到 flutter插件平台 需要访问外网,而且还需要给命令终端设置代理,所以每次的发布都非常的麻烦。

一个偶然的机会,我就在Action市场中发现了一个publish-dart-flutter-package插件,可以一键把自己的插件发布到 flutter插件平台 ,脚本如下:

name: Pub Publish plugin

on: workflow_dispatch

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v1
      - name: Publish
        uses: sakebook/actions-flutter-pub-publisher@v1.3.0
        with:
          credential: ${{ secrets.CREDENTIAL_JSON }}
          flutter_package: true
          skip_test: true
          dry_run: false

当然你也可以参考我的flutter_xupdate ,它就是利用这个Action进行发布的。

这里我们可以看到,我们定义的触发条件是workflow_dispatch,也就是手动触发任务执行:需要我们点击 Run workflow => 选择 master 分支 => 点击 Run workflow,入下图所示:

image

这里我们注意到定义了一个secrets.CREDENTIAL_JSON常量,也就是我们的google账号认证证书,这里需要我们在项目的Settings => 选择 Secrets => 点击 New repository secret来创建一个属性名为CREDENTIAL_JSON的常量。对应的值你可以到你的用户Home目录下的.pub-cache文件夹下找到credentials.json文件。

image

下图是我执行了一次发布action的结果,只需2分钟,无需科学上网工具和给命令终端配置代理,即可完成flutter插件的发布,真的是非常方便!

image

如何使用Action打包apk

作为一名Android开发,你有没有想过每次提交代码或者发布版本的时候,github能够对应帮你自动打包出一个apk?

这样你既可以省去打包apk的时间,还免去了应用包的管理,岂不美哉?

那么我们应该怎么做呢?下面就是我实现的一个workflow脚本,主要的功能就是:在提交代码或者发布版本的时候,自动构建脚本打包出apk,同时直接上传至Artifacts存储。

name: Android CI

on:
  release:
    types: [published]
  push:
    branches:
      - master
    tags:
      - '2.*'
  pull_request:
    branches:
      - master

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: set up JDK 1.8
        uses: actions/setup-java@v1
        with:
          java-version: 1.8
      - name: release apk sign
        run: |
          echo "给apk增加签名"
          cp $GITHUB_WORKSPACE/.github/workflows/android.keystore $GITHUB_WORKSPACE/app/android.keystore
          sed '$a\RELEASE_STORE_FILE=./android.keystore'          $GITHUB_WORKSPACE/gradle.properties -i
      - name: build with gradle
        run: |
          echo "开始进行release构建"
          chmod +x gradlew
          ./gradlew app:assembleRelease
      - name : upload apk
        uses: actions/upload-artifact@master
        if: always()
        with:
          name: xupdate_apk
          path: ${{ github.workspace }}/app/build/outputs/apk/release

详细配置可以参考我的XUpdate 中的配置。

这里我们可以看到,我们定义的触发条件是releasepushpull_request,触发的分支是master,tags是2.*开头的。

整个任务主要分为4个步骤:

  • 1.set up JDK 1.8: 构建java1.8的环境。
  • 2.release apk sign:配置应用的签名。这里需要注意的是,这个地方的签名配置还是需要结合着build.gradle 文件的配置来编写的。
  • 3.build with gradle:编译构建apk。运行assembleRelease命令打release包。
  • 4.upload apk:上传apk至Artifacts

最后执行的效果如下:

image

如何使用Action来反击白嫖党

我在做开源项目的时候,经常能够碰到一些个无名小号(白嫖党),项目看都不看就提一些没有任何价值的issues,然后你好心好意地回复了,他却消失不见了...真的是让人恨得牙痒痒的!

是的,你没有看错,Action居然还可以用来反击白嫖党!这也是之前我在逛掘金的时候偶然看到一篇文章《❌ 对白嫖怪 SAY NO !!! —— 如何在 GitHub 上阻止无耻白嫖》 发现的。

那么他是怎么做的呢?其实也很简单,就是设置触发的条件是issues的创建,在创建的时候去查询一下issues的创建者是否star或者fork了该仓库,如果满足条件则不做处理,否则将自动锁住并关闭issues

当然,这位作者也是把这个非常骚的Action做成了一个插件,插件的地址是:https://github.com/marketplace/actions/no-free-usage-action ,使用起来非常简单。

以下是我简单使用的脚本案例:

name: No Free usage issue checker

on:
  issues:
    types: [opened, reopened]

jobs:
  build:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v2
      - name: Check issue actor
        uses: fluttercandies/no-free-usage-action@v1.0.1
        with:
          token: ${{ secrets.GITHUB_TOKEN }}  # 由GitHub提供的临时Token,必须在此处进行传递,且必须为这个值。
          forked: '--no-forked'
          words:  To support our project, please file the issue after you starred the repo. Thanks! 🙂

这里,我设置的触发条件是issues的打开和重新打开事件,设置不强制fork,但是需要star。当一只野生的白嫖党出没并在你的项目上提issues的时候,就会触发下图的效果:

image

看到上图的效果,是不是感到很惊喜,很刺激?你以为你做白嫖党我就没有办法治你?哈哈,给我老实点!

最后

都看到这儿了,还不赶紧三连支持一下,难道你也想做白嫖党吗?

更多资讯内容,欢迎搜索我的微信公众号:【我的Android开源之旅】

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,684评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,143评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,214评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,788评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,796评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,665评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,027评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,679评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 41,346评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,664评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,766评论 1 331
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,412评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,015评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,974评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,073评论 2 350
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,501评论 2 343

推荐阅读更多精彩内容