（AS笔记）上传aar包到Maven中央仓库

目录

一、SonaType账户注册与登录

        （1）注册

        （2）登录

二、创建工单

        （1）Github子域名验证

（2）自定义域名验证

三、登录Nexus Repository Manager

四、GPG签名生成和发布

五、Android推送aar包

        （1）配置私钥

        （2）配置Gradle推送参数

        snapshot-sonatype-publish.gradle

        release-sonatype-publish.gradle

        将配置引入Module的build.gradle

六、开始推送

七、验证推送成功

        （1）nexus repository manager 快照版

         （2）nexus repository manager 发布版

        （3）https://mvnrepository.com/

八、使用发布成功的aar

        （1）nexus repository manager

         （2）已发布到mvnrepository（中央仓库）

        （3）引入aar依赖成功

九、总结

成功上传效果图

一、SonaType账户注册与登录

        （1）注册

        想要推送到maven中央仓库，须先完成账户注册。

        访问SonaType官网：https://issues.sonatype.org/

        （2）登录

登录成功

二、创建工单

        创建一个工单项目为Maven Central，由外国人跟踪工单审核后即可上传到Maven仓库的快照库和发布库。（说明：所有Maven Central的资源库，都从Maven发布库间隔几小时更新）

        工单新建后：耐心等待外国大佬审核，他们处理后会向注册时提供的邮箱发送一条英文邮箱。翻译后如下：

        另外注意一点：Already Synced to Central 必须选为Yes, 将自己的依赖库aar自动同步到中央仓库。

 

        （1）Github子域名验证

        按照邮箱要求创建了项目后，耐心等待外国大佬回复即可。 

（2）自定义域名验证

        本人有自己备案的域名，因此需要去腾讯云DNS解析加上TXT记录。

        这里已经完成添加，接下来怎么办？当然是催审了，直接在项目下方追加评论。 英语不好，先翻译copy复制过去。

         等着回复就行......任何更新状态不管自己新增、追加平台、响应我们，都会通过邮箱通知的。

由于审核时间耽误我写博客，此处用我上一次工单的信息来继续

三、登录Nexus Repository Manager

        访问仓库管理首页：Nexus Repository Manager

        重要说明：登录这个账户与 SonaType注册的账户一样的。登录前提：需要外国大佬全部审核通过，给你开启登录权限、存储权限才可以登录上去。

        说明：在Android使用Maven推送插件将资源库推送到Nexus Repository Manager 中，会依据Version是否带有后缀来自动选择推送到快照库还是发布库。如1.0.0-SNAPSHOT 会推送到快照库， 1.0.0 会推送到发布库。当然你如果非要将1.0.0-SNAPSHOT推送到发布库、1.0.0推送到快照库，其实也行，只是不太正规。。按照行内规矩推送就行。

四、GPG签名生成和发布

         GPG是RSA算法加解密软件，将生成的公钥上传到公网能访问的公开密钥库中，其他服服务解密验证私钥后可以进行相关安全的业务操作。因次，SonaType也需要对aar包、jar等依赖库进行加密传输与解密下载，因此需要用到GPG。GPG可以按照在客户端，生成公钥后发布到公网能访问的公开密钥中，私钥本地存储。私钥证书有文件、keyId、密码。这些会在推送资源包时用到。

        GPG安装和使用及生成公钥发布到公网库、私钥存储、keyID（证书指纹后8位）、password 详见：Windows平台GPG签名生成和发布_gpg1.50.2下载_VinRichard的博客-CSDN博客

五、Android推送aar包

        Android借助Gradle推送，Gradle7.0以下使用 apply plugin: 'maven'、Gradle7.0以上 使用 apply plugin: 'maven-publish'，本文使用的是Grale7.0以上。

        （1）配置私钥

        在AndroidStudio的gradle.properties配置文件中，编辑以下信息

# Signing Plugin Config
signing.keyId= 证书指纹后8位
signing.password=证书密码
signing.secretKeyRingFile=file:H://xx//xx//_SECRET.gpg 证书本地绝对路径

        （2）配置Gradle推送参数

        在Moudle根目录新建文件：snapshot-sonatype-publish.gradle（配置快照库），release-sonatype-publish.gradle（配置发布库）。配置内容如下：（本人习惯分开配置，因为尝试过用一个配置文件，在其中判断版本后缀是否带有SNAPSHOT来动态选择推送是发布库还是快照库）

        snapshot-sonatype-publish.gradle

apply plugin: 'maven-publish'
apply plugin: 'signing'

//仓库的用户名
static def getRepositoryUsername() {
    return "SonaType注册的登录用户名"
}

//仓库的密码
static def getRepositoryPassword() {
    return "SonaType注册的登录密码"
}

