ToC
前言
大家好,好久不见,我是某昨。
最近的闲暇时间基本都花在了填坑 Annix
上,可以说是小有成色。抛开被各种 Bug 折磨不谈,这期我们来简单讲一讲 CI/CD
的那些事。Annix
的 CI/CD
自动化基本可以分为三个阶段:Artifacts
、Release
和 Play Store
,我们一个个讲起。
Artifacts 时代
在今年的4月8日,Annix
首次进入了自动集成时代。提交 6320ffc 首次引入了对 Android
客户端的构建自动化,主要目的在于测试提交的代码是否能够正确编译,并提供一个还算一个能够下载构建结果的平台。
GitHub Artifacts 最长能够将上传的文件保存 90 天,对于即时开发+简单试用的场景还是足够试用的。它的优势在于:
- 方便抄作业,使用
actions/upload-artifact
就可以直接把结果上传,简单暴力
但还是存在一些问题:
- 会过期就是会过期,相比于
Release
还是有点不大方便 - 下载
Artifacts
需要GitHub
帐号登录。虽然这个阶段的项目参与者都是满足这一点的,但在外面不方便登录的时候还是有点麻烦 - 这个
Artifacts
藏得确实是有点深,每次都要点击跳转好几次才能到达这个页面 - 打包上传的所有文件都会被打成一个压缩包,不能按需选择
不过这个阶段参与测试的大家都本地自备 flutter
开发环境,所以一直没什么问题(x
Release 时代
随着 Annix
对 Flutter Desktop
支持的不断完善,原先的仅 Android CI
流程已经不能满足使用需求。于是从提交 43ba66a 开始,我们开始采用了一种更加合理的发布方式:GitHub Release
。
Release 部分的作业neovim
的构建部分。其基本思路是每个平台各自运行自身的构建任务,同时将构建结果上传到 Artifacts
中。待所有任务完成后,publish
任务将待发布的包从 Artifacts
上下载下来,通过 GitHub Cli
发布到 Release
中。
因为是抄的 nvim
的作业,所以这个任务是 Tag
触发 + Cron
+ 手动触发三部分组成的。nightly
会每天构建一次;当提交包含 Tag
的时候也会自动触发构建;此外,我们还可以手动触发构建并指定 Tag
。
不过这样一来,立即测试的需求就不大好满足了。所以在 nightly
之外,又新加了一个 canary
版本,用于对每次提交进行构建:
在这个阶段,我们也尝试了一些包管理的方案,比如 AUR
和 homebrew
。但这块一直没时间具体去弄,所以就暂时搁置了(x
Play Store 时代
如果说前文所述的部分还是 CI
的范畴的话,那自动发布到 Play Store
则是 CD
的一大步。从 3c5ae90 开始的一系列撞坑中,最终 Annix
实现了向 Play Store
发版的全自动流程。
整体思路简单来讲就是先准备好完整签名后的 appbundle
,然后通过 r0adkll/upload-google-play
登录 Service Account
调用 API
进行发布。这里可以说真实撞到了 114514 个坑,简单总结的话就是:
- 在应用刚刚创建,没有发布过的时候,不能直接通过
Action
发布,会提示找不到包名。我们需要手动在Play
控制台上的某一个轨道上发布一个版本之后,后续才能自动把包名对应上。 - 应用需要通过签名,这部分可以参照
flutter
官网的的应用签名指导部分。 Service Account
需要赋予的权限是Owner
+ 管理者。只有Owner
才能被Play
控制台识别到,而只有管理者才有写入(发布)包的权限。- 如果使用
Secrets
保存凭据的话,Action
中需要使用${{ secrets.XXXXXX }}
。 Play Store
要求Build Number
是递增的,且不能重复。在GitHub Action
中,符合这一条件的是${{ github.run_number }}
,因此对于flutter
可以通过--build-number ${{ github.run_number }}
的方式指定构建号。不过这个数值和当前Action
是强绑定的,所以这个Action
后续就不能改名了。- 虽然
upload-google-play
里说status
是可选项,但如果没有这个字段的话发布会出错。所以status: completed
是必加的。https://github.com/ProjectAnni/annix/commit/bf9fb2a25e51505ee2935bf315e9c29af9a05cf0
至此,我们的发布流程终于告一段落了。
结语
有了 Play
版后,Annix
的测试版就可以简单地进行自动更新了。Play Store
的更新体验实在是比其他什么高到不知道哪里去了,没话说。不过能够任意发版的也只有 100 人上限的内部测试,其他轨道包括 alpha
都是需要经过审核的。但以之前几个应用的经验来看,除开第一次审核需要耗费较长时间,后续的审核都是相对较快的。所以没有太多需要担心的地方(大概)。
这一套组合拳下来,人首先感受到的是麻