大家好,好久没有写一些文章,之前经历换工作,适应新工作,最近刚有点时间可以写一写。正好最近公司项目要把gradle升级到8.x, agp也同步升级,这里记录一下遇到的一些问题,怎么解决的。
废话不多说,这里说一下在升级到gradle8.x之后,项目里之前的maven-publish脚本在执行publish命令时报错了,导致没法打包上传aar。之前我们的publish脚本是这样的:
apply plugin: 'maven-publish'
def isReleaseBuild() {
return !VERSION_NAME.toUpperCase().contains("SNAPSHOT")
}
def getRepositoryUrl() {
return isReleaseBuild() ? RELEASE_REPOSITORY_URL : SNAPSHOT_REPOSITORY_URL
}
//生成源码jar包task
task sourcesJar(type: Jar) {
from android.sourceSets.main.java.srcDirs
archiveClassifier.set("sources")
}
afterEvaluate {
publishing {
publications {
release(MavenPublication) {
from components.release
artifact sourcesJar
groupId = GROUP
artifactId = ARTIFACT_ID
version = VERSION_NAME
}
}
repositories {
maven {
url = getRepositoryUrl()
}
}
}
}
省流,这里直接给出修改后的打包脚本:
apply plugin: 'maven-publish'
android {
publishing {
singleVariant("release") {
withSourcesJar()
withJavadocJar()
}
}
}
afterEvaluate {
publishing {
publications {
release(MavenPublication) {
from components.release
groupId = GROUP
artifactId = ARTIFACT_ID
version = VERSION_NAME
}
}
repositories {
maven {
allowInsecureProtocol true
url = getRepositoryUrl()
}
}
}
}
def getRepositoryUrl() {
return isReleaseBuild() ? RELEASE_REPOSITORY_URL : SNAPSHOT_REPOSITORY_URL
}
def isReleaseBuild() {
return !VERSION_NAME.toUpperCase().contains("SNAPSHOT")
}
经过这样修改,就可以正常打包了,下面就来说说,我是怎么改的。
1、初次尝试
当我们用最初的脚本执行publishXXXPublicationToMavenRepository时,会报下面的错:
这里提示的错是指generateMetadataFileForReleasePublication没有显式的依赖sourcesJar任务,但generateMetadataFileForReleasePublication是maven-publish插件添加的,不是我们自定义的任务,没法直接修改,只能是用些其他方法,比如在afterEvaluate块里加上下面的代码:
tasks.named("generateMetadataFileForReleasePublication").configure {
dependsOn("sourcesJar")
}
这样修改后,当我们再次执行publishXXXPublicationToMavenRepository时,会变成下面的错误:
这次怎么就提示我们,multiple artifacts with the identical extension and classifier,我们明明没定义多个artifacts。又经过一顿搜索,问了gpt后,原来gradle8.0之后,Java Library插件会自动创建源码JAR文件,我们之前写的sourceJars task已经不需要了。那好办,这次我们直接删除sourceJars task,artifact sourcesJar这一行代码也可以删除了,顺便刚刚加的代码也可以删除了(绕了一圈刚刚白忙活)。
2、再接再厉
经过上面一番修改,我们再来执行publishXXXPublicationToMavenRepository看看。如果你的maven仓库是通过https访问的,那这样应该就可以成功了,如果只是通过http访问,就又会报如下错误:
这里看错误提示也很清楚问题原因,给出的gradle文档里也给出了不想换成https访问的解决方法,我们只需要加上。allowInsecureProtocol true就可以了。
repositories {
maven {
allowInsecureProtocol true
url = getRepositoryUrl()
}
}
现在我们再来执行publishXXXPublicationToMavenRepository,这次终于成功了,maven仓库上查看,也已经有上传上来的aar了。
3、完善优化
现在我们来看看发布到maven仓库的产物里面并没有带source源代码,那岂不是之前删除sourcesJar是有问题的?这倒也不是,毕竟之前就是在排查问题之后才删除的,那现在我们应该怎么带上source源代码呢,这里我们需要添加的是如下的代码:
android {
publishing {
singleVariant("release") {
withSourcesJar()
withJavadocJar()
}
}
}
这段代码逻辑是参照android developer官网给出的例子(https://developer.android.com/build/publish-library/configure-pub-variants?hl=zh-cn),这样我们就可以将包含源码JAR文件的发布产物发布到Maven仓库中,现在我们再来执行一下publishXXXPublicationToMavenRepository,这次发布的产物里可以看到有source源代码以及javadoc。大功告成,让我们愉快的继续gradle升级之旅(踩坑之旅)吧