新版的Android Studio会将远程仓库指定为Jcenter,那Jcenter在哪里?它是干嘛的呢?
要回答这个问题,我们要了解一个公司,叫做jfog,它有个网站是Bintray,这个网站类似于github,但关注的领域不一样,github管理的是文本文件,而Bintray专注于管理二进制文件,个人感觉有些类似yy和qq的关系。扯回来,我们今天的主人公Jcenter就存放在Bintray网站里,Bintray下有名的库可不止Jcenter只一个,rpm-center,rubyinstaller都是它里面的仓库。所以,如果我们想把自己的开源库存放在Jcenter上供其它人使用,主要步骤如下:
我们需要注册Bintray账号,然后上传我们的项目到Bintray,最后在Bintray里提交我们的项目,管理员会对项目审核,通过后我们就可以在Gradle里通过制定远程位置来使用自己的库了。好,Let Go!
注册Bintray账号
Bintray官网传送门:https://bintray.com/
但很遗憾的是这个网站国内访问有点尴尬,你需要翻墙才可以。
Bintray是支持Github登陆的,也比较推荐在这种方式,(这里我真的想吐槽下某些sb网站做的连排泄物都不如,通过第三方登陆像还得重新注册!还得手机验证,这种网站必须拉黑)
登陆之后我们需要两个参数,一个是我们的用户名,另外一个就是api key,api key的获取可以参照我下面的gif图片:
先记得这两个数据的获取方式,一会我们会用到。
上传自己的Library到Bintray
关于怎样使用Android Studio创建Library这里就不多讲,这里假设我们有一个自己将要上传到Binray,我这里的Library很简单,简单到不需要res文件,是我编写和整理的和Android相关的工具类,我把这个Librasy命名为utils,整个Library目录结构如下:
接下里的步骤比较繁琐,Gradle已经支持通过命令来上传Library到Bintray,但项目的相关信息需要在gradle的配置文件中制定,首先我们需要打开utils这个module下的build.gradle文件,将其替换如下:
apply plugin: 'com.android.library'
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
// 这个version是区分library版本的,因此当我们需要更新library时记得修改这个version
version = "1.0.0"
android {
compileSdkVersion 21
buildToolsVersion "21.1.1"
resourcePrefix "随便填"
defaultConfig {
minSdkVersion 9
targetSdkVersion 21
versionCode 1
versionName version
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
}
def siteUrl = 'https://github.com/saymagic/AndroidUtils' // 项目的主页
def gitUrl = 'https://github.com/saymagic/AndroidUtils.git' // Git仓库的url
group = "cn.saymagic" // 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 'Android Commonly used utils' //项目描述
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 'saymagic' //填写开发者基本信息
name 'saymagic'
email 'cymmagic@gmail.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))
}
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" //发布到Bintray的那个仓库里,默认账户有四个库,我们这里上传到maven库
name = "utils" //发布到Bintray上的项目名字
websiteUrl = siteUrl
vcsUrl = gitUrl
licenses = ["Apache-2.0"]
publish = true
}
}
注意里面的信息需要按照自己的个人资料进行修改。
因为上述的文件里需要依赖一些其它的库,所以接下来再到我们项目最外层build.gradle文件里,添加如下两个依赖
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0'
classpath 'com.github.dcendents:android-maven-plugin:1.2'
修改后的文件如下:
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:1.0.0'
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0'
classpath 'com.github.dcendents:android-maven-plugin:1.2'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
allprojects {
repositories {
jcenter()
}
}
最后,我们在打开项目最外层的local.properties文件,添加如下两行:
bintray.user=your_user_name
bintray.apikey=your_apikey
your_user_name和your_apikey这两个数据就是我们在第一步注册Bintray时提到的两个参数,
解析来,在项目的根目录下执行
第一步是检查代码的正确性,以及编译library文件(aar,pom等等),输入下面的命令:
> gradlew install
如果没有什么问题,会显示:
BUILD SUCCESSFUL
现在我们已经成功一半了。下一步是上传编译的文件到bintray,使用如下的命令:
gradlew bintrayUpload
如果显示如下你就大喊一声eureka吧!
SUCCESSFUL
在bintray的网页上检查一下你的package。你会发现在版本区域的变化
这样,我们就可以到到我们的module下会生成如下目录:/build/outputs/aar/
在arr目录下有如下两个文件:
以arr文件结尾的就是Gradle将我们的library打包成的二进制文件,别忘记了,Bintray就是用于存储二进制文件的仓库,所以执行下面的命令。就可以将我们的library上传到Bintary。
上传成功之后,就会在bintray的maven仓库下看到我们上传的Library:
提交项目到Jcenter
我们点开我们刚刚提交项目的主页,点击右下角的add to jcenter按钮
接下来写一些评论:
点击send后就可以等管理员的审核了。
大概一小时后,管理员就会审核通过:
这样,我们就可以在Dependence里这样来引用我们自己的项目了:
dependencies {
compile 'cn.saymagic.utils:utils:1.0.0'
}
参考
https://www.virag.si/2015/01/publishing-gradle-android-library-to-jcenter/
http://stackoverflow.com/questions/24852219/android-buildscript-repositories-jcenter-vs-mavencentral