以下内容来自于网络以及自己实践总结,相关参考资料在文末附上。
整个流程大致有以下几个步骤:
- 注册Sonatype账号
- Sonatype申请创建项目
- 等待Sonatype申请批复
- 生成密钥对
- 公钥上传至密钥服务器
- 配置本地项目相关信息
- 上传项目至Sonatype
- Sonatype将项目同步至Maven中央仓库
其中就我碰到问题的步骤会着重介绍,其他步骤则相对简单说明。
Sonatype
注册账号不用多说,注册完成后,提交一个工单(ticket),Issue TypeRequired为New Project,Project为Community Support - Open Source Project Repository Hosting。具体工单怎么填写,不再赘述,可以查看参考资料中对应的部分。
如果工单中的信息有填写不规范或者不正确的地方,管理员会留言告知于你,提醒你修改,并且会通过你注册时留的邮箱通知你。如果一切正确的话,可能1天技能批复下来,我自己尝试时,由于信息填写错误,导致多用了几天。
密钥
GPG的安装不再赘述,安装完成后,可以使用GUI生成证书,也可以使用参考资料中命令行的方式创建密钥。
需要注册是,创建完密钥以后,一定要备份密钥,这是你以后唯一的用户标识,一旦丢失无法找回。
创建完密钥以后,需要将公钥上传到密钥服务器,在参考资料中有一点说的不太明确,我补充一下,以命令行为例。执行gpg --list-key
查看当前创建好的密钥,会显示这样的内容:(以我在Windows下为例)
C:\Users\forDream>gpg --list-key
C:/Users/forDream/AppData/Roaming/gnupg/pubring.gpg
---------------------------------------------------
pub 2048R/CA2BC608 2016-02-15
uid [ultimate] forDream <secret@secret.com>
sub 2048R/BB2E676A 2016-02-15
其中第一行C:/Users/forDream/AppData/Roaming/gnupg/pubring.gpg
为密钥的位置,后面的步骤需要使用。
第三行CA2BC608
为公钥的ID,第五行BB2E676A
为私钥的ID。明确这个就可以了,之后的步骤会用到这些。
上传公钥到服务器:
gpg --keyserver hkp://pool.sks-keyservers.net --send-keys CA2BC608
记得是公钥,因此最后那一串字符替换你的公钥ID。密钥传到服务器后,会自动同步到其他密钥服务器,因此不需要每个都自己传。
配置Gradle,上传包到仓库
这一部分,不过多说明,参考资料1与参考资料2中有详细的说明,但是参考资料2中的默认配置AndroidStudio的Android,而我是希望上传普通的Java工程,直接使用时,Gradle会报错。因此我fork他的Gradle配置文件,参考Sonatype的说明做了相关修改,以适应普通的jar文件。因此,如果你也需要上传的是普通Java工程,可以将导入的地址修改为https://raw.githubusercontent.com/gam2046/gradle-mvn-push/master/gradle-mvn-push.gradle
,即使用这样的导入语句:apply from: 'https://raw.github.com/chrisbanes/gradle-mvn-push/master/gradle-mvn-push.gradle'
此外,参考资料中提到的USER_HOME/.gradle/gradle.properties
文件添加如下内容:
NEXUS_USERNAME= xxxx // 第一步注册的账号
NEXUS_PASSWORD= xxxx // 第一步注册的密码
signing.keyId=CA2BC608 // 填写GPG创建的公钥ID
signing.password=xxxxx // GPG 证书的密码
signing.secretKeyRingFile=C:/Users/forDream/OneDrive/SSL/GPG-Maven.gpg // GPG证书的位置,如果你备份了证书,可以填写备份的文件位置,如果没备份也可以使用上面提到列表中显示的文件位置
如果有不会填写的,按照我的注释填写。
其中子模块中的gradle.properties
文件:
POM_NAME=ActionBar-PullToRefresh // 介绍的名字
LibraryPOM_ARTIFACT_ID=library // Artifact名字,与Group共同构成这个项目的完整引用
POM_PACKAGING=aar // 打包类型,如果是jar包,这里就写jar
其他相关配置依旧按照资料中配置即可使用。
上传并确认
Gradle配置完成以后,就可以通过Gradle自动部署并上传到仓库。第一次上传需要在第一步创建的工单中通知一下管理员(应该在工单初步通过后,会留言告知于你),以便于实现不同仓库的自动同步。
你可以在这里,登陆自己在第一步中创建的账号,查看自己的项目情况。与Maven中央仓库同步后,你在sonatype上传后,大概两三个小时后就可以在Maven仓库中找到你的项目。