if (project.hasProperty("android")) { // Android库
    task sourcesJar(type: Jar) {
        classifier = 'sources'
        from android.sourceSets.main.java.srcDirs
    }
    task javadoc(type: Javadoc) {
        excludes = ['**/*.kt'] // 从javadoc文件中排除所有kotlin文件
        source = android.sourceSets.main.java.srcDirs
        classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
        options.encoding = "utf-8"
        options.charSet = "utf-8"
    }
} else { //Java库
    task sourcesJar(type: Jar, dependsOn: classes) {
        classifier = 'sources'
        from sourceSets.main.allSource
    }
}

// 强制Java编码为UTF-8
tasks.withType(JavaCompile) {
    options.encoding = "UTF-8"
}

//强制JavaDoc编码为UTF-8
tasks.withType(Javadoc) {
    options.encoding = "UTF-8"
}

task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}

//签名
signing {
    //required { gradle.taskGraph.hasTask("afterEvaluate") }
    sign configurations.archives
}

//配置上传包的参数
afterEvaluate {
    publishing {
        publications {
            myReleasePlugin(MavenPublication) {
                groupId 'xxxx'//对应sonatype平台新建中的Group Id
                artifactId 'xxx' //项目唯一标识符，对应项目名称
                version '1.0.0-SNAPSHOT' //发布为版本后缀是SNAPSHOT
                //artifact(javadocJar)//将javadoc文档工件打包进aar
                artifact(sourcesJar)//将Java注释工件打包进aar
                // 依赖 bundleDebugAar 任务，并上传其产出的aar
                artifact(tasks.getByName("bundleReleaseAar"))
                // 依赖传递：pom文件中声明依赖，从而传递到使用方，aar使用的依赖都打包进这个moudle，引入这个moudle依赖时，其他的依赖自动下载。本人不使用，避免重复依赖太多，项目过大
//                pom.withXml {
//                    def dependenciesNode = asNode().appendNode('dependencies')
//                    configurations.implementation.allDependencies.each {
//                        // 避免出现空节点或 artifactId=unspecified 的节点
//                        if (it.group != null && (it.name != null && "unspecified" != it.name) && it.version != null) {
//                            println "dependency=${it.toString()}"
//                            def dependencyNode = dependenciesNode.appendNode('dependency')
//                            dependencyNode.appendNode('groupId', it.group)
//                            dependencyNode.appendNode('artifactId', it.name)
//                            dependencyNode.appendNode('version', it.version)
//                            dependencyNode.appendNode('scope', 'implementation')
//                        }
//                    }
//                }
                //项目配置
                pom {
                    packaging 'aar' //安卓Library库：aar 、后端Java：jar
                    name = 'xxx' // 发布库的简单名称 在maven仓库的命名
                    description = 'Androidxxx插件库' // 发布库的描述
                    url = 'https://github.com/用户名/项目名' //Github项目首页
                    //Git项目信息
                    scm {
                        //git项目连接地址
                        connection = 'https://https://github.com/用户名/项目名.git'
                        //git项目开发者连接地址
                        developerConnection = 'https://github.com/用户名/项目名.git'
                        //Github项目首页
                        url = 'https://github.com/用户名/项目名.git'
                    }
                    // 开放许可证书
                    licenses {
                        license {
                            //许可名称
                            name = 'The Apache License, Version 2.0'
                            //许可URL
                            url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                        }
                    }
                    //开发者SonaType账号的信息——右上角用户信息——汇总 头像下方的三条信息
                    developers {
                        developer {
                            //全名
                            id = 'xxx'
                            //用户名
                            name = 'xxx'
                            //邮箱
                            email = 'xxx@qq.com'
                        }
                    }
                }
            }
        }
    }
}

//配置上传SonaType仓库Maven地址和密码
publishing {
    repositories {
        //开发版
        maven {
            url 'https://s01.oss.sonatype.org/content/repositories/snapshots/'
            credentials {
                username = getRepositoryUsername()
                password = getRepositoryPassword()
            }
        }
    }
}

        release-sonatype-publish.gradle

apply plugin: 'maven-publish'
apply plugin: 'signing'

//仓库的用户名
static def getRepositoryUsername() {
    return "SonaType注册的登录用户名"
}

//仓库的密码
static def getRepositoryPassword() {
    return "SonaType注册的登录密码"
}

if (project.hasProperty("android")) { // Android库
    task sourcesJar(type: Jar) {
        classifier = 'sources'
        from android.sourceSets.main.java.srcDirs
    }
    task javadoc(type: Javadoc) {
        excludes = ['**/*.kt'] // 从javadoc文件中排除所有kotlin文件
        source = android.sourceSets.main.java.srcDirs
        classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
        options.encoding = "utf-8"
        options.charSet = "utf-8"
    }
} else { //Java库
    task sourcesJar(type: Jar, dependsOn: classes) {
        classifier = 'sources'
        from sourceSets.main.allSource
    }
}

// 强制Java编码为UTF-8
tasks.withType(JavaCompile) {
    options.encoding = "UTF-8"
}

