Android Studio发布项目到Maven仓库

原创 2016年06月01日 20:34:11

为了方便别人使用我们开发的Android Library,一般我们都会把Android Library打成aar包,并将aar包发布到Maven仓库当中。如果是开源项目就可以把包发布到Maven Central仓库或者JCenter仓库中;如果是公司内部使用,一般公司内部会自己搭建私有Maven仓库,就把包发布到私有Maven仓库当中,以方便别人直接使用。

本文将介绍如何使用Android Studio将项目发布到Maven私有仓库(使用Nexus搭建)以及JCenter中央仓库。


准备工作

首先得有一个Android项目。我以自己GitHub上的一个项目customprogressbar作说明。
项目结构图:


这里写图片描述

这个项目有两个module:customprogressbar和example。

  • customprogressbar
    这个module是Android Library类型的,提供自定义进度条的功能

  • example
    这个module使用了customprogressbar提供的功能

此时,由于两个module在同一project下面,example要使用customprogressbar,只需要在example的build.gradle添加如下依赖即可。

example/build.gradle

compile project(':customprogressbar')

下面,我们看如何把customprogressbar发布到Maven仓库当中。首先是使用Nexus搭建的Maven私有仓库。


发布到私有Maven仓库

我们使用Nexus在本地搭建了一个Maven仓库。Nexus使用方法不介绍了,大家自己Google。

启动Nexus,在浏览器输入:http://localhost:8081/nexus/ 即可看到Maven仓库管理界面。


这里写图片描述

下面贴上customprogressbar的build.gradle的脚本代码

customprogressbar/build.gradle

apply plugin: 'com.android.library'

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.2"

    defaultConfig {
        minSdkVersion 15
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.3.0'
}

apply from: './nexus-push.gradle'

好,可以看到,基本上都是Android Studio自动生成的代码,只有最后一句不是。最后一句引用了另一个gradle脚本文件,我们的项目发布代码都写在这个脚本文件中。

customprogressbar/nexus-push.gradle

apply plugin: 'maven'

task androidJavadocs(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}

task androidJavadocsJar(type: Jar, dependsOn: androidJavadocs) {
    classifier = 'javadoc'
    from androidJavadocs.destinationDir
}

task androidSourcesJar(type: Jar) {
    classifier = 'sources'
    from android.sourceSets.main.java.srcDirs
}

artifacts {
    archives androidSourcesJar
    archives androidJavadocsJar
}

