Android library分享到jcenter

发表于 | 分类于 | 阅读次数： 
1
2
3
dependencies {
  compile 'com.wuxiaolong.pullloadmorerecyclerview:library:1.0.4'
}

build.gradle文件中只写上如上一行，就能在Android Studio中引入你的library到项目中，这样岂不是酷比了。之前github上分享一个简单的库，这两天花了点时间研究了下，如何也能这样一行就能依赖我的那个库。

申请bintray账号

jcenter是一个由 bintray.com维护的Maven仓库 。
在bintray.com上注册一个账号。然后点击maven。点击Add New Package，为我们的library创建一个新的package。命名所有字母应该为小写，单词之间用－分割。

配置

library项目最好分成两个module，一个Application Module，一个Library Module。Application Module用于展示库的用法，Library Module是library的源代码。

配置项目

修改项目的build.gradle文件中的依赖部分

1
2
3
4
5
dependencies {
        classpath 'com.android.tools.build:gradle:1.5.0'
        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.2'
        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'
    }

打开项目的local.properties，加入以下两句:

1
2
bintray.user=your_user_name
bintray.apikey=your_apikey

bintray username 放在第一行， API Key放在第二行， API Key为你bintray的账户的apikey，可以点击进入你的账户信息里再点击Edit即有查看API Key的选项，把他复制下来。
这些信息比较重要，幸而local.properties文件就已经被添加到.gitignore了。因此这些敏感数据不会被误传到git服务器。

配置library

很多，具体配置可参考我的开源库PullLoadMoreRecyclerView。

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
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
apply plugin: 'com.android.library'
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
// 这个version是区分library版本的，因此当我们需要更新library时记得修改这个version, 这个version影响后面的引用
version = "1.0.4"
android {
    compileSdkVersion 23
    buildToolsVersion "22.0.1"
    resourcePrefix "PullLoadMoreRecyclerView"	//这个随便填
    defaultConfig {
        minSdkVersion 14
        targetSdkVersion 22
        versionCode 101
        versionName "1.0.4"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}
dependencies {
    compile fileTree(include: ['*.jar'], dir: 'libs')
    compile 'com.android.support:appcompat-v7:22.2.0'
    compile 'com.android.support:recyclerview-v7:22.2.0'
}
def siteUrl = 'https://github.com/WuXiaolong/PullLoadMoreRecyclerView'      // 项目的主页
def gitUrl = 'https://github.com/WuXiaolong/PullLoadMoreRecyclerView.git'   // Git仓库的url
group = "com.wuxiaolong.pullloadmorerecyclerview"                                        // Maven Group ID for the artifact，一般填你唯一的包名
install {
    repositories.mavenInstaller {
        // This generates POM.xml with proper parameters
        pom {
            project {
                packaging 'aar'
                // Add your description here
                name 'RecyclerView实现下拉刷新和上拉加载更多以及瀑布流效果' 	//项目描述
                url siteUrl
                // Set your license
                licenses {
                    license {
                        name 'The Apache Software License, Version 2.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }
                developers {
                    developer {
                        id 'WuXiaolong'		//填写的一些基本信息
                        name 'WuXiaolong'
                        email '1413129987@qq.com'
                    }
                }
                scm {
                    connection gitUrl
                    developerConnection gitUrl
                    url siteUrl
                }
            }
        }
    }
}
task sourcesJar(type: Jar) {
    from android.sourceSets.main.java.srcDirs
    classifier = 'sources'
}
task javadoc(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
    options.encoding = "UTF-8" //添加编码方式，才不会报编码错误
}
task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}
artifacts {
    archives javadocJar
    archives sourcesJar
}
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
    user = properties.getProperty("bintray.user")
    key = properties.getProperty("bintray.apikey")
    configurations = ['archives']
    pkg {
        repo = "maven"
        name = "pullloadmorerecyclerview"	//发布到JCenter上的项目名字
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true
    }
}

上传library到bintray空间

请到Android Studio的终端（Terminal）选项卡。
检查代码的正确性，输入下面的命令：

1
gradlew install

如果没有什么问题，会显示：

1
BUILD SUCCESSFUL

上传编译的文件到bintray，使用如下的命令：

1
gradlew bintrayUpload

如果显示如下说明成功了！

1
BUILD SUCCESSFUL


上传完成即可在Bintray网站上找到你的Repo，我们需要完成最后一步工作，申请你的Repo添加到JCenter。可以进入这个页面，点击Include My Package，输入你的项目名字，点击匹配到的项目，直接send即可，然后就等管理员批准了。

如上，网站上会给你一条通过信息，然后就OK了，大功告成。

1
compile 'com.wuxiaolong.pullloadmorerecyclerview:library:1.0.4'

一般来说，我们需要知道library的字符串形式，包含3部分
GROUP_ID:ARTIFACT_ID:VERSION
上面的例子中，GROUP_ID是com.wuxiaolong.pullloadmorerecyclerview ，即配置library中group的值；ARTIFACT_ID是library，配置library中没有写到，是library项目的名字；VERSION是1.0.4。
查看bintray上库：
http://jcenter.bintray.com/com/wuxiaolong/

关于作者

点击查看

附录

如何使用Android Studio把自己的Android library分享到jCenter和Maven Central
将Library上传到Jcenter



联系作者

我的微信公众号：吴小龙同学，欢迎关注交流，公号回复关键字「1024」有惊喜哦。