通过Gradle打包发布函数库到JCenter

AndroidStudio将远程仓库默认指定为Jcenter仓库,位于Bintray网站。Bintray网站下面还有其他好几个仓库。本文主要介绍如何将Android项目发布到Jcenter。

、注册Bintray账号

Bintray官网:https://bintray.com


通过Gradle打包发布函数库到JCenter_第1张图片

也可使用GitHub账号登录

二 、获取APIKey

上传项目之前我们需要两样东西,一个就是用户名,另一个是APIKey。APIKey可在这里查看。


通过Gradle打包发布函数库到JCenter_第2张图片

三、插件依赖

在项目最外层的build.gradle添加“gradle-bintray-plugin”以及“android-maven-plugin”插件的依赖。

四、Module配置

在需要发布到Jcenter的module(比如library)的build.gradle里配置以下内容:

apply plugin: 'com.android.library'

apply plugin: 'com.github.dcendents.android-maven'

apply plugin: 'com.jfrog.bintray'

version = "1.0.0" // 版本号

android {

compileSdkVersion 23

buildToolsVersion "23.0.3"

resourcePrefix "bankcardformat" // 随意命名

defaultConfig {

minSdkVersion 15

targetSdkVersion 23

versionCode 1

versionName "1.0"

}

buildTypes {

release {

minifyEnabled false

proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'

}

}

}

dependencies {

compile 'com.android.support:appcompat-v7:23.+'

compile fileTree(dir: 'libs', include: ['*.jar'])

}

def siteUrl = 'https://github.com/smuyyh/BankCardFormat'    // Git项目主页

def gitUrl = 'https://github.com/smuyyh/BankCardFormat.git' // Git仓库url

group = "com.yuyh.bankcardformat" // 一般为包名

install {

repositories.mavenInstaller {

// 生成POM.xml

pom {

project {

packaging 'aar'

name 'Android BankCardFormat' // 项目描述

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 'smuyyh'

name 'smuyyh'

email '[email protected]'

}

}

scm {

connection gitUrl

developerConnection gitUrl

url siteUrl

}

}

}

}

}

task sourcesJar(type: Jar) {

from android.sourceSets.main.java.srcDirs

classifier = 'sources'

}

task javadoc(type: Javadoc) {

options.encoding = "UTF-8" // 设置编码,否则中文可能会提示出错

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" // 发布到Maven库

name = "BankCardFormat" // 发布到JCenter上的项目名字

websiteUrl = siteUrl

vcsUrl = gitUrl

licenses = ["Apache-2.0"]

publish = true

}

}

五、配置Username和APIKey

在local.properties文件配置Username和APIKey。

bintray.user= xxxx

bintray.apikey= xxxx

正常情况下local.properties应该加入到.gitignore文件里,因为这两项属于隐私信息,无需上传到GitHub。当然了,也可把bintray.user及bintray.apiKey配置在Gradle用户目录下的gradle.properties(不存在则新建),例如Windows是在C:/user/username/.gradle,OSX和Linux在~/.gradle

六、ReBuild

Rebuild一下项目,会发现在/build/outputs/aar下生成两个文件,这就是library打包出来的二进制文件。

七、上传项目到Jcenter

在Android Studio的Terminal执行以下命令:

gradlew javadocJar

gradlew sourcesJar

gradlew install

gradlew bintrayUpload

执行成功之后,在Bintray个人主页下面可以看到Maven多了一个Package。


通过Gradle打包发布函数库到JCenter_第3张图片

八、申请项目加入Jcenter

九、等待审核

审核速度挺快,一般几个小时左右会通过。Bintray会向您发送一条成功的信息。那么就完成上传了。

项目依赖

dependencies{    compile'com.yuyh.bankcardformat:library:1.0.0'}

项目更新

上传的库进行升级的时候,须更改build.gradle下的version、versionCode、versionName,否则无法进行打包上传。更改完之后重新执行上传项目到Jcenter步骤。上传完成可在项目主页下看到更新的版本号。

———-

通过Gradle打包发布函数库到JCenter_第4张图片

问题

若在上传的时候,出现GBK编码错误,尝试在task javadoc(type: Javadoc) 下设置UTF-8编码:

options.encoding = “UTF-8”

无法解决请参考以下这个Gradle文件的配置:

https://github.com/msdx/gradle-publish/blob/master/bintray.gradle

你可能感兴趣的:(通过Gradle打包发布函数库到JCenter)