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看到一些著名的仓库,比如我们开发者经常使用的homebrew。

创建package

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

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

创建一个Android Library

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

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

应用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,如下图所示:

通过这个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,在项目配置:

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

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

上传到jcenter

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

总结

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

原文发布于微信公众号 - 小巫技术博客(wwjblog)

原文发表时间:2016-07-16

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

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏Jerry的SAP技术分享

SAP CRM和C4C的内容管理(Content Management)

SAP CRM使用Attachments这个UI给用户提供内容管理的功能。通过新建按钮可以上传本地文档到CRM系统:

58830
来自专栏白驹过隙

Socket编程回顾,一个最简单服务器程序

23430
来自专栏Aloys的开发之路

SVN+Apache域用户认证配置方法_Windows(转,重新排版,部分内容更新优化)

背景说明 作为一个团队开发,公司长期以来的实践证明,手工操作版本管理是非常不明智的,一来浪费人力,二来效率低下,三来容易犯错。那么版本管理用什么工具好呢? 在开...

319100
来自专栏云计算教程系列

如何在FreeBSD 10.1上使用Sendmail通过外部SMTP服务发送电子邮件

设置新的Web服务器时最常见的需求之一是发送电子邮件。最安全,最简单的方法是将服务器连接到SendGrid或Amazon SES等邮件服务。使用外部服务将帮助您...

23800
来自专栏大魏分享(微信公众号:david-share)

Oracle11g RAC双NFS仲裁容错方案

说明: 整理文档时发现自己在2010年写的一个RAC容灾方案,觉得有一些用,分享出来。当时为了验证此方案,做了很多PoC。方案相对比较复杂,但是也提供了一种思路...

55890
来自专栏贾鹏辉的技术专栏@CrazyCodeBoy

React Native发布APP之签名打包APK

React Native发布APP之签名打包APK ---- 用React Native开发好APP之后,如何将APP发布以供用户使用呢?一款APP的发布流程...

29050
来自专栏技术博文

34款Firefox渗透测试插件

工欲善必先利其器,firefox一直是各位渗透师必备的利器,小编这里推荐34款firefox渗透测试辅助插件,其中包含渗透测试、信息收集、代理、加密解密等功能。...

445130
来自专栏皮振伟的专栏

[kvm][virt]MMIO技术分析

前言: 简单回顾一下前文,《内存映射技术分析》描述了虚拟内存的管理、内存映射;《物理内存管理》介绍了物理内存管理。《内存回收》介绍了一下PFRA内存回收。 上述...

76260
来自专栏FreeBuf

三星KNOX远程静默安装漏洞深入分析报告

漏洞来源 11月中旬,三星手机被国外安全研究人员曝光了一个严重的安全漏洞,该漏洞影响Galaxy S5,S4,S4 mini,Note 4,Note3以及Ace...

25790
来自专栏PHP在线

Apache的httpd.conf文件配置详解

Apache的基本设置主要交由httpd.conf来设定管理,我们要修改Apache的相关设定,主要还是通过修改httpd.cong来实现。下面让我们来看看ht...

57980

扫码关注云+社区

领取腾讯云代金券