教你轻松将Android library 发布到JCenter

JCenter是全世界最大的Java仓库,也是Android Studio中repositories的默认节点。JCenter支持Maven, Gradle, Ivy, SBT 等大部分构建工具。将项目发布到JCenter大致流程如下:

具体步骤:


第一步:注册Bintray拿到API Key

如果你已经有账号,则可以跳过这一步,直接往下看。 JCenter是由Bintray公司在维护,因此你必须注册一个Bintray账号,注册完账号后Bintray会分配给你一个API Key。 登陆后在首页右上角点击用户名选项下的”Your Profile”进入个人主页,然后点击用户名下面的Edit进入个人信息编辑页面,接下来点击页面左边列表的最后一项API Key。

第二步:发布前的配置

首先:添加maven-gradle、gradle-bintray插件

在项目的最外层的build.gradle文件中的dependencies节点下添加:

classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'   
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.6'

android-maven-gradle-plugin插件是用来打包Maven所需文件的。 gradle-bintray-plugin插件是用来将生成的Maven所需文件上传到Bintray的。

// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.0.0'
        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'
        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.6'
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}
allprojects {
    repositories {
        jcenter()
    }
}
task clean(type: Delete) {
    delete rootProject.buildDir
}   

其次,在library model下的build.gradle中进行相应配置

apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
// This is the library version used when deploying the artifact
version = "1.0.0"

def siteUrl = 'https://git.oschina.net/crazycodeboy/ScanProj'      // 项目的主页
def gitUrl = 'https://git.oschina.net/crazycodeboy/ScanProj.git'   // Git仓库的url
group = "com.jph.scan.zxing"                                        // 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 'multi-format 1D/2D barcode image processing use zxing.'
                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 'you id'		//填写的一些基本信息
                        name 'your name'
                        email 'your email'
                    }
                }
                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"
        name = "ScanProj"	//发布到JCenter上的项目名字
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true
    }
}
javadoc { //jav doc采用utf-8编码否则会报“GBK的不可映射字符”错误
    options{
        encoding "UTF-8"
        charSet 'UTF-8'
    }
}    

其实这些配置脚本也可以从model的build.gradle文件中抽离出来,现在下library model下创建一个bintrayUpload.gradle文件然后将上述代码复制进去,之后再library model的build.gradle中加入如下代码:

apply from: "bintrayUpload.gradle"  

最后,在local.properties文件中添加从Bintray申请到的API Key

#bintray
bintray.user=your bintray username
bintray.apikey=your apikey

建议将local.properties文件加入忽略文件中不上传,以保护你的apikey

第三步:将项目提交到Bintray

如果你一完成了上述的配置后,下面只需要一行代码就可以完成将项目提交到Bintray。 打开终端进入项目目录下,执行gradlew bintrayUpload命令即可。 执行完成后,打开你的bintray主页如果在”Owned Repositories”下的maven选中看到你的仓库,则说明你已经将你的仓库成功上传到bintray了。 如图:

第四步:将提交到Bintray的项目发布到JCenter

完成上述的步骤只是将项目提交到bintray,还无法使用该项目库,因为还没有发布到JCenter。 登入Bintray网站,进入个人中心,在右侧的Owned Repositories区域点击Maven的图标,进入你的Maven项目列表。 如果已经上传成功了,在这里就能看到你的项目,进入项目详情,在右下角的Linked To区域点击Add to JCenter,然后在Comments输入框里随便填写下信息,最后点Send提交请求即可。一般情况下当天就会审核,审核通过后会给你发邮件通知你,并且以后更新项目就不需要再审核了。 审核成功后就可以使用你发布到JCenter上的项目了。

使用你发布到JCenter上的项目 在Bintray的搜索输入框中输入你的项目: 如图:

单击搜索结果中你的项目,进入项目预览便可以看到项目的引用方式: 如图:

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏Aox Lei

安装sentry

Sentry 是一个开源的实时错误报告工具,支持 web 前后端、移动应用以及游戏,支持 Python、OC、Java、Go、Node、Django、RoR 等...

3933
来自专栏Java帮帮-微信公众号-技术文章全总结

c3p0,DBPC,Druid三大连接池的区别/性能【面试+工作】

2092
来自专栏小白安全

小白博客 ZAP-OWASP Zed攻击代理工具的使用-kali Linux

ZAP-OWASP Zed攻击代理是一个易于使用的综合渗透测试工具,用于查找Web应用程序中的漏洞。 这是一个Java界面。 步骤1 - 要打开ZapPr...

57511
来自专栏C/C++基础

C++实现简易log日志系统

在软件开发周期中,不管是前台还是后台,系统一般会采用一个持久化的日志系统来记录运行情况。

4822
来自专栏北京马哥教育

史上最全Linux命令科普 | 常见命令的名称是怎么来的?

1 目录缩写 缩写 | 全称 | 说明 --- | --- | --- | /bin | BINaries | 二进制可执行命令 /dev | DEVices...

3235
来自专栏FreeBuf

利用Web查询文件(.iqy)有效钓鱼

几天前我在Casey Smith的twitter上看到了有关iqy文件的一些介绍,和大多数渗透测试人员或者技术狂热者一样我也在探寻它的价值。能够通过使用本地/可...

2856
来自专栏杨建荣的学习笔记

MySQL源码安装总结(r12笔记第12天)

作为一个DBA, MySQL源码安装还是要做做的,虽然不是推荐线上批量安装部署,但是自己作为了解MySQL的一个学习过程,还是值得的。 相比商业...

3147
来自专栏开发技术

spring-session实现分布式集群session的共享

  HttpSession是通过Servlet容器创建和管理的,像Tomcat/Jetty都是保存在内存中的。但是我们把应用搭建成分布式的集群,然后利用LVS或...

1191
来自专栏Java修行之道

常用数据库连接池 (DBCP、c3p0、Druid) 配置说明

数据库连接是一种关键的有限的昂贵的资源,这一点在多用户的网页应用程序中体现得尤为突出。对数据库连接的管理能显著影响到整个应用程序的伸缩性和健壮性,影响到程序的性...

3104
来自专栏木木玲

Netty 那些事儿 ——— Reactor模式详解

5037

扫码关注云+社区

领取腾讯云代金券