目的
发布arr(Android library 项目)到jCenter 远程仓库,这样所有人都可以通过Gradle方式引用。选择jcenter是因为它兼容maven,而且支持更多形式仓库,android studio最新版本已经默认jcenter了。
平台准备
在 https://bintray.com/ 上注册一个账号,获取API key。
生成 javaDoc 和 source JARS
Maven Central 和 jCenter都需要上传项目的javaDoc 和 source JARS。添加插件 android-maven-plugin 用来生成 javaDoc 和 source JARS。通过bintray 上传需要添加官方插件 gradle-bintray-plugin。在主项目最外层build.gradle 文件 buildscript/dependencies中添加插件。
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:1.5.0'
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0'
classpath 'com.github.dcendents:android-maven-plugin:1.2'
classpath 'net.sf.proguard:proguard-gradle:4.10'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
allprojects {
repositories {
jcenter()
}
}
在需要发布的app Module的build.gradle 文件中添加 生成javadoc和source jar的tasks等。下面的以游戏分析1.0 为例子。
apply plugin: 'com.android.library'
//需要的插件
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
// This is the library version used when deploying the artifact
version = "2.7.5"
android {
compileSdkVersion 22
buildToolsVersion '22.0.1'
defaultConfig {
minSdkVersion 11
targetSdkVersion 22
versionCode 275
versionName "2.7.5"
}
buildTypes {
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'pro_DataEye_Android_2.7.1_100271000.pro'
}
}
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
testCompile 'junit:junit:4.12'
}
//定义 group
group = "com.dataeye.sdk.ga_v1"
def siteUrl = 'https://github.com/DataEye' // project homepage
def gitUrl = 'https://github.com/DataEye' // project git
install {
repositories.mavenInstaller {
// This generates POM.xml with proper parameters
pom {
project {
packaging 'aar'
name 'GASdk_V1'
url siteUrl
licenses {
license {
name 'The Apache Software License, Version 2.0'
url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
}
}
developers {
developer {
id 'cristianohao'
name 'cristianohao'
email 'gonghao@dataeye.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))
}
javadoc {
options{
encoding "UTF-8"
charSet 'UTF-8'
links "http://docs.oracle.com/javase/7/docs/api"
}
}
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 = "GASdk_V1" // project name in jcenter
websiteUrl = siteUrl
vcsUrl = gitUrl
licenses = ["Apache-2.0"]
publish = true
}
}
本地 local.properties 添加API key
bintray.user=deandroid // your bintray user name
bintray.apikey=358f11719ba4289156e6195a7e6753584258f6f3 // your bintray api key
通过gradew执行这些任务完成发布。
gradlew javadocJar
gradlew sourcesJar
gradlew install
gradlew bintrayUpload
关于审核
当bintrayUpload成功之后,在自己的主页https://bintray.com/openproject/右下部分Latest Activity,会看到提交了一个项目。
进入详情页,提交审核就可以了。审核时间大概6小时左右。审核通过后,下次更新版本号发布就无需审核了。
引用
发布成功后就可以直接引用
dependencies {
...
compile 'com.dataeye.sdk.ga_v1:ga:2.7.5'
}