发布库到Maven Central Repository

　　现在Maven几乎成了Java事实上的包管理工具了，Gradle作为后起之秀，也是建立在Maven现有的大量仓库资源之上。使用Maven Central Repository可以很方便地解决第三方库依赖问题。那么，如何将自己开发的包也发布到Maven Central Repository上去呢？

　　Sonatype提供开源项目仓库托管(Open Source Software Repository Hosting，简称OSSRH)服务。但是发布到Sonatype的过程还是比较麻烦的，还是写个博客记录一下。

申请空间

　　在Sonatype发布项目，首先得在中央库里申请空间。这个空间可以理解为Group ID，即你的项目都是放在这个目录之下。

注册JIRA

　　在这里注册一个Sonatype的JIRA帐号。这个没什么好说的，跳过。

申请空间

　　在这里填写一个表单。

特别注意这几项

• Group Id：填写你的域名，如果没有域名可以用GitHub的域名(com.github.username)。
• Project URL：GitHub的项目地址
• SCM url：GitHub项目的git clone地址

　　填写完了之后提交。一般来说2个工作日内，这个Issue的状态会变成RESOLVED状态。同时，有一个邮件会发送到你的注册邮箱，邮件正文会附上Sonatype Nexus的上传等地址。

Configuration has been prepared, now you can:
* Deploy snapshot artifacts into repository https://oss.sonatype.org/content/repositories/snapshots
* Deploy release artifacts into the staging repository https://oss.sonatype.org/service/local/staging/deploy/maven2
* Promote staged artifacts into repository 'Releases'
* Download snapshot and release artifacts from group https://oss.sonatype.org/content/groups/public
* Download snapshot, release and staged artifacts from staging group https://oss.sonatype.org/content/groups/staging

please comment on this ticket when you promoted your first release, thanks

由于是第一次提交，所以在完成后面的步骤后，需要回来回复一下JIRA的Issue。

上传库

　　这里以安卓库为例子。

GnuPG

　　安装GnuPG。在下载页面最下方，按你自己的系统选择对应的安装包。我选择了OS X。安装完之后，使用命令行生成密码。

$ gpg --gen-key

　　根据提示填写姓名、邮箱、备注等。生成完了之后，可以用以下命令查看key内容。

$ gpg --list-keys
/Users/PoiSon/.gnupg/pubring.gpg
--------------------------------
pub   2048R/E2F25563 2016-06-29
uid       [ultimate] poison (yerl) <git@yerl.cn>
sub   2048R/5D8F2176 2016-06-29

　　E2F25563是key id，需要将它上报给服务器。

gpg --keyserver hkp://pool.sks-keyservers.net --send-keys E2F25563

　　如果还不是很清楚，可以查看官方指导。

生成库

　　Android Studio使用Gradle作为项目编译、库依赖工作，那么这里就以Gradle为例子，看如何生成aar包并上传到Sonatype的服务器上。

　　将以下的内容复制到Android Studio项目下的build.gradle文件里。

build.gradle

buildscript {
    repositories {
        mavenCentral()
    }

    dependencies {
        classpath 'cn.yerl.gradle:nexus-plugin:+'
    }
}

apply plugin: 'nexus'

nexus {
    repository {
        username 'your_nexus_username'
        password 'your_nexus_password'
    }

    signatory {
        keyId 'your_GnuPG_key_id'
        password 'your_GnuPG_password'
    }

    pom {
        name 'your_project_name'
        description 'your_project_description'
        url 'your_project_website'

        scm {
            url 'https://github.com/example-user/example-project'
            connection 'scm:https://github.com/example-user/example-project.git'
            developerConnection 'scm:git@github.com:example-user/example-project.git'
        }

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

        developers {
            developer {
                name 'Your Name'
                email 'your@email.com'
            }
        }
    }
}

　　nexus插件用于生成Sonatype Nexus要求的所有文件，并上传到服务器中

　　另外，由于上传时需要帐号密码、密钥相关信息，如果将这些信息放在项目下，并上传到GitHub上的话，会造成信息泄露。因此，可以将这些信息放在~/.gradle/gradle.properties文件里。

上传库

　　生成好库之后，就需要将它上传到Sonatype Nexus里去了。上传非常简单，运行Gradle uploadArchives任务就可以了。

　　当在Android的控制台上看到BUILD SUCCESSFUL，我们来到Sonatype Nexus Repository Manager，来看看是否上传成功了。

如果你在控制台上看到Could not find metadata cn.yerl:android-promise/maven-metadata.xml in remote (https://oss.sonatype.org/service/local/staging/deploy/maven2)，不需要理会。

　　登录后，在左侧菜单选择Staging Repositories菜单。在打开的菜单的列表里，找到一个比较特殊的仓库(其它仓库都是以central_bundles-xxxx命令，这个特殊的仓库一般以你的group id命名)。勾选它，并打开Content选项卡，展开所有目录。

　　如果你的结构与上图差不多，那么恭喜你，你快成功了。否则，回去检查一下哪一步出错了。

　　点击Close。这个操作会触发检验操作，系统会自动检验你上传的包是否符合条件。

　　几秒之后，Refresh。再打开页面。如果你的状态下图所示，那么恭喜你，一切顺利。不然，根据错误提示，修改你上传的包。

　　现在，你的库已经可以发布了，点击Release即可。

回复JIRA

　　由于是第一次发布库，因此，还需要回到JIRA的Issue，回复审批人，告诉他，你已经准备好发布你的库了，请将库同步到Maven Central Repository里。

　　等待审批人回复之后，大概10分钟到2个小时，你的库便已经同步到中央库了。

更新

　　更新操作就非常简单了，只需要在gradle.properties文件里，将POM_VERSION的版本改为你想要的新版本，然后运行gradle uploadArchives，然后在Sonatype Nexus里面删掉aar相关的文件，然后Close、Release即可。过一段时间后，中央库就会同步过来了。

据说Sonatype Nexus是每2个小时同步一次，所以可能需要等待一段时间才可以使用。

发布新的包

　　与更新一样的步骤，不需要完全走完所有流程。

以上内容不是特别完整，可以在这里查看上传的完整流程。