Android - 5分钟发布Android Library项目到JCenter

android-library-publish-to-jcenter是一个帮助Android开发者将AAR库发布到jcenter的项目,android-library-publish-to-jcenter已经将需要写的脚本封装好了,我们只需要配置相关属性即可在5分钟之内发布我们的项目到JCenter(不包括审核时间哦)

1. 注册Bintray账号 (传送门)

Bintray是jcenter的托管商,因此你必须注册一个Bintray账号,注册完账号后记下你的用户名以及API Key。

登陆后在首页右上角点击用户名进入个人主页,然后点击用户名下面的Edit进入个人信息编辑页面,接下来点击页面左边列表的最后一项API Key

如图所示点击最右边箭头指示的复制按钮即可复制你的API Key

2. 检查Android插件版本

首先你要检查你的Android插件的版本,因为1.1.0版本有一个BUG会导致生成javadoc失败,所以你只需升级到最新即可。目前最新版本是1.2.3,在你的项目根目录下的build.gradle文件中修改版本号即可,如下:

// 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:1.2.3‘
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

如果你在看到这篇文章的时候有更新的版本的话,直接改为最新的版本即可。

3. 添加所需插件

在你的项目的根目录的build.gradle文件的dependencies中追加如下代码:

classpath ‘com.github.dcendents:android-maven-plugin:1.2‘
classpath ‘com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0‘

android-maven-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:1.2.3‘
        classpath ‘com.github.dcendents:android-maven-plugin:1.2‘
        classpath ‘com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0‘
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

4. 配置项目信息

下载project.properties文件并放到你的library module目录下

project.properties文件的原始内容如下:

#project
project.name=
project.groupId=
project.artifactId=
project.packaging=aar
project.siteUrl=
project.gitUrl=

#javadoc
javadoc.name=

详解:

  • project.name:项目名称
  • project.groupId:项目组ID,通常情况下如果你的包名为com.example.test,那么项目组ID就是com.example
  • project.artifactId:项目ID,通常情况下如果你的包名为com.example.test,那么项目ID就是test
  • project.packaging:包类型,一般的java是jar,那么Android库就是aar
  • project.siteUrl:项目官方网站的地址,没有的话就用Github上的地址,例如:https://github.com/xiaopansky/Sketch
  • project.gitUrl:项目的Git地址,例如:https://github.com/xiaopansky/Sketch.git
  • javadoc.name:生成的javadoc打开后主页显示的名称,通常跟项目名称一样即可

完成配置后如下所示:

#project
project.name=Sketch
project.groupId=me.xiaopan
project.artifactId=sketch
project.packaging=aar
project.siteUrl=https://github.com/xiaopansky/Sketch
project.gitUrl=https://github.com/xiaopansky/Sketch.git

#javadoc
javadoc.name=Sketch

你无需配置项目版本,会自动从你的build.gradle中获取版本名称作为项目版本

5. 配置Bintray账号以及开发者信息

下载local.properties文件并放到你的library module目录下

local.properties文件的原始内容如下:

#bintray
bintray.user=
bintray.apikey=

#developer
developer.id=
developer.name=
developer.email=

详解:

  • bintray.user:你的Bintray的用户名
  • bintray.apikey:你的的Bintray的API Key
  • developer.id:通常是你在开源社区的昵称
  • developer.name:你的姓名
  • developer.email:你的邮箱

完成配置后如下所示:

#bintray
bintray.user=xiaopansky
bintray.apikey=*****************************

#developer
developer.id=xiaopan
developer.name=********
[email protected]

*号显示的为个人信息不反方便透露,还请见谅

注意要将local.proerties文件加入忽略列表,以免被提交到Github或其他网站泄露个人信息

6. 配置bintrayUpload.gradle

方法1:直接使用远程bintrayUpload.gradle文件

修改你的library module的build.gradle文件,在最后加上apply from: "https://raw.githubusercontent.com/xiaopansky/android-library-publish-to-jcenter/master/bintrayUpload.gradle",如下所示:

apply plugin: ‘com.android.library‘

