最近小明正在看一本名叫《历代经济变革得失》从历史角度分析经济变化的书。通过研究经济方式,作为一个工科毕业的小明,当然直接想到是数据统计,建立数学理论模型,这本书入手方式就成为了第一个吸引点。除了耳熟能详的历史事件人物,阶级的斗争之外,留下深刻印象的还是封闭专制和开放改革之间的博弈。彰显出活力生态,Open和Share是一个很好的选择。
上个月27号开源Pluto框架《我的开源Android开发框架Pluto》,得到客观上多正面的反馈。至此,进入这次主观上的第二步,将Pluto变的更容易使用--将Pluto作为library分享到jCenter。
一.文章价值
1、实现我的框架Pluto分享到jCenter,以后开发直接用一句gradle语句就可以使用框架。
2、严格参照我的实现步骤,就不用在其他blog一篇篇阅读总结踏坑才实现自己的library分享。
dependencies {
compile 'com.minggo:Pluto:1.0'
}
其中,bintray.com要熟悉,要不要翻墙?不用;Gradle配置要分清楚配置library的Gradle还是Project Gradle;编译和上传要多久?编译保证不出错就行,上传普遍是1分钟;link to jCenter审核要多久,我的是3个小时。
二.bintray账号设置
1.新官网整体认知
其中“View Profile”是个人中心,下边会介绍获取appkey."Add New Organization"是添加组织,这个比较重要,为了保证顺利上传,手动配置自己Organization更为合适。
2.添加组织
1)选择创建新组织
2)根据填写组织相关信息,主要完成带星的填写就行
3)查看创建完成的组织页面
3.创建创库
手动配置自己的仓库尤为重要,注意创库名。因为pluto仓库名将会在Gradle文件中做关联,type选Maven主要针对本文实现的方式,必须选择。关于版权License选择是个可选选项,我的Pluto项目在github上创建的时候就选择了MIT,所以就选择MIT。创库描述也是一个可选填写,我就把Pluto在github上的描述添加上去了。
在组织页面下就可以看见一下仓库,需要了解可以点击去看看。
4.获取自己的apikey
依次点击页面“Edit Profile”-->"API Key" -->"Show",最好先复制存下来,等下gradle配置用到。
三.Gradle配置
1.整体要留意的3个地方
第一处,Project的gradle用来配置maven和bintray插件用的;第二处,Library的gradle用来配置版本、仓库等等用的;第三处,local.properties用来配置bintray的账号和apikey用的。那么关键内容将会在Library的gradle中。
2.Project的Gradle配置maven和bintray插件
找到Project的Gradle文件,在dependencies 中添加一下两句插件路径
dependencies {
//Gradle Android Maven plugin
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.4.1'
//Gradle Bintray Plugin
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.1'
}
更详细的Gradle Android Maven plugin和Gradle Bintray Plugin。
3.local.properties的账号和appkey配置
找到local.properties文件
bintray.user=minggo620 // bintray用户名
bintray.apikey=ab02158f80eaa139423axxxxxxxxxx //bintray API KEY
之前复制下来的apikey派上用场了,粘贴到local.properties文件后边。为什么放在这个文件原因是项目.gitignore文件默认忽略这个文件上传,正好免除暴露key。
4.Library的Gradle配置
找到Library的Gradle文件,进行一下配置
1)引用Maven和bintray插件
头部加上
apply plugin: 'com.jfrog.bintray'
apply plugin: 'com.github.dcendents.android-maven'
2)读取local.properties文件
头部加上接上
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
3)配置必要和可选常量
比如最终形式是 compile 'com.minggo:Pluto:1.0'
那么group和version如下。至于Pluto是Library的名称,在执行任务中会配置。
def siteUrl = 'https://github.com/minggo620/Pluto-Android' // 项目的主页
def gitUrl = 'https://github.com/minggo620/Pluto-Android.git' // Git仓库的url
version = "1.0"
group = "com.minggo"
4)配置bintray配对任务
以下写有注释的都要注意,特别是repo的值是自己创建的仓库名称不是仓库类型,name写是Library名称。license只能写bintray提供选择类型,userOrg填写bintray后台创建organization。强调这个的原因是本人看了其他文章发现容易产生误解的地方。
bintray {
user = properties.getProperty("bintray.user")
key = properties.getProperty("bintray.apikey")
pkg {
repo = 'pluto'//自己bintray创建仓库名字
name = 'Pluto'//Library的名字
websiteUrl = siteUrl
vcsUrl = gitUrl
licenses = ['MIT']//不能随便写,只能是仓库创建时选择的license type
userOrg = 'minggoopen' //自己bintray创建的organization名称
publish = true // 是否是公开项目。
version {
name = '1.0'
desc = 'High integrated development framework for Android applications.'
released = new Date()
vcsTag = 'v1.0'
attributes = ['gradle-plugin': 'com.use.less:com.use.less.gradle:gradle-useless-plugin']
}
}
configurations = ['archives']
}
5)配置maven的Install任务
这个部分重要的就会生成POM.xml,如果没有执gradlew install就执行Studio 中Gradle栏的publishing下bintrayUpload会提示,没有默认default pom.xml。
install {
repositories.mavenInstaller {
// This generates POM.xml with proper parameters
pom {
project {
packaging 'aar'
// Add your description here
name 'Pluto Android'
description 'High integrated development framework for Android applications.'
url siteUrl
// Set your license
licenses {
license {
name 'MIT'
url 'https://raw.githubusercontent.com/minggo620/Pluto-Android/master/LICENSE'
}
}
developers {
developer {
id 'minggo620' //填写bintray或者github的用户名
name 'minggo' //姓名,可以是中文
email 'minggo8en@gmail.com'
}
}
scm {
connection gitUrl
developerConnection gitUrl
url siteUrl
}
}
}
}
}
6)配置源码和文档任务
记得在以下响应地方添加 failOnError false,否则出现install执行出现build failed。
task sourcesJar(type: Jar) {
from android.sourceSets.main.java.srcDirs
classifier = 'sources'
}
task javadoc(type: Javadoc) {
failOnError false //必须添加以免出错
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
}
7)这是我Library的Gradle完整配合
apply plugin: 'com.android.library'
apply plugin: 'android-apt'
apply from: "dependencies.gradle"
apply plugin: 'com.jfrog.bintray'
apply plugin: 'com.github.dcendents.android-maven'
def siteUrl = 'https://github.com/minggo620/Pluto-Android' // 项目的主页
def gitUrl = 'https://github.com/minggo620/Pluto-Android.git' // Git仓库的url
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
version = "1.0"
group = "com.minggo"
android {
compileSdkVersion 23
buildToolsVersion "24.0.3"
defaultConfig {
minSdkVersion 14
targetSdkVersion 23
versionCode 1
versionName "1.0"
consumerProguardFiles 'proguard-rules.pro'
}
buildTypes {
release {
minifyEnabled false
}
}
}
bintray {
user = properties.getProperty("bintray.user")
key = properties.getProperty("bintray.apikey")
pkg {
repo = 'pluto'//自己bintray创建仓库名字
name = 'Pluto'//Library的名字
websiteUrl = siteUrl
vcsUrl = gitUrl
licenses = ['MIT']//不能随便写,只能是仓库创建时选择的license type
userOrg = 'minggoopen' //自己bintray创建的organization名称
publish = true // 是否是公开项目。
version {
name = '1.0'
desc = 'High integrated development framework for Android applications.'
released = new Date()
vcsTag = 'v1.0'
attributes = ['gradle-plugin': 'com.use.less:com.use.less.gradle:gradle-useless-plugin']
}
}
configurations = ['archives']
}
install {
repositories.mavenInstaller {
// This generates POM.xml with proper parameters
pom {
project {
packaging 'aar'
// Add your description here
name 'Pluto Android'
description 'High integrated development framework for Android applications.'
url siteUrl
// Set your license
licenses {
license {
name 'MIT'
url 'https://raw.githubusercontent.com/minggo620/Pluto-Android/master/LICENSE'
}
}
developers {
developer {
id 'minggo620' //填写bintray或者github的用户名
name 'minggo' //姓名,可以是中文
email 'minggo8en@gmail.com'
}
}
scm {
connection gitUrl
developerConnection gitUrl
url siteUrl
}
}
}
}
}
task sourcesJar(type: Jar) {
from android.sourceSets.main.java.srcDirs
classifier = 'sources'
}
task javadoc(type: Javadoc) {
failOnError false
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
}
四.执行install和upload
window和mac命令有些不一样,mac命令前边加./
再敲命令。以下是window执行方式。
1.确保Gradle已经安装
在studio中 Terminal中执行查看安装情况,如果没有会自动安装。
gradlew -v
安装情况如下:
2.执行install任务
gradlew install
结果如下:
:Pluto:bundleRelease UP-TO-DATE
:Pluto:javadoc UP-TO-DATE
:Pluto:javadocJar UP-TO-DATE
:Pluto:sourcesJar UP-TO-DATE
:Pluto:install
BUILD SUCCESSFUL
3.执行upload任务
gradlew bintrayUpload
1分钟后结果如下:
:Pluto:install
:Pluto:bintrayUpload
BUILD SUCCESSFUL
Total time: 1 mins 33.999 secs
五.Link to jCenter
进入bintray的Organization仓库管理后台找到自己的对应的仓库发现一个package如下图
进入Package进行看到上传后的结果以下两个红色框框关键信息
如果是未发布将会出现一下link提示,这时就可以点击提交审核了。
完成这一步剩下的就是邮箱等待了。3个小时后...
六.文章总结
就这样,我的Android开发框架Puto做了Library分享到了jCenter。以后每次更新就只需要修改gradle的compile 'com.minggo:Pluto:1.0'
。对于使用Pluto框架的开发者来说就不必再去github下载源码拷贝到自己的项目,想必是一件很cool的事。是否,也有了分享自己的Library到JCenter的冲动了?
Gradle配置和Pluto框架gitHub下载地址https://github.com/minggo620/Pluto-Android
【原创出品 未经授权 禁止转载】
【欢迎微友分享转发 禁止公号等未经授权的转载】