盒子
盒子
文章目录
  1. 前言
    1. Android仓库
      1. Jcenter
      2. Maven Central
    2. gradle获取library
    3. 注册
    4. 代码中配置
      1. 分离成多个Module
      2. 添加bintray插件
      3. 添加bintray认证
      4. 修改Module中的build.gradle
    5. 上传到bintray
      1. 编译library文件
      2. 上传
    6. 同步到Jcenter
    7. 版本更新
  2. 总结

如何使Android Studio项目发布到Jcenter中

2016.06.13 Rouse android  热度 ℃

前言

写这篇文章其实我是痛苦的，哎！说出来都是泪啊。。。今天在JFrog Bintray中不小心把我Repositories中原来的maven中的开源项目给删除了。导致原来的依赖全部没了，找了半天也没找到要怎么才能恢复。现在想到的也只能重新发布一下。可能还有很多人不知道如何实现像我们日常添加别人的依赖一样这样简单的方式。所以顺便在这里简单的介绍下我们写的项目如果要别人也能随时使用，如何实现。

Android仓库

简单的普及下关于android的依赖仓库，有两种分别是Jcenter与Maven Central其实不管是Jcenter还是Maven Central都是Maven库。

Jcenter

Jcenter是由bintray.com维护，在Android Studio的项目根目录的build.gradle中我们会看到自动帮我们实现的Jcenter

1
2
3
4
5
buildscript {
    repositories {
        jcenter()
    }
}

Maven Central

当然也可以在build.gradle中定义Maven Central

1
2
3
4
5
buildscript {
    repositories {
        mavenCentral()
    }
}

至于在Android Studio中为什么默认使用Jcenter原因还是有的，感兴趣的可以自己去查，我要说的一点就是，这里你可以认为Jcenter是Maven Central的超集，这样就能更好的理解为什么要使用Jcenter了。

gradle获取library

这里要了解一下我们看到的依赖所定义的方式，其实是有格式的并不是随便乱写的。其实你只要平常够仔细就能发现他们的格式是一样的。
由GroupId、ArtifactId与VersionId组成。例如com.jakewharton:butterknife:6.1.0'它的GroupId是com.jakewharton，ArtifactId是butterknife，VersionId是6.1.0。现在看这些依赖是不是更清晰了呢。当我们添加了依赖之后gradle会先去Maven中查找是否有该library如果有就会使用上面定义的形式下载http://jcenter.bintray.com/GroupId/ArtifactId/VersionId

http://jcenter.bintray.com/com/jakewharton/butterknife/6.1.0
通过该链接下载到本地再与我们的项目结合。

下面正式进行实现依赖的实现

注册

首先要在https://bintray.com 中注册账号，注册都是很简单的就不所说了。
然后回到主页在你的Owned Repositories中看下你是否已经添加了maven。
图
第一次注册的应该没有，所以我们要先New Repository创建maven
图
创建之后会自动跳转到maven中，你会发现没有package,我们可以Add New Package这种相信都会，我这里要说的是另外一种，我们直接在Android Studio中进行配置然后上传到Bintray。

代码中配置

分离成多个Module

为了使别人能更好的使用，我们一般在实现自己的依赖的时候会把实现的该依赖的源码作为一个Module,再把实例代码作为Application Module。所以我们要事先处理好Module，下面是我弄好的示例

图

添加bintray插件

在分了Module之后，首先在项目的根目录的build.gradle的
dependencies中添加bintray插件

1
2
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.2'
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3

添加bintray认证

找到local.properties文件在其中添加

1
2
bintray.user=xxxx
bintray.apikey=xxx

bintray.user是注册的user，至于bintray.apikey在JFrog Bintray中的Your Profile的Edit页面的API Key中能找到。

图

图

修改Module中的build.gradle

在其中添加如下示例代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
apply plugin: 'com.android.library'

ext {
    bintrayRepo = 'maven'
    bintrayName = 'mypicker'

    publishedGroupId = 'com.idisfkj.picker'
    libraryName = 'MyPicker'
    artifact = 'mypicker'

    libraryDescription = 'A pickerView on Android'

    siteUrl = 'https://github.com/idisfkj/idisfkj.picker'
    gitUrl = 'https://github.com/idisfkj/idisfkj.picker.git'

    libraryVersion = '1.2.1'

    developerId = 'idisfkj'
    developerName = 'idisfkj'
    developerEmail = 'idisfkj@qq.com'

    licenseName = 'The Apache Software License, Version 2.0'
    licenseUrl = 'http://www.apache.org/licenses/LICENSE-2.0.txt'
    allLicenses = ["Apache-2.0"]
}

同时在最后添加两个脚本

1
2
apply from: 'https://raw.githubusercontent.com/nuuneoi/JCenter/master/installv1.gradle'
apply from: 'https://raw.githubusercontent.com/nuuneoi/JCenter/master/bintrayv1.gradle'

这是我这个依赖的示例。其中bintrayRepo是默认的使用maven，mypicker是建立的package name，siteUrl是你的项目地址，我的项目在github上，所以是github项目的地址形式。gitUrl是VCS。其他应该没什么问题，相应的改成自己的信息。

这样就构建好了依赖com.idisfkj.picker:mypicker:1.2.1

上传到bintray

打开Android Studio的终端

编译library文件

在终端输入

1
./gradlew install

出现BUILD SUCCESSFUL就没问题

上传

在终端输入

1
./gradlew bintrayUpload

一样的出现BUILD SUCCESSFUL就没问题
然后你进入JFrog Bintray进入maven你就会发现其中多了一个package，如果有的话那就表示完美成功。

同步到Jcenter

完成了上面的步骤并不代表别人可以直接使用

1
2
3
dependencies {
    compile 'com.idisfkj.picker:mypicker:1.2.1'
}

还要添加

1
2
3
4
5
repositories {
    maven {
        url 'https://dl.bintray.com/idisfkj/maven/'
    }
}

所以我们要同步到Jcenter中，怎么同步呢？别急，只要在你刚刚生成的package中点击Add to Jcenter即可。

图

进去之后直接发送就可以，不需要填写什么。

图

最后就是等待了。几个小时之后你会收到考核通过的消息，再返回package就会发现Linked to发生了变化。

现在你也可以通过http://jcenter.bintray.com/com/idisfkj/picker/mypicker/1.2.1 查看。

图

同时别人也能使用你的依赖，通过如下简单的配置

1
2
3
dependencies {
    compile 'com.idisfkj.picker:mypicker:1.2.1'
}

版本更新

对于版本更新，只要更改上面配置的版本号libraryVersion = '1.2.1'改成你要更新的版本，其它不变。再重新上传到bintray。

总结

我这里再来整理下上传的思路。

  • 既然要上传到Jcenter上，自然要去https://bintray.com 中注册账号
  • 根据自己的需求创建maven的Repository
  • 把项目分离成Module
  • 在项目根目录的build.gradle中添加bintray插件
  • 在local.properties中添加bintray认证
  • 修改Module中的build.gradle中的配置
  • 在Android Studio终端使用./gradlew xxx上传
  • 最后在JFrog Bintray中同步到Jcenter中

转载请指明出处 idisfkj博客：https://idisfkj.github.io

支持一下
赞赏是一门艺术