JCenter是什么
大家应该都用过各种各样的Github上的第三方开源组件。类似这种效果的
compile 'wang.yuchao.demoforjcenterlibrary:DemoForJCenterLibraryModel:1.2.5'
我们会比较好奇Android Studio 是从哪里得到这个类库的？
Android Studio是从build.gradle里面定义的Maven仓库服务器上下载library的。Apache Maven是Apache开发的一个工具，提供了用于贡献library的文件服务器。但是由于maven仓库对开发人员不友好(原因在此)，因此Android Studio 团队把默认仓库换成了JCenter。JCenter是一个由bintray.com维护的Maven仓库。我们在项目的build.gradle 文件中如下定义仓库，就能使用jcenter了。
allprojects {
repositories {
//mavenCentral()
jcenter()
}
}
为了更好的描述他们之间的关系，以及怎么发布一个项目到JCenter上，我下面用一个例子进行演示一下。
演示：发布项目到JCenter
第一步：准备工作
前言：本机环境
MAC OS 10.10.5
Android Studio 2.0
新建一个Android Studio Project
Application Name -> DemoForJCenter
根据 Application Name 会自动生成 Package Name 为 wang.yuchao.demoforjcenter
添加一个Android Library 类型的 Model
Model Name -> DemoForJCenterLibraryModel
Application/Library name -> DemoForJCenterLibrary
根据 Application/Library name 可以自动生成 Model Package Name 为 wang.yuchao.demoforjcenterlibrary
我们在此 Model 下面新建一个类 ToastUtil.java 用来测试
package wang.yuchao.demoforjcenterlibrary;
import android.content.Context;
import android.widget.Toast;
public class ToastUtil {
public static void show(Context context, String message) {
Toast.makeText(context, "DemoForJCenterLibrary：" + message, Toast.LENGTH_SHORT).show();
}
}
第二步：网站配置
Push 工程到 Github
方式一：点击 maven -> Import GitHub repositories 即可把Github的项目导入。(导入后Bintray生成的项目名默认是Github的项目名)
方式二：点击 maven -> Add New Package 后，根据提示写入各种信息后Create Package。(Version control 是必填项)
注意：为了详细的演示与讲解，我们使用上述方式二进行配置，并且为了区分Bintray上的Name跟Github默认的项目名，Bintray Name我们设置的不是Github默认的DemoForJCenter，而使用的是 DemoForJCenterName 。如下图。(但是建议：设置为Github默认的)
截图
第三步：本地配置
1. 打开本地Project的local.properties，最后添加
bintray.user=YOUR_BINTRAY_USERNAME
bintray.apikey=YOUR_BINTRAY_API_KEY
YOUR_BINTRAY_USERNAME是你在 https://bintray.com/ 的用户名
YOUR_BINTRAY_API_KEY是你在 https://bintray.com/ 的API_KEY(点击右上角用户名->your profile->edit ->Api Key)
2. 打开本地Project的gradel文件，dependencies节点下添加一些插件
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.4'
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'
classpath "org.jfrog.buildinfo:build-info-extractor-gradle:3.1.1"
3. 打开本地要上传的Model(即DemoForJCenterLibraryModel)下的gradle文件，添加如下代码到最后
apply plugin: 'com.android.library'
ext {
bintrayRepo = 'maven'
bintrayName = 'DemoForJCenterName'
publishedGroupId = 'wang.yuchao.demoforjcenterlibrary'
libraryName = 'DemoForJCenterLibrary'
artifact = 'DemoForJCenterLibraryModel'
libraryDescription = 'This library is test for DemoForJCenter'
siteUrl = 'https://github.com/yuchao-wang/DemoForJCenter'
gitUrl = 'https://github.com/yuchao-wang/DemoForJCenter.git'
libraryVersion = '1.2.3'
developerId = 'wangyuchao'
developerName = 'yuchao-wang'
developerEmail = '1154786190@qq.com'
licenseName = 'The Apache Software License, Version 2.0'
licenseUrl = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
allLicenses = ["Apache-2.0"]
}
apply from: 'https://raw.githubusercontent.com/nuuneoi/JCenter/master/installv1.gradle'
apply from: 'https://raw.githubusercontent.com/nuuneoi/JCenter/master/bintrayv1.gradle'
3.1 参数说明
参数
说明
publishedGroupId
Model Package Name
libraryName
Model Application/Library name(没啥用)
artifact
Model 名
libraryVersion
Model版本号
3.2 使用说明
compile 'publishedGroupId:artifact:libraryVersion'
第四步：发布项目到Maven及JCenter
1. 执行
./gradlew install
2. 执行
gradlew bintrayUpload
到目前为止，你已经成功地把类库文件上传到bintray上，接下来就是同步到jcenter上了。
4. 点击 Add to JCenter 等待JCenter审核即可。
测试一下
在等待审核的过程中，你可以先修改Project下的gradle文件进行测试。如果审核通过了以后，下面的maven节点也就可以注释掉了。
allprojects {
repositories {
maven {
// your bintray maven address . you can find it on
url 'https://dl.bintray.com/yuchao-wang/maven'
}
jcenter()
}
}
app model 下的gradle文件引入
compile 'wang.yuchao.demoforjcenterlibrary:DemoForJCenterLibraryModel:1.2.3'
番外篇
1. 踩过的坑
如果上传的过程中出现
Could not upload to 'https://xxxxxxx.pom': HTTP/1.1 400 Bad Request [message:Unable to upload files: Maven group, artifact or version defined in the pom file do not match the file path 'xxxxxxx.pom']
是因为module的名字和Model下gradle文件配置的artifact不一致导致的
2. 删除JCenter项目
Edit Your Profile -> Repositories ->
参考
