Android 发布Android Library项目到JCenter

android-library-publish-to-jcenter是一个帮助Android开发者将AAR库发布到jcenter的项目，android-library-publish-to-jcenter已经将需要写的脚本封装好了，我们只需要配置相关属性即可在5分钟之内发布我们的项目到JCenter（不包括审核时间哦）

1. 注册Bintray账号 (传送门)

Bintray是jcenter的托管商，因此你必须注册一个Bintray账号，注册完账号后记下你的用户名以及API Key。

登陆后在首页右上角点击用户名进入个人主页，然后点击用户名下面的Edit进入个人信息编辑页面，接下来点击页面左边列表的最后一项API Key

如图所示点击最右边箭头指示的复制按钮即可复制你的API Key

2. 检查Android插件版本

首先你要检查你的Android插件的版本，因为1.1.0版本有一个BUG会导致生成javadoc失败，所以你只需升级到最新即可。目前最新版本是1.2.3，在项目根目录下的build.gradle文件中修改版本号即可，如下:

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

<code class="language-groovy hljs perl">// Top-level build file where you can add configuration options common to all sub-projects/modules.   buildscript {     repositories {         jcenter()     }     dependencies {         classpath 'com.android.tools.build:gradle:1.2.3'         // NOTE: Do not place your application dependencies here; they belong         // in the individual module build.gradle files     } }   allprojects {     repositories {         jcenter()     } } </code>

如果你在看到这篇文章的时候有更新的版本的话，直接改为最新的版本即可。

3. 添加所需插件

在项目根目录下build.gradle文件中的dependencies节点中追加如下代码：

?

1 2	<code class="language-groovy hljs bash">classpath 'com.github.dcendents:android-maven-plugin:1.2' classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0'</code>

android-maven-plugin插件是用来打包Maven所需文件的

gradle-bintray-plugin插件是用来将生成的Maven所需文件上传到Bintray的

完成后如下所示：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

<code class="language-groovy hljs perl">// Top-level build file where you can add configuration options common to all sub-projects/modules.   buildscript {     repositories {         jcenter()     }     dependencies {         classpath 'com.android.tools.build:gradle:1.2.3'         classpath 'com.github.dcendents:android-maven-plugin:1.2'         classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0'         // NOTE: Do not place your application dependencies here; they belong         // in the individual module build.gradle files     } }   allprojects {     repositories {         jcenter()     } }</code>

4. 配置项目信息

下载project.properties文件并放到你的library module目录下

project.properties文件的原始内容如下：

?

1 2 3 4 5 6 7 8 9 10

<code class="language-properties hljs avrasm">#project project.name= project.groupId= project.artifactId= project.packaging=aar project.siteUrl= project.gitUrl=   #javadoc javadoc.name=</code>

详解：

project.name：项目名称 project.groupId：项目组ID，通常情况下如果你的包名为com.example.test，那么项目组ID就是com.example project.artifactId：项目ID，通常情况下如果你的包名为com.example.test，那么项目ID就是test project.packaging：包类型，Android库是aar project.siteUrl：项目官方网站的地址，没有的话就用Github上的地址，例如：https://github.com/xiaopansky/Sketch project.gitUrl：项目的Git地址，例如：https://github.com/xiaopansky/Sketch.git javadoc.name：生成的javadoc打开后主页显示的名称，通常跟项目名称一样即可

完成配置后如下所示：

?

1 2 3 4 5 6 7 8 9 10

<code class="language-properties hljs avrasm">#project project.name=Sketch project.groupId=me.xiaopan project.artifactId=sketch project.packaging=aar project.siteUrl=https://github.com/xiaopansky/Sketch project.gitUrl=https://github.com/xiaopansky/Sketch.git   #javadoc javadoc.name=Sketch</code>

你无需配置项目版本，会自动从你的build.gradle中获取版本名称作为项目版本

5. 配置Bintray账号以及开发者信息

下载local.properties文件并放到你的library module目录下

local.properties文件的原始内容如下：

?

1 2 3 4 5 6 7 8

<code class="language-properties hljs avrasm">#bintray bintray.user= bintray.apikey=   #developer developer.id= developer.name= developer.email=</code>

