平时测试中发包的时候,笔者在打完包就直接拖到蒲公英上让它上传就完事了。不过前两天的会议上,测试小姐姐提出要在蒲公英上写明这次的测试包修改了什么内容。
笔者一想到上传完包还要一个个打字说明在这个包我修改了什么,立即强烈拒绝!但是测试小姐姐再三要求,碍于这确实是个好提议和会上坐着的老大,只好勉为其难地答应发包时写上改动内容T_T。但是懒惰如笔者,当然不会每次发包都手动打字啦,最好能打完包后自动把包和修改信息上传到蒲公英。
虽然嘴上说着不要不要,但笔者想到写个自动化脚本还是很兴奋的。本来想看看有没有现成的蒲公英自动上传脚本,在网上搜索了一下发现都不是很对胃口,想想还是自己写算了。所以今天花了半天写了这个脚本,在这里也分享一下相关的gradle配置,以供参考。
一、 自动上传蒲公英
向蒲公英这样的平台一般提供API用来做一些便利的操作,我们直接打开蒲公英文档,可以看到用于上传安装包的API和示例的上传方法,我们便采用其中的curl
的方法上传安装包。
上传接口的参数中,有三个是必填的,分别的uKey
、_api_key
和file
。uKey
和_api_key
我们在自己的蒲公英帐号上可以查看到,而file
参数需要我们提供apk
文件的路径,所以我们先想办法拿到路径。
这里我们定义一个方法:getApkPath()
,通过buildDir
+ 固定的outputs/apk/${buildType}/app-${buildType}.apk
地址来获取apk
路径。
def getApkPath() {
String buildType = getBuildType().toLowerCase()
return new File(buildDir, "outputs/apk/${buildType}/app-${buildType}.apk").absolutePath
}
复制代码
在getApkPath()
中我们需要知道编译打包和用的buildType
,这里定义一个方法getBuildType()
进行获取。本人对gradle
脚本不太熟悉,暂时通过打包参数来获取相应的buildType
,足以应付一般场景。
def getBuildType() {
Gradle gradle = getGradle()
String args = gradle.getStartParameter().getTaskRequests().toString()
if (args.contains("assembleRelease")) {
return "Release"
} else if (args.contains("assembleDebug")) {
return "Debug"
}
return "Debug"
}
复制代码
然后我们把上传命令封装在一个task
里:
task pgyer(type: Exec) {
String apiKey = "6767f341ee7ed1f9fd4699e6ed71e773" // todo 这里替换为自己的蒲公英的apiKey
String userKey = "0cf7164e5158effc01cc24c0667266c4" // todo 这里替换为自己的蒲公英的userKey
commandLine 'curl'
args '-k', 'http://www.pgyer.com/apiv1/app/upload',
'-F', "uKey=${userKey}",
'-F', "_api_key=${apiKey}",
'-F', "file=@${getApkPath()}"
}
复制代码
这样我们就在一个task
可以调用啦。进入Terminal
,gradlew clean assembleDebug pgyer
,gradle
脚本便会执行清理、编译打包、上传的工作。等命令执行完,我们便能在蒲公英上看到新鲜出炉的安装包了。
二、自动添加日志
笔者目前想到自动从git
记录中读取近期的log,进行一定格式化后上传到蒲公英。
首先我们来读取git的记录:
def getGitLog() {
return 'git log --pretty=format:"%s___in___%ad___by___%an" -10 --date=format:%c'.execute().text
}
复制代码
其中%s__in__%ad__by__%an
表示内容+日期+作者,-10
表示显示最近10条log,--date=format:%c
表示输出本地的日期时间。这里发现执行命令时如有空格不能输出git log
,所以使用___
来代替空格。
有时我们会想添加自定义的信息进去,所以需要一个参数用于传递自定义的信息,这里将参数定义为pgyerDesc
,然后在gradle
中获取pgyerDesc
:
if (project.hasProperty("pgyerDesc")) {
desc = pgyerDesc + "\n" + desc
}
复制代码
对于传入的参数pgyerDesc
,在Windows
中,输入中文会出现乱码,应该是编码格式的问题。笔者用的是Ubuntu
系统,所以不会有这个问题的出现。所以这个乱码的情况就交给Windows
的同学自己去解决啦。
好了,整合起来,蒲公英自动上传安装包和日志的gradle
脚本就实现了。
task pgyer(type: Exec) {
String apiKey = "6767f341ee7ed1f9fd4699e6ed71e773" // todo 这里替换为自己的蒲公英的apiKey
String userKey = "0cf7164e5158effc01cc24c0667266c4" // todo 这里替换为自己的蒲公英的userKey
String desc = getGitLog()
if (project.hasProperty("pgyerDesc")) {
desc = pgyerDesc + "\n" + desc
}
if (desc == null || desc.isEmpty()) {
desc = "保持沉默"
}
commandLine 'curl'
args '-k', 'http://www.pgyer.com/apiv1/app/upload',
'-F', "uKey=${userKey}",
'-F', "_api_key=${apiKey}",
'-F', "file=@${getApkPath()}",
'-F', "updateDescription=${desc}"
}
复制代码
三、总结
最后,为了保持功能模块分工清晰和代码复用,我们把新建一个pgyer.gradle
的文件,将这个task
单独存放起来。再在app
的build.gradle
中通过apply from
的方式引入pgyer.gradle
。我们运行gradlew assembleDebug pgyer -P pgyerDesc="请多多关注"
,就可以看到想要的效果了。
该脚本是在gradle4.4
的环境下进行,这里也做了一个Demo
放在Github上了,里面的一些参数设置可能根据小伙伴自己的需求再做调整。希望各位能够喜欢这篇蒲公英自动上传脚本的文章。