我是如何将Pluto作为library分享到jCenter

最近小明正在看一本名叫《历代经济变革得失》从历史角度分析经济变化的书。通过研究经济方式,作为一个工科毕业的小明,当然直接想到是数据统计,建立数学理论模型,这本书入手方式就成为了第一个吸引点。除了耳熟能详的历史事件人物,阶级的斗争之外,留下深刻印象的还是封闭专制和开放改革之间的博弈。彰显出活力生态,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上的描述添加上去了。

创建仓库

在组织页面下就可以看见一下仓库,需要了解可以点击去看看。

仓库Pluto.png

4.获取自己的apikey

依次点击页面“Edit Profile”-->"API Key" -->"Show",最好先复制存下来,等下gradle配置用到。


获取appkey

三.Gradle配置

1.整体要留意的3个地方

第一处,Project的gradle用来配置maven和bintray插件用的;第二处,Library的gradle用来配置版本、仓库等等用的;第三处,local.properties用来配置bintray的账号和apikey用的。那么关键内容将会在Library的gradle中。


准备改动一下3个地方

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 pluginGradle 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

安装情况如下:


Gradle安装情况
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如下图

Paste_Image.png

进入Package进行看到上传后的结果以下两个红色框框关键信息


Pluto上传后

如果是未发布将会出现一下link提示,这时就可以点击提交审核了。


Paste_Image.png

完成这一步剩下的就是邮箱等待了。3个小时后...

Paste_Image.png

六.文章总结

就这样,我的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

【原创出品 未经授权 禁止转载】
【欢迎微友分享转发 禁止公号等未经授权的转载】

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容