//强制JavaDoc编码为UTF-8
tasks.withType(Javadoc) {
    options.encoding = "UTF-8"
}

task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}

//签名
signing {
    //required { gradle.taskGraph.hasTask("afterEvaluate") }
    sign configurations.archives
}

//配置上传包的参数
afterEvaluate {
    publishing {
        publications {
            myReleasePlugin(MavenPublication) {
                groupId 'xxxx'//对应sonatype平台新建中的Group Id
                artifactId 'xxx' //项目唯一标识符，对应项目名称
                version '1.0.0-SNAPSHOT' //发布为版本没有
                //artifact(javadocJar)//将javadoc文档工件打包进aar
                artifact(sourcesJar)//将Java注释工件打包进aar
                // 依赖 bundleDebugAar 任务，并上传其产出的aar
                artifact(tasks.getByName("bundleReleaseAar"))
                // 依赖传递：pom文件中声明依赖，从而传递到使用方，aar使用的依赖都打包进这个moudle，引入这个moudle依赖时，其他的依赖自动下载。本人不使用，避免重复依赖太多，项目过大
//                pom.withXml {
//                    def dependenciesNode = asNode().appendNode('dependencies')
//                    configurations.implementation.allDependencies.each {
//                        // 避免出现空节点或 artifactId=unspecified 的节点
//                        if (it.group != null && (it.name != null && "unspecified" != it.name) && it.version != null) {
//                            println "dependency=${it.toString()}"
//                            def dependencyNode = dependenciesNode.appendNode('dependency')
//                            dependencyNode.appendNode('groupId', it.group)
//                            dependencyNode.appendNode('artifactId', it.name)
//                            dependencyNode.appendNode('version', it.version)
//                            dependencyNode.appendNode('scope', 'implementation')
//                        }
//                    }
//                }
                //项目配置
                pom {
                    packaging 'aar' //安卓Library库：aar 、后端Java：jar
                    name = 'xxx' // 发布库的简单名称 在maven仓库的命名
                    description = 'Androidxxx插件库' // 发布库的描述
                    url = 'https://github.com/用户名/项目名' //Github项目首页
                    //Git项目信息
                    scm {
                        //git项目连接地址
                        connection = 'https://https://github.com/用户名/项目名.git'
                        //git项目开发者连接地址
                        developerConnection = 'https://github.com/用户名/项目名.git'
                        //Github项目首页
                        url = 'https://github.com/用户名/项目名.git'
                    }
                    // 开放许可证书
                    licenses {
                        license {
                            //许可名称
                            name = 'The Apache License, Version 2.0'
                            //许可URL
                            url = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                        }
                    }
                    //开发者SonaType账号的信息——右上角用户信息——汇总 头像下方的三条信息
                    developers {
                        developer {
                            //全名
                            id = 'xxx'
                            //用户名
                            name = 'xxx'
                            //邮箱
                            email = 'xxx@qq.com'
                        }
                    }
                }
            }
        }
    }
}

//配置上传SonaType仓库Maven地址和密码
publishing {
    repositories {
        //发布版
        maven {
            url 'https://s01.oss.sonatype.org/content/repositories/releases/'
            credentials {
                username = getRepositoryUsername()
                password = getRepositoryPassword()
            }
        }
    }
}

        将配置引入Module的build.gradle

plugins {
    id 'com.android.library'
}
//sonatype平台的maven中央库配置文件
//发布版
//apply from: "release-sonatype-publish.gradle"
//开发版
apply from: "snapshot-sonatype-publish.gradle"

android {
    compileSdk 31

    defaultConfig {
        minSdk 16
        targetSdk 33
        versionCode 1
        versionName "1.0"
        ...

至此，配置完成！

六、开始推送

        此处将moudle名为utils的aar包推送到Maven快照库。 

七、验证推送成功

        （1）nexus repository manager 快照版

         （2）nexus repository manager 发布版

        （3）https://mvnrepository.com/

八、使用发布成功的aar

        （1）nexus repository manager

        //SonaType Maven 仓库地址
        maven { url 'https://s01.oss.sonatype.org/content/repositories/releases/'}
        maven { url 'https://s01.oss.sonatype.org/content/repositories/snapshots/'}

说明：必须在AndroidStudio项目根目录setting.gradle问加入以上两行maven地址，下载依赖时会去里面下载（因为这里面是我们发布推送进去的）。

使用快照版的，快照版去掉-SNAPSHOT

         （2）已发布到mvnrepository（中央仓库）

    mavenCentral()

 说明：必须在AndroidStudio项目根目录setting.gradle问加入mavenCentral()

        （3）引入aar依赖成功

九、总结

仅自己学习记录，如有错误，敬请谅解~，谢谢~~文章来源地址https://www.toymoban.com/news/detail-682011.html

到了这里，关于（AS笔记）上传aar包到Maven中央仓库的文章就介绍完了。如果您还想了解更多内容，请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章，希望大家以后多多支持TOY模板网！