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

电竞丶小松哥2023-09-01 16:56

目录

一、SonaType账户注册与登录

（1）注册

（2）登录

二、创建工单

（1）Github子域名验证

（2）自定义域名验证

[三、登录Nexus Repository Manager](#三、登录Nexus Repository Manager)

四、GPG签名生成和发布

五、Android推送aar包

（1）配置私钥

（2）配置Gradle推送参数

snapshot-sonatype-publish.gradle

release-sonatype-publish.gradle

将配置引入Module的build.gradle

六、开始推送

七、验证推送成功

[（1）nexus repository manager 快照版](#（1）nexus repository manager 快照版)

[（2）nexus repository manager 发布版](#（2）nexus repository manager 发布版)

（3）https://mvnrepository.com/

八、使用发布成功的aar

[（1）nexus repository manager](#（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配置文件中，编辑以下信息

Groovy 复制代码 
# 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

Groovy 复制代码 
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

Groovy 复制代码 
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

Groovy 复制代码 
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

Groovy 复制代码 
        //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（中央仓库）

Groovy 复制代码 
    mavenCentral()

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

（3）引入aar依赖成功

九、总结

仅自己学习记录，如有错误，敬请谅解~，谢谢~~

相关推荐
救救孩子把4 分钟前
Java基础之IO流
java·开发语言
小菜yh5 分钟前
关于Redis
java·数据库·spring boot·redis·spring·缓存
ggdpzhk11 分钟前
Mybatis 快速入门（maven）
oracle·maven·mybatis
宇卿.11 分钟前
Java键盘输入语句
java·开发语言
浅念同学12 分钟前
算法.图论-并查集上
java·算法·图论
立志成为coding大牛的菜鸟.25 分钟前
力扣1143-最长公共子序列（Java详细题解）
java·算法·leetcode
鱼跃鹰飞25 分钟前
Leetcode面试经典150题-130.被围绕的区域
java·算法·leetcode·面试·职场和发展·深度优先
liangbm331 分钟前
数学建模笔记——动态规划
笔记·python·算法·数学建模·动态规划·背包问题·优化问题
GoppViper42 分钟前
golang学习笔记29——golang 中如何将 GitHub 最新提交的版本设置为 v1.0.0
笔记·git·后端·学习·golang·github·源代码管理
Charles Ray2 小时前
C++学习笔记 —— 内存分配 new
c++·笔记·学习
热门推荐
01RAG 实践- Ollama+RagFlow 部署本地知识库02组基轨迹建模 GBTM的介绍与实现（Stata 或 R）032024年高教社杯数学建模国赛C题超详细解题思路分析04Coze扣子平台完整体验和实践（附国内和国际版对比）05苍穹外卖面试总结06【2024数模国赛赛题思路公开】国赛B题思路丨附可运行代码丨无偿自提07yolov8实战第五天——yolov8+ffmpg实时视频流检测并进行实时推流——（推流，保姆教学）08CCF-CSP认证考试 202406-3 文本分词 100分题解09【2024高教社杯全国大学生数学建模竞赛】B题 生产过程中的决策问题——解题思路 代码 论文10浏览器插件——ModHeader 的分享和学习