android {
    compileSdkVersion 22
    buildToolsVersion "22.0.0"

    defaultConfig {
        minSdkVersion 7
        targetSdkVersion 22
        versionCode 100
        versionName "1.0.0"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile(‘proguard-android.txt‘), ‘proguard-rules.pro‘
        }
    }
}

apply from: "https://raw.githubusercontent.com/xiaopansky/android-library-publish-to-jcenter/master/bintrayUpload.gradle"
方法2:下载后使用本地bintrayUpload.gradle文件

首先下载bintrayUpload.gradle文件并放到你的library module目录下,然后修改你的library module的build.gradle文件,在最后加上apply from: "bintrayUpload.gradle",如下所示:

apply plugin: ‘com.android.library‘

android {
    compileSdkVersion 22
    buildToolsVersion "22.0.0"

    defaultConfig {
        minSdkVersion 7
        targetSdkVersion 22
        versionCode 100
        versionName "1.0.0"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile(‘proguard-android.txt‘), ‘proguard-rules.pro‘
        }
    }
}

apply from: "bintrayUpload.gradle"

我当然推荐大家使用第一种方案,简单快捷,至此配置工作已全部结束

7. 执行命令打包并上传到Bintray

打开终端进入项目目录下,执行gradlew bintrayUpload命令即可

另外,如果你的本地已经配置了Gradle了,那么执行gradle bintrayUpload命令也可以。gradlew是Gradle的一层封装,如果你本地没有安装Gradle gradlew就会自动下载Gradle

8. 请求提交你的项目到jcenter

前面所有步骤走完之后实际上只是上传了你的项目到Bintray而已,并没有被包含在jcenter中,要想提交到jcenter中还需要Bintray的审核。

登入Bintray网站,进入个人中心,在右侧的Owned Repositories区域点击Maven的图标,进入你的Maven项目列表。

如果已经上传成功了,在这里就能看到你的项目,进入项目详情,在右下角的Linked To区域点击add in jcenter,然后在comment输入框里随便填写下信息,最后提交请求即可

一般情况下审核需要4到5个小时,耐心等待就行了,审核通过后会给你发邮件通知你,并且以后更新项目就不需要再审核了。

9. 一句话导入你的项目

当审核通过后,别人就可以一句话导入你的项目了,例如:

compile ‘me.xiaopan:sketch:2.0.0‘

10. 额外补充:

保持你的library module的名字同artifactId一样

因为在Bintray上你的项目的maven-metadata.xml文件的路径是gruopId+"/"+module名称

例如你的groupId是com.example,artifactId是test,但module名称是library。

这时候项目文件是在com.example.test目录下的,但maven-metadata.xml文件却是在com.example.library目录下的。

这样一来如果你有多个项目groupId一样,artifactId不一样,但module名称都是library的话,可能就会冲突。

目前为止我还没有找到更好的解决办法,就只能让module名称和artifactId保持一致,如果你们谁有更好的办法,欢迎留言交流。

11. 参考文章

时间: 2024-10-06 16:17:30

Android - 5分钟发布Android Library项目到JCenter的相关文章

Android studio 发布Android Library项目到JCenter

(本来这篇文章只是想当做笔记记录,下了班才写的,第二天起来看到几百个访问量,突然对生活充满了希望,受到了鼓舞,于是决定完善一下.____2016/05/31) 互联网的发展是非常迅猛的,刚刚觉得自己适应了eclipse的用法,突然发现它已经被淘汰了. OK,今天不是来说eclipse和Android studio的褒贬.我们是来学习技术的.在做SDK相关的开发时发现一个问题,Android studio 使用第三方包超级简单方便.一行代码搞定. compile 'com.ruffian.util

Ant自动编译打包&发布 android项目

Eclipse用起来虽然方便,但是编译打包android项目还是比较慢,尤其将应用打包发布到各个渠道时,用Eclipse手动打包各种渠道包就有点不切实际了,这时候我们用到Ant帮我们自动编译打包了. 1  Ant自动编译打包android项目 1.1   Ant安装 ant的安装比较简单,下载ant压缩包  http://ant.apache.org  (最新的为1.9.3版本),下载之后将其解压到某个目录(本人解压到E:\Program Files\apache-ant-1.9.3) ,然后配

