教你轻松将Android library 发布到JCenter
2016-05-14 17:32
471 查看
JCenter是全世界最大的Java仓库,也是Android Studio中repositories的默认节点。JCenter支持Maven, Gradle, Ivy, SBT 等大部分构建工具。将项目发布到JCenter大致流程如下:
JCenter是由Bintray公司在维护,因此你必须注册一个Bintray账号,注册完账号后Bintray会分配给你一个API Key。
登陆后在首页右上角点击用户名选项下的”Your Profile”进入个人主页,然后点击用户名下面的Edit进入个人信息编辑页面,接下来点击页面左边列表的最后一项API Key。
android-maven-gradle-plugin插件是用来打包Maven所需文件的。
gradle-bintray-plugin插件是用来将生成的Maven所需文件上传到Bintray的。
其实这些配置脚本也可以从model的build.gradle文件中抽离出来,现在下library model下创建一个bintrayUpload.gradle文件然后将上述代码复制进去,之后再library model的build.gradle中加入如下代码:
建议将local.properties文件加入忽略文件中不上传,以保护你的apikey
打开终端进入项目目录下,执行gradlew bintrayUpload命令即可。
执行完成后,打开你的bintray主页如果在”Owned Repositories”下的maven选中看到你的仓库,则说明你已经将你的仓库成功上传到bintray了。
如图:
登入Bintray网站,进入个人中心,在右侧的Owned Repositories区域点击Maven的图标,进入你的Maven项目列表。
如果已经上传成功了,在这里就能看到你的项目,进入项目详情,在右下角的Linked To区域点击Add to JCenter,然后在Comments输入框里随便填写下信息,最后点Send提交请求即可。一般情况下当天就会审核,审核通过后会给你发邮件通知你,并且以后更新项目就不需要再审核了。
审核成功后就可以使用你发布到JCenter上的项目了。
使用你发布到JCenter上的项目
在Bintray的搜索输入框中输入你的项目:
如图:
单击搜索结果中你的项目,进入项目预览便可以看到项目的引用方式:
如图:
具体步骤:
第一步:注册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的搜索输入框中输入你的项目:
如图:
单击搜索结果中你的项目,进入项目预览便可以看到项目的引用方式:
如图:
相关文章推荐
- Android07-Android广播
- android studio jni开发gradle 学习
- Android 各层中日志打印功能的应用
- Android用Canvas画钟表仪
- 15 个 Android 通用流行框架大全
- android 实现一键锁屏功能
- Android学习笔记——OAuth完全手册_国内篇
- Android中ExpandableListView控件基本使用
- android开发笔记之多媒体—图像的操作
- Android ViewPager被嵌套在ScrollView中不显示的问题的解决方案
- Android 高清加载长图或大图方案
- android NDK方式调用Jar包
- Android高级图片滚动控件,编写3D版的图片轮播器
- Android中的Matrix
- Android之自定义ViewGroup
- android开发笔记之多媒体—大图片的加载
- Android属性动画完全解析,Interpolator和ViewPropertyAnimator的用法
- android应用界面编程(四)--ImageView及其子类
- Android 拍照或者从相册获取图片的实现
- Android 滑动冲突,事件分发机制的详解