介绍如何将自己的项目上传到JCenter。
前言
我们经常在Android的gradle文件中看到这些compile脚本,这些脚本其实就是因为之前库的开发者把对应库的jar或aar文件放到了远程服务器上,所以我们可以通过compile进行拉取。
compile 'com.android.support:recyclerview-v7:27.0.0'
compile 'com.squareup:otto:1.3.7'
compile 'com.squareup.picasso:picasso:2.5.2'
compile 'com.squareup.okhttp:okhttp:2.4.0'
compile 'com.squareup.retrofit:retrofit:1.9.0'
AAR是什么
因为AndroidLibrary一般需要内置一些Android特定文件,比如Manifest,Resources,Assets或者JNI等超出jar文件标准的格式。
jar包是被嵌入在aar文件包中的一部分。
排布规则
compile后面的字符串排布规则是
GROUP_ID:ARTIFACT_ID:VERSION
GROUP_ID
通常用开发者的包名进行命名。
很有可能同一个上下文中有好几个library,这些可以共享同一个GROUP_ID
ARTIFACT_ID
定义library的真实名字,比如picasso
VERSION
版本号,一般是x.x.x格式
Android项目准备
以一个简单的demo为例,项目地址在
https://github.com/hgDendi/AndroidJCenterDemo
是一个HelloWorld项目,其中字符串来自于mylib module下的MyLib抽象类的静态方法。
mylib也是我们这次需要上传到JCenter的类。
[图片上传失败...(image-a4b23-1510618281773)]
Module划分
一般需要把需要上传的库作为一个独立的module,即1 module per 1 library。
一般分为库的模块和使用demo模块。
如果想要有一个以上的库,请划分多个module。
比如如下的项目结构。[图片上传失败...(image-ff756-1510618281774)]
bintray
注册账号,登录bintray.com。
新建仓库
在个人管理界面点击“Add New Repository”
[图片上传失败...(image-3108f-1510618281774)]
然后创建一个Maven仓库
[图片上传失败...(image-9d5e82-1510618281774)]
创建成功之后点击"Create New Package"
[图片上传失败...(image-2c9ca8-1510618281774)]
输入对应信息,其中Website和VersionControl可以填写github地址,issue填写github的issue地址
[图片上传失败...(image-6992a7-1510618281774)]
点击CreatePackage,你在Bintray上的Maven服务器就已经创建成功了。
项目文件准备
Project#gradle
在Project的gradle文件中加入依赖
buildscript {
...
dependencies {
classpath 'com.android.tools.build:gradle:3.0.0'
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.6'
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.4.1'
}
}
local.properties
在local.properties中加入用户信息。
因为gitignore自动忽略local.properties,所以私人信息放在这里是比较安全的。
bintray.user=[...]
bintray.apikey=[...]
bintray.gpg.password=[...]
apikey可以在EditProfile里看到
[图片上传失败...(image-3526b1-1510618281774)]
module的build.gradle
根据上面步骤中的信息,在lib module的build.gradle文件中增加信息。
apply plugin: 'com.android.library'
ext {
// 刚刚创建的仓库名
bintrayRepo = 'testMaven'
// package的名字
bintrayName = 'mylib'
// owner的groupID
publishedGroupId = 'com.hgDendi.test'
libraryName = 'MyLib'
artifact = 'mylib'
libraryDescription = 'lib test demo'
siteUrl = 'https://github.com/hgDendi/AndroidJCenterDemo'
gitUrl = 'https://github.com/hgDendi/AndroidJCenterDemo.git'
libraryVersion = '0.0.1'
developerId = 'dendi'
developerName = 'Dendi Chan'
developerEmail = 'hg.dendi@gmail.com'
licenseName = 'The MIT License'
licenseUrl = 'https://rem.mit-license.org'
allLicenses = ["MIT"]
}
如上所示,则最后生成的gradle script会是
compile 'com.hgdendi.test:mylib:0.0.1'
增加脚本依赖
在lib module的build.gradle文件下增加一行apply from
apply from: 'https://raw.githubusercontent.com/hgDendi/AndroidJCenterDemo/master/bintray.gradle'
apply from: 'https://raw.githubusercontent.com/hgDendi/AndroidJCenterDemo/master/maveninstall.gradle'
上传代码
执行gradlew命令将lib上传
./gradlew install
./gradlew bintrayUpload
这时候登录bintray,就可以看到上传结果了。
[图片上传失败...(image-652553-1510618281774)]
同步到jcenter
此时代码还是只在你的maven仓库,并未同步到JCenter中。
这时候点进你的package,点击AddToJCenter就可以将代码上传到JCenter。
[图片上传失败...(image-2332df-1510618281774)]
上传成功
同步到JCenter有时候可能需要半天到一天的时间。
同步成功后,便可以使用compile从服务器拉取lib了。
dependencies {
// implementation project(':mylib')
compile 'com.hgDendi:mylib:1.0.0'
}