uploadArchives {
    repositories {
        mavenDeployer {
            repository(url: "http://localhost:8081/nexus/content/repositories/releases/") {
                authentication(userName: "deployment", password: "deployment123")
            }

            pom.groupId = 'com.hebut.czh'
            pom.artifactId = 'customprogressbar'
            pom.version = '0.0.1'

            pom.project {
                licenses {
                    license {
                        name 'The Apache Software License, Version 2.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }
            }
        }
    }
}

首先需要引用maven插件;然后定义了2个任务:androidSourcesJar和androidJavadocsJar,这两个任务分别用于对Java sources打包和Java doc进行打包;接着我们对uploadArchives.repositories闭包进行一些配置,包括仓库的url地址,上传所需的用户名和密码,以及pom属性。

OK, 脚本编写完之后,在Android Studio的Terminal面板执行如下命令

gradlew uploadArchives

如图所示:


这里写图片描述

发布成功后就可以在nexus查看已发布的项目:


这里写图片描述

好的,接下来看Example如何使用这个Maven仓库中的aar包。
首先在项目根目录下的build.gradle文件添加仓库url地址。

build.gradle

allprojects {
    repositories {
        jcenter()

        maven {
            url "http://localhost:8081/nexus/content/repositories/releases/"
        }
    }
}

接下来在example的build.gradle中添加依赖即可使用。

/example/build.gradle

compile 'com.hebut.czh:customprogressbar:0.0.1'

发布到JCenter仓库

JCenter仓库是由bintray提供并维护,这个仓库是类似Maven中央仓库。只要你能连上Internet,你就可以通过Gradle或者Maven去下载仓库中的依赖包到你自己的项目中。

当然,我们也可以通过Android Studio把aar包发布到JCenter当中,这样就可以让更多的开发者使用我们提供的aar包。

把项目发布到JCenter中需要3步:
1. 注册bintray账户
2. 编写Gradle脚本,把项目发布到你bintray账户下的Maven仓库
3. 同步到JCenter仓库

第1步和第3步都很简单,下面先讲第2步。

同样在customprogressbar的build.gradle文件中编写代码,跟前边相比就一处不一样,这里就贴上不一样的代码。

customprogressbar/build.gradle

apply from: './jcenter-push.gradle'

还是一样,上传的主要脚本代码写在另一个文件当中。由于,bintray在Maven仓库外面又加了一个package层,使用package来对仓库进行管理,所以,上传的方式有点不同。

customprogressbar/jcenter-push.gradle

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

def siteUrl = 'https://github.com/codezhanghao/CustomProgressbar'
def gitUrl = 'https://github.com/codezhanghao/CustomProgressbar.git'

group = 'com.hebut.czh'
version = '0.0.1'

install {
    repositories.mavenInstaller {
        pom {
            project {
                packaging 'aar'
                name 'custom progressbar for android'
                url siteUrl

                licenses {
                    license {
                        name 'The Apache Software License, Version 2.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }

                developers {
                    developer {
                        id 'czh'
                        name 'ZHANG.Hao'
                        email '809026704@qq.com'
                    }
                }

                scm {
                    connection gitUrl
                    developerConnection gitUrl
                    url siteUrl
                }
            }

        }
    }
}

task androidJavadocs(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}

task androidJavadocsJar(type: Jar, dependsOn: androidJavadocs) {
    classifier = 'javadoc'
    from androidJavadocs.destinationDir
}

task androidSourcesJar(type: Jar) {
    classifier = 'sources'
    from android.sourceSets.main.java.srcDirs
}

artifacts {
    archives androidSourcesJar
    archives androidJavadocsJar
}

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 {
        version {
            name = '0.0.1'
            desc = 'custom progress bar 0.0.1'
        }
        repo = 'maven'
        name = 'custom-progressbar'
        licenses = ['Apache-2.0']
        vcsUrl = gitUrl
        publish = true
    }
}

这里首先应用了两个插件:com.jfrog.bintray和com.github.dcendents.android-maven。

第一个插件是bintray官网提供的,用来配置bintray的Maven仓库的特有信息,bintray的用户名,apikey,以及提供了一个名为bintrayUpload任务用来上传项目的bintray的Maven仓库,对应代码:

bintray {
    ...
    ...
}

需要注意的使用,bintray的用户名和密码我放在了local.properties文件里面
local.properties:

sdk.dir=D\:\\develop\\Android\\sdk

bintray.user=czh        //bintray的用户名
bintray.apikey=*********    //修改成你自己的apikey,可以在bintray官网上查到

第二个插件是我Google出来的,用来配置项目的POM信息的,对应代码:

install {
    repositories.mavenInstaller {
        ...
        ...
    }
}

接下来在Android Studio的Terminal面板执行命令:

gradle bintrayUpload

如图所示:


这里写图片描述

成功后,可以在bintray网站上的自己的Maven仓库中查看自己的发布的项目:


这里写图片描述

至此,第2步就结束了。

至于第3步,将你的bintray下的Maven仓库中的项目include到JCenter仓库中,就点击一个按钮即可。具体就是,点击进入你刚刚上传项目package的详细页当中,在右下角有一个Add to JCenter按钮,点击它,然后写上一些message,最后点击send按钮,就完事了。下面就是等待bintray工作人员进行审核。几个小时后,审核通过,bintray会给你发展站内消息,通知你项目已经include到JCenter当中。

如图所示:


这里写图片描述

OK,发布项目到JCenter即成功了。

之后,任何人任何时候,只需要添加一句依赖脚本代码就能直接使用你编写的customprogressbar中的功能。

compile 'com.hebut.czh:customprogressbar:0.0.1@aar'

然后Gradle会自动从JCenter仓库中下载对应的依赖包到本地项目中。


OK,本篇文章到这结束了,主要介绍了使用Android Studio发布项目到私有Maven仓库和JCenter中央仓库。希望可以帮助到你。谢谢观看~~~

版权声明:本文为Lorien Zhang原创文章,未经允许不得转载。

Android Studio发布项目到Maven私有库(Nexus)

apply plugin: 'com.android.library'apply plugin: 'maven' uploadArchives { repositories { ...

AndroidStudio 使用gradle 脚本上传aar文件到Nexus Maven 私有服务器

不废话,直接上步骤,服务器版本Ubuntu 15.04 1 Nexus 的搭建 下载地址:http://www.sonatype.org/nexus/go/  2 解压缩下载下来的压缩文件 3 启...

Android studio项目发布到Maven中央库

前言先来闲侃一下,这几天一直在搞这东东,从一点不知道到大体知道,再到知道完整流程,真的看了不是大神的帖子,特别是UK的chrisbanes大神,写了一个标准的gradle脚本,真的很是用,英文不好,所...
  • xxl6097
  • xxl6097
  • 2015年12月16日 11:14
  • 2228

通过Android Studio快速发布Library项目到maven仓库

为便于和大家交流,最近想把自己开发的一个下载库传到maven,网上搜了不少发布教程,也试着去做了,结果过程总是不尽如人意,后来终于找到了一个详尽完整的发布教程(英文版),小编按照此教程很快便把自己的l...

使用Android Studio发布私有库到仓库中心

介绍当在我们这行积累到一定程度,都会有自己的一些代码库,这些代码被多个项目使用。之前的做法是每次到新的项目中,就会把之前的代码拷贝过来,升级一下,或许会把一些纯java代码打包成jar包文件,这样项目...

Gradle之使用Android Studio 编写Gradle插件并上传Library到JCenter

Gradle之使用Android Studio 编写Gradle插件并上传Library到JCenter在上一篇博客中Gradle 入门,编写channel.gradle并通过apply from :...
  • lisdye2
  • lisdye2
  • 2016年08月23日 17:29
  • 2252

Gradle实战:发布aar包到maven仓库

aar简介 aar文件是Google为Android开发所设计的一种library格式,全名为Android Archive Library,与Java Jar Library不同的是,aar除了...

android studio发布和同步maven仓库aar

*同步maven仓库     首先由很多依赖库需要从maven仓库同步,在android studio中需要把工程的根目录的build.gradle里面的 allprojects{     rep...

利用Gradle发布项目到JCenter、Maven

利用Gradle发布Android项目到JCenter Android Studio将远程仓库默认指定为Jcenter仓库,位于Bintray网站。Bintray网站下面还有其他好几个仓库。本文...

将Gradle项目发布到maven仓库

将Gradle项目发布到maven仓库1. Gradle简介1.1.Ant、Maven还是Gradle?1.1.1Ant和Maven介绍 全称为Apache Maven,是一个软件(特别是Java...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:Android Studio发布项目到Maven仓库
举报原因:
原因补充:

(最多只允许输入30个字)