[Android]使用Gradle提交自己开源Android库到Maven中心库


android, gradle, maven, open source, uploadArchive

此文针对开源爱好者。

如果你想让别人使用你的Android开源库，第一种方法是，提供你的Github地址，让别人clone一份，然后让别人import到他的项目中。另一种更简单的方式就是直接让别人在他的Gradle中添加你的库依赖，如下：


compile ‘com.github.wangjiegulu:AndroidBucket:1.0.1’

如果想使用第二种方式，你需要将你的项目提交到公共的中心库。

这里介绍使用sonatype来把你的开源库（snapshot或release）提交到Maven的中心库。

1. 首先，在https://issues.sonatype.org中注册账号。

2. 然后在https://issues.sonatype.org/secure/CreateIssue.jspa?issuetype=21&pid=10134中新建一个“Project ticket”。

－Summary：填写项目名称

－Description：填写描述

－Group Id：域名反转，如果没有域名，就直接使用github反转（如github.com/wangjiegulu –> com.github.wangjiegulu），具体看http://central.sonatype.org/pages/choosing-your-coordinates.html

－Project URL：项目的url，可以是项目的github地址。如https://github.com/wangjiegulu/AndroidBucket

－SCM url：版本控制的uri，如https://github.com/wangjiegulu/AndroidBucket.git

3. 创建完毕后就等待状态变为“resolved”，然后你就可以使用Gradle上传项目了。

4. 上传前需要进行GPG签名，所以先去下载GPG（https://www.gnupg.org/download/index.html），然后打开

新建一个Keychain，完成后右键“Send Public Key to Key Server”，这样就能把你的public key发送到服务端。

5. 然后我们再打包项目的aar文件，intellij idea和android studio使用gradle构建后，会在build中自动生成该文件，直接把他拷出来即可。

6. 然后新建build.gradle来进行我们的上传操作，大概内容如下：


// *
apply plugin: ‘maven’
apply plugin: ‘signing’ //使用signing plugin做数字签名

//定义GroupID和Version，ArtefactID会自动使用Project名
group = ‘com.github.wangjiegulu’
version = ‘1.0.1’

repositories {
    mavenCentral();
}

artifacts {
    archives file(‘AndroidBucket.aar’)
}
signing {
    sign configurations.archives
}

uploadArchives {
    repositories {
        mavenDeployer {
            //为Pom文件做数字签名
            beforeDeployment { MavenDeployment deployment -> signing.signPom(deployment) }

            //指定项目部署到的中央库地址，UserName和Password就是Part 1中注册的账号。
            repository(url: “https://oss.sonatype.org/service/local/staging/deploy/maven2/“) {
                authentication(userName: ossrhUsername, password: ossrhPassword)
            }
            snapshotRepository(url: “https://oss.sonatype.org/content/repositories/snapshots/“) {
                authentication(userName: ossrhUsername, password: ossrhPassword)
            }

            //构造项目的Pom文件，参见Part 2中Pom文件的规范，不要遗漏必填项
            pom.project {
                name project.name
                packaging ‘aar’
                description ‘Android开发常用整理’
                url ‘https://github.com/wangjiegulu/AndroidBucket‘

                scm {
                    url ‘scm:git@github.com:wangjiegulu/AndroidBucket.git’
                    connection ‘scm:git@github.com:wangjiegulu/AndroidBucket.git’
                    developerConnection ‘git@github.com:wangjiegulu/AndroidBucket.git’
                }

                licenses {
                    license {
                        name ‘The Apache Software License, Version 2.0’
                        url ‘http://www.apache.org/licenses/LICENSE-2.0.txt‘
                        distribution ‘wangjie’
                    }
                }

                developers {
                    developer {
                        id ‘wangjie’
                        name ‘Wagn Jie’
                        email ‘tiantian.china.2@gmail.com’
                    }
                }
            }
        }
    }
}

archives file(‘AndroidBucket.aar’) 表示指定上传的aar文件。


signing {
    sign configurations.archives
}

表示对内容进行gpg签名，既然需要签名，那需要在gradle.properites中配置key的信息，还有上传的账号密码：


signing.keyId=XXXXXXXXX
signing.password=XXXXXXXXX
signing.secretKeyRingFile=/Users/wangjie/.gnupg/secring.gpg


  ossrhUsername=oss.sonatype.org或者issues.sonatype.org的账号（同一个）
  ossrhPassword=oss.sonatype.org或者issues.sonatype.org的密码（同一个）

所有配置完毕后执行gradle uploadArchives进行上传操作。

7. 登录https://oss.sonatype.org，点击左边的“Staging Repositories”，然后刚刚上传的项目名称为com.github.wangjiegulu去掉点-数字

选中后点击“Close”，如果成功，则再点击“Release”按钮发布。

然后再等待2小时，就可以在Maven中心库中搜索到了。

 

注意：以后如果需要再上传其它项目的时候，直接从第4步开始即可，因为你的groupId已经申请过了，以后新的artifacts可以直接部署到这个groupId中。

 

参考：http://central.sonatype.org/pages/ossrh-guide.html


来源博客：Wang Jie's Blog's Blog
本文链接：https://blog.wangjiegulu.com/2015/04/02/Android-使用Gradle提交自己开源Android库到Maven中心库/
版权声明：本博客所有文章除特别声明外，均采用 CC BY 4.0 CN协议 许可协议。转载请注明出处。