详解：

bintray.user：你的Bintray的用户名 bintray.apikey：你的的Bintray的API Key developer.id：通常是你在开源社区的昵称 developer.name：你的姓名 developer.email：你的邮箱

完成配置后如下所示：

?

1 2 3 4 5 6 7 8

<code class="language-properties hljs markdown">#bintray bintray.user=xiaopansky bintray.apikey=*****************************   #developer developer.id=xiaopan developer.name=******** developer.email=sky@xiaopan.me</code>

*号显示的为个人信息不反方便透露，还请见谅

注意要将local.proerties文件加入忽略列表，以免被提交到Github或其他网站泄露个人信息

6. 配置bintrayUpload.gradle

方法1：直接使用远程bintrayUpload.gradle文件

修改你的library module的build.gradle文件，在最后加上apply from: "https://raw.githubusercontent.com/xiaopansky/android-library-publish-to-jcenter/master/bintrayUpload.gradle"，如下所示：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

<code class="language-groovy hljs cs">apply plugin: 'com.android.library'   android {     compileSdkVersion 22     buildToolsVersion "22.0.0"       defaultConfig {         minSdkVersion 7         targetSdkVersion 22         versionCode 100         versionName "1.0.0"     }       buildTypes {         release {             minifyEnabled false             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'         }     } }   apply from: "https://raw.githubusercontent.com/xiaopansky/android-library-publish-to-jcenter/master/bintrayUpload.gradle"</code>

方法2：下载后使用本地bintrayUpload.gradle文件

首先下载bintrayUpload.gradle文件并放到你的library module目录下

然后修改你的library module的build.gradle文件，在最后加上apply from: "bintrayUpload.gradle"，如下所示：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

<code class="language-groovy hljs cs">apply plugin: 'com.android.library'   android {     compileSdkVersion 22     buildToolsVersion "22.0.0"       defaultConfig {         minSdkVersion 7         targetSdkVersion 22         versionCode 100         versionName "1.0.0"     }       buildTypes {         release {             minifyEnabled false             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'         }     } }   apply from: "bintrayUpload.gradle"</code>

推荐大家使用第一种方案，简单快捷，至此配置工作已全部结束

7. 执行命令打包并上传到Bintray

打开终端进入项目目录下，执行gradlew bintrayUpload命令即可

另外，如果你的本地已经配置了Gradle了，那么执行gradle bintrayUpload命令也可以。gradlew是Gradle的一层封装，如果你本地没有安装Gradle gradlew就会自动下载Gradle

8. 请求提交你的项目到jcenter

前面所有步骤走完之后实际上只是上传了你的项目到Bintray而已，并没有被包含在jcenter中，要想提交到jcenter中还需要Bintray的审核。

登入Bintray网站，进入个人中心，在右侧的Owned Repositories区域点击Maven的图标，进入你的Maven项目列表。

如果已经上传成功了，在这里就能看到你的项目，进入项目详情，在右下角的Linked To区域点击add in jcenter，然后在comment输入框里随便填写下信息，最后点send提交请求即可

一般情况下审核需要4到5个小时，耐心等待就行了，审核通过后会给你发邮件通知你，并且以后更新项目就不需要再审核了。

9. 一句话导入你的项目

当审核通过后，别人就可以一句话导入你的项目了，例如：

?

1	<code class="language-groovy hljs bash">compile 'me.xiaopan:sketch:2.0.0'</code>

10. 额外补充：

保持你的library module的名字同artifactId一样

因为在Bintray上你的项目的maven-metadata.xml文件的路径是gruopId+"/"+module名称。

例如你的groupId是com.example，artifactId是test，但module名称是library。

这时候项目文件是在com.example.test目录下的，但maven-metadata.xml文件却是在com.example.library目录下的。

这样一来如果你有多个项目groupId一样，artifactId不一样，但module名称都是library的话，可能就会冲突。

目前为止我还没有找到更好的解决办法，就只能让module名称和artifactId保持一致，如果你们谁有更好的办法，欢迎留言交流。

转载于:https://my.oschina.net/u/815801/blog/759375