Gradle 7.0 使用 maven-publish 上传 aar 包到 Nexus 私服

在组件化项目架构中每个组件管理我们一般使用分仓库管理，每个组件分别打包成aar包引入项目依赖。老版本 gradle 我们一般使用 maven 插件来上传aar包，而 Gradle 6.x 版本更新了上传插件为 maven-publish

# 低版本使用
apply plugin: 'maven'

# 6.X 以上版本变化
apply plugin: 'maven-publish'

如何生成 aar 包

• Android Gradle 插件有两种，一个Application，一个是library，Android 插件所创建的组件取决于模块是否使用应用或库插件，而library模块编译生成的产物就是 aar 包，如下官方文档描述

• 可以在 library 组件下执行 assemble 来生成 aar 包，输出目录为 ++build/outputs/aar++，如下图所示

• 可以先在官方文档了解maven-publish插件配置

aar 包上传本地仓库

Gradle 6.0以下 maven 插件

• 直接使用 maven 测试发布在本项目目录中创建本地仓库目录

// maven-upload.gradle
apply plugin: 'maven'

group='com.mao.testmavenpush'
version='1.0.0'

uploadArchives {
    repositories {
        mavenDeployer {
            //在本项目目录下创建的Maven仓库设置
            repository(url: uri('../local_test_repo'))
        }
    }
}

Gradle 7.0 maven-publish 插件

• 为了方便测试，我们可以吧 aar 包上传到本地创建的仓库文件夹，如下创建一个 gradle 上传本地脚本 maven-push.gradle，在本地 E 盘创建一个 maventestrepository 本地仓库文件夹

// maven-push.gradle
apply plugin: 'maven-publish'

afterEvaluate {
    publishing {
        //发布的 jar 包配置
        publications {
            release(MavenPublication) {
                groupId = 'com.mao.testmavenpush'
                artifactId = 'maven-push-test'
                version = '1.0.0'
                //aar 文件
                def projectName = project.getName()
                artifact "build/outputs/aar/${projectName}-release.aar"

                pom.withXml{
                    def dependenciesNode = asNode().appendNode("dependencies")
                    configurations.implementation.allDependencies.forEach(){
                        Dependency dependency ->
                            if (dependency.version != "unspecified" && dependency.name != "unspecified"){
                                def dependencyNode = dependenciesNode.appendNode('dependency')
                                dependencyNode.appendNode('groupId', dependency.group)
                                dependencyNode.appendNode('artifactId', dependency.name)
                                dependencyNode.appendNode('version', dependency.version)
                            }
                    }
                }

            }
        }
        //仓库地址配置
        repositories {
            maven {
                // test, upload local maven repository
                //url = "file:" + new File(project.rootProject.rootDir, "local_test_repo").path
                url = "file://e:/maventestrepository"
            }
        }
    }
}

• 在组件Module的 build.gradle 使用这个脚本

apply from: 'maven-push.gradle'

• 随后会有对应的Task自动生成

• 执行Gradle Task publish 后等待任务执行完本地仓库aar发布成功

Nexus 私服发布 aar 包

• 和本地仓库差不多，Nexus 私服也是本地仓库，只不过是部署在内部服务器上，同理，编写一个repo-maven-push.gradle 脚本，

apply plugin: 'maven-publish'


def GroupId = 'com.mao.testmavenpush'
def ArtifactId = 'maven-push-test'
def Version = '1.0.1'

def userName = "xxxx"
def passWord = "xxxx"


def releasesRepoUrl = "http://xxx.xxx.116.12:9190/repository/maven-releases/"


task generateSourcesJar(type:Jar){
    from android.sourceSets.main.java.srcDirs
    classifier "sources"
}


afterEvaluate {
    publishing {
        //发布的 arr 包配置
        publications{
            //名字可以自己指定，如果有多渠道，整段多复制一个
            release(MavenPublication){

                groupId = GroupId//公司域名
                artifactId = ArtifactId//该aar包的名称
                version = Version//版本号

                // 必须有这个 否则不会上传AAR包
                afterEvaluate { artifact(tasks.getByName("bundleReleaseAar")) }
                // 多渠道，可以自行指定aar路径
                // def projectName = project.getName()
                // artifact "build/outputs/aar/${projectName}-release.aar"
                // 上传source，这样使用方可以看到方法注释
                artifact generateSourcesJar
                //依赖关系
                pom.withXml{
                    def dependenciesNode = asNode().appendNode("dependencies")
                    configurations.implementation.allDependencies.forEach(){
                        Dependency dependency ->
                            if (dependency.version != "unspecified" && dependency.name != "unspecified"){
                                def dependencyNode = dependenciesNode.appendNode('dependency')
                                dependencyNode.appendNode('groupId', dependency.group)
                                dependencyNode.appendNode('artifactId', dependency.name)
                                dependencyNode.appendNode('version', dependency.version)
                            }
                    }
                }
           }
        }

        //仓库地址配置
        repositories {
            maven {
                //允许使用 http
                allowInsecureProtocol = true
                url = releasesRepoUrl
                credentials {
                    username = userName
                    password = passWord
                }
            }
        }
    }
}

• 由以上脚本，可以知道，和发布到本地仓库其实没什么区别，也就是改变上传地址罢了，但是这里会有一个坑，默认需要私服地址为 Https，想要使用 Http 则需要添加 allowInsecureProtocol 设置，官方文档描述

• 同理执行 Gradle Task publish 发布到 Nexus 私服

依赖使用发布Nexus私服aar包

• 要发布到 Nexus私服，首先需要自己搭建一个Nexus私服，可看我以前文章Centos下 Nexus 3.x 搭建Maven 私服

• 在Gradle设置私服maven地址，同理也需要配置允许使用http，否则 sync 同步报错

allprojects {
    repositories {
        ......
        //本地 maven 私服
        maven {
            //允许使用 http
            allowInsecureProtocol = true
            url = "http://xxx.xxx.116.12:9190/repository/maven-public/" }
    }
}

• 工程中依赖使用，接下来就可以愉快的玩耍了

dependencies {
    .....
    //测试 aar 引入
    implementation 'com.mao.testmavenpush:maven-push-test:1.0.1'
}

测试发布项目Demo地址

• demo