Andorid进阶7—— Ant自动编译打包&发布 android项目

http://www.cnblogs.com/tt_mc/p/3891546.html Eclipse用起来虽然方便,但是编译打包android项目还是比较慢,尤其将应用打包发布到各个渠道时,用Eclipse手动打包各种渠道包就有点不切实际了,这时候我们用到Ant帮我们自动编译打包了. 1  Ant自动编译打包android项目 1.1   Ant安装 ant的安装比较简单,下载ant压缩包  http://ant.apache.org  (最新的为1.9.3版本),下载之后将其解压到某个目录(

Android 快速发布开源项目到jcenter

转载请标明出处(请勿转载删除底部微博.微信等信息): http://blog.csdn.net/lmj623565791/article/details/51148825: 本文出自:[张鸿洋的博客] 大家在很多时候都希望让自己的开源项目可以更方便的让用户去使用,那么对于Android平台,一个很好的方式就是上传到jcenter,然后使用时通过添加compile引用即可. 对于上传到jcenter,也不算技术类的文章,而且已经有很多较好的文章可以参考,写之前我也大致百度了一下. 目前很多文章都是

使用Gradle发布Android开源项目到JCenter

这里介绍一下,如何使用Gradle发布到jcenter. 注册 先到https://bintray.com注册一个账号. 配置账号 我们需要配置一下BINTRAY_USER及BINTRAY_KEY两个属性.BINTRAY_USER即你注册的账号名,BINTRAY_KEY可通过以下方法找到. 如图所示,先点击你的账号名称进入个人页面. 然后点击Edit,进入编辑页面. 接着点击API key,再点右边的Show就可以看到API KEY了. 然后到你的.gradle目录下(如果你没有配置过GRADL

【转载】Android Studio jar、so、library项目依赖,原文链接http://zhengxiaopeng.com/2014/12/13/Android-Studio-jar、so、library项目依赖/

前言 Android Studio(以下简称AS)在13年I/O大会后放出预览版到现在放出的正式版1.0(PS.今天又更新到1.0.1了)历时一年多了,虽然Google官方推出的Android开发者的IDE对我们Android DEV是很有吸引力的,但考虑到beta版还是太多问题所以自己主要还是把AS当做尝鲜为主,每放出一个较大更新就下载下来试试,感觉还是挺好的,渐渐用AS的人越来越多,Github上的项目也基本是AS的了,Google的sample也采用AS,所以使用Eclipse跟外界交流越

[转]使用Gradle发布Android开源项目到JCenter

转自:http://blog.csdn.net/maosidiaoxian/article/details/43148643 使用Gradle发布Android开源项目到JCenter 分类: Gradle笔记2015-01-26 09:41 8508人阅读 评论(33) 收藏 举报 gradle发布jcenter发布项目 目录(?)[+] 喜欢做些开源项目的朋友,相信有不少人都希望能把自己的项目发布到公共的中央仓库,如maven中央仓库,以供别人方便地集成使用.而使用了Android Stud

如何使用Android Studio把library分享到jCenter和Maven Central

原文:How to distribute your own Android library through jCenter and Maven Central from Android Studio 如果你想在Android Studio中引入一个library到你的项目,你只需添加如下的一行代码到模块的build.gradle文件中. 1 2 3 dependencies { compile 'com.inthecheesefactory.thecheeselibrary:fb-like:0.

Android Studio把library分发到jCenter和Maven Central

如果你想在Android Studio中引入一个library到你的项目,你只需添加如下的一行代码到模块的build.gradle文件中. 1 2 3 dependencies { compile 'com.inthecheesefactory.thecheeselibrary:fb-like:0.9.3' } 就是如此简单的一行代码,你就可以使用这个library了. 酷呆了.不过你可能很好奇Android Studio是从哪里得到这个library的.这篇文章将详细讲解这是怎么回事,包括如何