- Android 项目日常开发过程中,经常需要打包给到非开发人员验收或调试,例如测试阶段,就要经常基于测试服务器地址,打包安装包,给到组内测试人员进行测试,并且 BUG 修复完成之后也需要再次打包给到测试人员回测。
- 为了减免机械性的重复步骤,为项目配置不同的 渠道(Product Flavors),不同渠道对应不同的服务器地址,并且为每一个渠道创建一个 Gradle Task 执行打包并上传至蒲公英的操作,同时在蒲公英中配置 Webhook ,最终可实现:执行对应 **渠道(Product Flavors)**的 Gradle Task,即可自动打包并上传至蒲公英,并将包更新信息同步至企业微信、钉钉、飞书等工作群组,使得包更新流程可视化,并简化了开发和测试联调流程。
每个渠道的 Task 执行内容一致:打包并记录更新信息后上传至蒲公英 ,所以抽取公共内容(方法)创建如下 pgyer-upload.gradle 文件
import groovy.json.JsonSlurper
import java.net.http.HttpClient
import java.net.http.HttpRequest
import java.net.http.HttpResponse
import java.nio.charset.StandardCharsets
import java.nio.file.Files
import java.text.SimpleDateFormat
ext.uploadApk = this.&uploadApk
/**
* Sept 1 创建执行任务
*/
/**
* 蒲公英 ApiKey
* https://www.pgyer.com/account/api
* TODO 替换成自己的蒲公英 APIkey
*/
static String getApiKey() {
return "myApiKey"
}
/**
* 上传 apk 到蒲公英
* @apk 安装包文件
* @flavorName 渠道名
*/
def uploadApk(File apk, String flavorName) {
if (apk == null) {
throw new RuntimeException("apk file not exists!")
}
def apkName = apk.name
println "*************** Upload Init ***************"
//渠道信息
String buildFlavorName = flavorName
if (flavorName == "DemoRelease") {
buildFlavorName = "Test"
} else if (flavorName == "DevRelease") {
buildFlavorName = "Dev"
} else if (flavorName == "ProduceRelease") {
buildFlavorName = "Produce"
} else if (flavorName == "BetaRelease") {
buildFlavorName = "Beta"
}
println "flavorName = ${buildFlavorName} apkName = ${apkName} apkSize = ${apk.size()}"
// Git 提交信息
String commitLogStr = getGitCommitLogByCount(5)
// String commitLogStr = getGitCommitLogByToDay()
def appModule = project.rootProject.project(':app')
def appVersionName = appModule.android.defaultConfig.versionName
def appVersionCode = appModule.android.defaultConfig.versionCode
//更新信息
String updateDescription = "\n[${getBranchName()}]:${buildFlavorName}-${appVersionName}-${appVersionCode}" +
"\n${commitLogStr}"
println "updateDescription : ${updateDescription}"
println "*************** Upload Get Token ***************"
//组装cosToken需要的的参数,见https://www.pgyer.com/doc/view/api#fastUploadApp
List cosTokenParams = new ArrayList<>()
//API KEY
cosTokenParams.add(new KeyValue("_api_key", apiKey))
//属于android平台
cosTokenParams.add(new KeyValue("buildType", "android"))
//更新描述
cosTokenParams.add(new KeyValue("buildUpdateDescription", updateDescription))
// 获取上传的 token ,见 https://www.pgyer.com/doc/view/api#fastUploadApp
HttpResponse response = postFormData("https://www.pgyer.com/apiv2/app/getCOSToken", cosTokenParams)
def resp = new JsonSlurper().parseText(response.body())
println ">>>> Get Token Response :\n${response.body()}"
println "*************** Uploading Apk File ***************"
// 上传文件到第上一步获取的 URL,参数从上一步获取,这里需要解析参数
String paramsString = String.valueOf(resp.data.params)
String[] params = paramsString.substring(1, paramsString.length() - 1).split(',')
List list = new ArrayList<>()
if (params != null) {
for (i in 0.. uploadResponse = postFormData(resp.data.endpoint, list)
if (uploadResponse.statusCode() == 204) {
println(">>>> Upload Success ")
} else {
println(">>>> Upload Fail :" + uploadResponse.body())
}
println "*************** Upload Completed ***************"
}
static HttpResponse postFormData(String url, List list) {
long requestStartTime = System.nanoTime()
String boundary = "*********"
// Result request body
List byteArrays = new ArrayList<>()
// Separator with boundary
byte[] separator = ("--" + boundary + "\r\nContent-Disposition: form-data; name=").getBytes(StandardCharsets.UTF_8)
// Iterating over data parts
for (i in 0.. gitCommand = ${gitCommand}"
String description = gitCommand.execute().text.trim()
return description
}
/**
* 获取最近 n 条提交日志
*/
static String getGitCommitLogByCount(int count) {
//git 命令
String gitCommand = "git log -${count} --pretty=format:\"%s\""
//println "getUpdateDescription() --> gitCommand = ${gitCommand}"
String description = gitCommand.execute().text.trim()
return description
}
/**
* 获取分支名
*/
static String getBranchName() {
String gitCommand = "git rev-parse --abbrev-ref HEAD"
return gitCommand.execute().text.trim()
}
class KeyValue {
String key
String value
boolean isFile
KeyValue(String key, String value) {
this(key, value, false)
}
KeyValue(String key, String value, boolean isFile) {
this.key = key
this.value = value
this.isFile = isFile
}
@Override
String toString() {
return "{key:" + key + ", value:" + value + ", isFile:$isFile}"
}
}
该代码主要执行 APK 上传至蒲公英的操作,并上传指定更新内容:
在项目的 build.gradle 文件最外层执行
apply from: "pgyer-upload.gradle"
在 app module 的 build.gradle 文件 android 层内执行
/**
* Sept 3 配置渠道 (非必须)
*/
flavorDimensions "channel"
productFlavors {
// 生产环境
produce {
buildConfigField "String", "HOST", "\"${HOST}\""
}
// 预生产环境
beta {
buildConfigField "String", "HOST", "\"${HOST_BETA}\""
}
// 开发环境
dev {
buildConfigField "String", "HOST", "\"${HOST_DEV}\""
}
// 测试
demo {
buildConfigField "String", "HOST", "\"${HOST_TEST}\""
}
productFlavors.all {
// 遍历 productFlavors 多渠道,设置渠道号
flavor -> flavor.manifestPlaceholders.put("CHANNEL", name)
}
}
此处代码中的 produce、beta 、dev、demo 均为自定义的渠道名,可根据自身业务需求进行增删修改,其中 HOST 为自定义的变量名,不同渠道引用值不一样(示例中的值来源配置在项目的 gradle.properties 文件中,如下所示),项目编译后,在代码中即可通过 BuildConfig.FLAVOR 和 BuildConfig.HOST 获取当前编译环境的 渠道名 和 自定义变量 HOST 的值
# gradle.properties 文件内
# Host
HOST=https://hao123.com
HOST_BETA=https://hao123.com:1008
HOST_TEST=https://hao123.com:1010
HOST_DEV=https://hao123.com:1024
Android Studio 中,可通过左下方 Build Variants 手动切换编译渠道
同样在 app module 的 build.gradle 文件 android 层内执行
/**
* Sept 4 创建打包 Task
* 遍历所有可执行的 variants 创建对应的打包 Task
* 生成后的路径及名称:Tasks/build/pushApk[productFlavorsName][Release/Debug]
* eg:Tasks/build/pushApkDevRelease
*/
android.applicationVariants.all { variant ->
String taskSuffix = variant.name.capitalize()
if (taskSuffix.contains("Release") || taskSuffix.contains("Debug")) {
task("pushApk${taskSuffix}") {
dependsOn ":app:assemble${taskSuffix}"
group 'build'
description 'Custom task for gradle'
doLast {
variant.outputs.all { output ->
// 执行脚本任务
uploadApk(output.outputFile, taskSuffix)
}
}
}
}
}
按上述步骤操作之后,先执行 Sync Project with Gradle Files 生成不同渠道对应的打包 Task
然后可通过以下两种方式进行执行打包并上传的脚本任务
在 Android 应用程序构建过程中,变种(variants)是指基于不同构建配置或渠道进行构建的应用程序版本。
Android Gradle 插件使用变种来生成不同版本的应用程序,以满足不同的需求,如不同的构建类型、不同的渠道或不同的产品变体等。
每个变种具有自己的构建配置和特定的属性设置,例如包名、应用图标、应用名称等。通过创建不同的变种,可以实现以下目标:
1.构建类型(Build Types):构建类型定义了不同的构建环境和配置,例如调试版(Debug)和发布版(Release)。每个构建类型可以具有自己的代码、资源、签名证书、编译标志等。
2.渠道(Product Flavors):渠道是为了满足不同目标市场或用户群体的需求而定义的版本变体。通过渠道,可以为不同的渠道定制应用程序的内容,如应用程序图标、名称、启动画面、配置文件等。
3.变体(Build Variants):变体是构建类型和渠道的组合,表示一个具体的应用程序版本。每个变体都有其自己的构建输出,如 APK 文件或可安装的应用程序包。
通过定义和配置不同的变种,开发人员可以轻松地构建适用于不同需求的不同版本的应用程序,以便进行测试、发布和分发。
该问题产生的原因是当前项目 JDK 版本 > 11 ,而当前 Gradle Task 内执行的文件 POST 操作是自行封装的请求参数,该封装在 JDK 版本 > 11 的情况下,无法被服务器正常识别,猜测原因是自定义包装请求参数过程中出现了偏差导致。
最后的解决方案是:
1.降低项目 JDK 版本为 11 或以下即可解决该问题(大部分情况下需要同步修改项目的 Gradle 和 Gradle Plugin 版本,改动较大,不建议)
2.改用自定义 Gradle 插件形式创建 Task ,即可在 Task 中引用第三方的网络请求库如 OKHttp ,使用第三方的网络请求库封装 form-data,解决该问题(无需改动项目 JDK、Gradle 及 Gradle Plugin 版本,推荐使用该方案)
方案 2 的具体实施,将在下一篇文章中进行演示
PS:如果你们可以在自定义 Gradle 文件中引用到第三方的网络请求库或者是正确编写携带文件的 form-data 网络请求,则可以自行更改部分代码后修复该问题
在 studio64.exe.vmoptions 文件中输入
# 解决 gradle 控制台中文乱码问题
-Dfile.encoding=utf-8
在 Android studio 的 Setting 中找到最底部 Experimental ,取消如下图中的勾选并应用
参考 https://seed.pgyer.com/WGNQkEpP