Android Library上传到JCenter仓库实践

前言

这段时间研究了下以前做app开发的时候并没有太过关注的JCenter仓库,在实际开发当中通常都是使用第三方开发者上传到jcenter的library,而我们使用的这些library或者plugin是怎么发布到JCenter并让我使用的? 如果我们想开发一个Library或者plugin,我们该怎么做?带着这些问题,我围绕它做了以下实践:

  • Android Library上传到JCenter仓库实践
  • Gradle插件开发实践-上传apk文件到Bugly

我会分别以两篇博客来分享一下我的实践过程,本篇是入门篇,主要是要告诉大家如何创建一个Android Library并上传到JCenter,很简单,相信你看了这篇文章之后以后想发布一个开源库给广大开发者用不再是问题。

概念普及

JCenter是什么?
jcenter是一个由 bintray.com维护的Maven仓库。一般我们会这样定义使用的仓库:

repositories {
        jcenter()
    }

Maven仓库又是什么?
你可以理解为存放我们Library的文件服务器。

我们在使用一些开源库的时候,可能会看到在项目根目录下的build.gradle有如下配置:

allprojects {
    repositories {
        mavenCentral()
    }
}

mavenCentral又是什么?
我好乱啊,我不想说话。但你还是带着疑问去Google了,能搜索到的问题我们不问好吗?
好吧,直接说答案。mavenCentral跟jcenter一样,都是maven仓库,只是存放的地方不一样,不用猜了,它们半毛钱关系都没有,有一段时间Android的默认仓库是mavenCentral,但后来由于它对开发者不太友好,就把默认仓库换成了jcenter。

更加详细的说明,可以参考以下文章:
http://www.jcodecraeer.com/a/anzhuokaifa/androidkaifa/2015/0623/3097.html

注册bintray账号

你要想在bintray上发布自己的Library就必须有一个创建一个账号,这里建议直接使用github账号授权登录,这样以后你开源的仓库可以在github找到相应的源码,如果你不想公开的话就另外创建一个账号了。

注册bintray账号

登录成功之后,你就可以在bintray看到一些著名的仓库,比如我们开发者经常使用的homebrew。


bintray首页

创建package

创建package

这里示例创建一个myutils的包,如下图所示:


创建package1
创建package2

ok,这个时候你创建好了package,后面就可以准备我们开发好的Library,然后上传到maven仓库,继续耐心看下面的步骤。

创建一个Android Library

新建一个android project,然后new 一个module,选择android library,项目结构如下:

项目结构 | center

这里我只是为了演示,创建了一个简单的类:

创建MyUtils类

应用bintray插件

如果想通过bintrayUpload命令上传library就必须引用相应的插件,配置如下:

 dependencies {
        classpath 'com.android.tools.build:gradle:2.0.0'
        classpath 'com.github.dcendents:android-maven-gradle-plugin:latest.release'
        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.6'
    }

然后在我们的Library工程的build.gradle引用插件,如下所示:

apply plugin: 'com.android.library'
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'

其中com.android.library是android的插件,表示它是一个android library。

应用成功后,你会看到插件生成的task,如下图所示:

bintrayUpload task

通过这个task,我们可以将我们的library上传到maven仓库当中,现在还不行,我们还得继续完成我们的配置。

build.gradle配置

我们需要在library工程的build.gradle配置我们的相应的信息,下面是示例代码:

apply plugin: 'com.android.library'
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
// 这个version是区分library版本的,因此当我们需要更新library时记得修改这个version
version = "1.0.0"

android {
    compileSdkVersion 19
    buildToolsVersion "23.0.3"
    resourcePrefix "devilwwj_"
    defaultConfig {
        minSdkVersion 9
        targetSdkVersion 21
        versionCode 1
        versionName version
    }
    lintOptions {
        abortOnError false
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}
dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
}

def siteUrl = 'https://github.com/devilWwj/Android-Tech'      // 项目的主页
def gitUrl = 'https://github.com/devilWwj/Android-Tech.git'   // Git仓库的url
group = "com.devilwwj.library" // Maven Group ID for the artifact,一般填你唯一的包名
install {
    repositories.mavenInstaller {
        // This generates POM.xml with proper parameters
        pom {
            project {
                packaging 'aar'
                // Add your description here
                description 'my utils for test'
                name 'Android Commonly used utils'  //项目描述
                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 'YOUR_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) {
    options.encoding = 'UTF-8'
    source = 'src/main/java'
}

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"  //发布到Bintray的那个仓库里,默认账户有四个库,我们这里上传到maven库
        name = "myutils"  //发布到Bintray上的项目名字
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true
    }
}

你还需要在local.properties中定义两行代码:

bintray.user=YOUR_BINTRAY_USERNAME
bintray.apikey=YOUR_BINTRAY_API_KEY

分别是你在bintray的用户名和apikey,具体可以在你的profile找到。

配置完成后,我们就可以执行bintrayUpload命令上传我们的库到bintray,可以直接执行task或者在命令行敲入以下命令:

gradlew bintrayUpload

如果上传成功,就会在bintray的网页看到你的library,例如我通过命令上传的myutils库:


这里写图片描述

这个时候你已经实现通过gradle脚本上传library到maven仓库,你可以在本地验证以下,需要进行在根目录的build.gradle配置:

allprojects {
    repositories {
        jcenter()
        maven {
            url 'https://dl.bintray.com/devilwwj/maven/'
        }

    }
}

这样我们就可以访问上传到maven的library,在项目配置:

配置library

编译成功之后,可以在External Libraries看到我们从maven仓库下载下来的library:

myutils库

但如果你想让其他开发者直接使用,需要上传到Jcenter,而不需要配置maven的地址。

上传到jcenter

add to jcenter
send to jcenter

完成这些操作之后,你只需等待bintray团队审核通过,之后其他开发者只需配置一行代码就可以使用了。

总结

关于使用gradle上传library到jcenter的实践基本就这样,在实践之前也参考了很多文章,但过程都基本类似,大家可以对比一下,自己按照这些步骤实践一下,看是否会遇到一些坑,踩坑并填坑的过程就是你经验的积累,我为什么要去了解这些内容,笔者以前在开发app并没有太关注这些,但从应用开发者转变成SDK开发者之后,从使用轮子到创造轮子的转变,需要我关注这些,从知道是什么到为什么再到怎么做,这对我们深入学习知识非常重要。

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

推荐阅读更多精彩内容