[Gradle系列]Gradle发布module库到jcenter, 并构建自己的企业Maven私服

Tamic 作者: http://blog.csdn.net/sk719887916

前言

andorid开发者经常会看到xx公司发布了xx项目，xx公司只提供了gradle配置路径我们就能轻松的使用它们的项目到自己的工程中：

譬如：

谷歌自身的库

compile ‘com.android.support:appcompat-v7:22.2.0‘

第三方库

compile ‘com.squareup.okhttp:okhttp:2.7.2‘

很多开发者看过之后羡慕不已， 想自己能不能也写一个自己的库让别人用（或者发布已有的本地modul库），或者当多模块开发时，为了进行版本协作，使用自己的maven库是势在必得的！

Maven

Apache Maven，是一个软件（特别是Java软件）项目管理及自动构建工具，由Apache软件基金会所提供。基于项目对象模型（缩写：POM）概念，Maven利用一个中央信息片断能管理一个项目的构建、报告和文档等步骤。

更多请点击：Maven

Maven package 是由所谓 POM（Project Object Model）所定义的文件包的一种输出特殊格式。

Maven仓库就是，就是放 Maven包的地方， 所以叫仓库。 这些仓库，可以是放在本地，也可以放在远程服务器上。 可以开放仓库，也可以加密公开的，提供别人下载使用！

一句大白话你就懂了：maven是类似android studio的构建工具， maven包是对于构建工具产出的格式，maven包类似是apk，maven仓库是apk应用市场一样！

Maven仓库

JCenter和MavenCentral

jcenter是由 bintray.com提供的Maven仓库存放的平台服务器，用户可以注册发布托管自己的开源maven包

Maven Central 是由sonatype.org 提供的发布的Maven服务平台。虽然Maven Central和jcenter都是标准的maven仓库服务器。

同样的仓库却毫无联系。 在jcenter上存在的开源库，可能 在Maven Central 上并不存在，反之亦然。 就类似豌豆荚和91助手都可以存在apk下载，但不一定都能搜到同一个应用一样， MavenCentral上发布maven包比发布到jcente有点复杂，当然我们可以将jcenter的包同步到MavenCenter

发布maven包

远程jcenter

Maven

一首先我们需要在jcenter注册一个账号 点我注册

如果你有github直接可以用gitbub账户注册! 然后补充下资料信息！

接着登录成功后我们去获取这个账户的签名key,用来区分账户Id信息，先记录好自己的

key，后面会用到这个信息。

创建moudle

  • 1 创建模块

    如果你是从零开始去写一个组件模块，就直接在as为你的app创建一个

    module, 如果已有请直接绕道到第三步。

当创建好你的module是时候就会生成一个自己的library

接着可以在自己module配置gradle

下面步骤请在自己的moulde中gradle中配置加入。

- 3 申明插件类型

     apply plugin: ‘com.github.dcendents.android-maven‘
     apply plugin: ‘com.jfrog.bintray‘
  • 4 配置maven包信息

    //版本号
version = "1.0.0"
//这是项目首页
def siteUrl = ‘https://github.com/NeglectedByBoss/Novate‘
//这是源码地址
def gitUrl = ‘https://github.com/NeglectedByBoss/Novate.git‘
// 包名，可以写公司的前缀
group = "com.tamic.novate"
  • 5 定制输出格式信息 
        install {
   repositories.mavenInstaller {
  // This generates POM.xml with proper parameters
 pom {
     //pom信息
     project {
      packaging ‘aar‘
     // Add your description here
      name ‘novate‘
      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 ‘tamic‘
    name ‘tamic‘
    email ‘[email protected]‘
              }
          }

     scm {
        connection gitUrl
        developerConnection gitUrl
        url siteUrl
         }
       }
   }
 }
}
  • 6 输出资源 
    task sourcesJar(type: Jar) {
from android.sourceSets.main.java.srcDirs
  classifier = ‘sources‘
 }
 task javadoc(type: Javadoc) {
  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 配置账号

    这时候加入自己的账号和key,当然你不想加入到local配置中，也可以单独建个prpertites文件，设置git的忽略规则即可。

  • 8 申明编译类型

    在朱项目的gradle中加入下面申明

      buildscript {
  repositories {
  jcenter()

 }
 dependencies {
classpath ‘com.android.tools.build:gradle:2.3.0‘
//这里是依赖的插件类型路径，用最新的即可
 classpath ‘com.jfrog.bintray.gradle:gradle-bintray-plugin:1.4‘
 classpath ‘com.github.dcendents:android-maven-gradle-plugin:1.3‘
 }
}

提交maven

当我们将项目build时候，as就会生成如下task

双击即可，也可以在命令行输入 gradle brntaryUpload.

如果成功了，可以去预览我们项目，发现会有你发布的包了，我这里有四个项目，如果第一次用只显示一个，直接点击预览自己的Maven包 ，

接着继续打开后发现maven包具体预览界面了，

这时候需要add到仓库中心等管理员审核，如果第一次就会有addjcenter按钮，

提交会打开一个申请页面，你填写评论就Okle ，中文也可以，等到一两小时，搜到系统发来的私信，就代表你的库成功了，这时候就有maven依赖地址生成了，我们可以直接拿来配置就可以了

  • 9 使用mven包

    这个就不用多说了吧，心累！

问题总结

如果发现提示你javadoc不过，就关闭doc检查，

如果发现编码出错，就指定utf-8

在module的gradle中加入

  javadoc {
options{
encoding "UTF-8"
charSet ‘UTF-8‘
author true
version true
links "http://docs.oracle.com/javase/7/docs/api"
}
}

tasks.withType(Javadoc) {
options.addStringOption(‘Xdoclint:none‘, ‘-quiet‘)
options.addStringOption(‘encoding‘, ‘UTF-8‘)
options.addStringOption(‘charSet‘, ‘UTF-8‘)
}

如果希望自己代码混淆请配置好相关规则，这里不再介绍了。

Maven Central

可能很多人还想发布到 Maven Central去，可以接着看，虽然长了点，请仔细耐心看完

  • 注册 sonatye 账户

    到 sonatype issue 页面，注册账号。

  • 创建 issue

    登陆之后，顶部有按钮，Created，下面是关键的条目

    Project: Community Support - Open Source Project Repository Hosting (OSSRH)

    Issue Type: New Project

    Group Id：就是你的包的 groupId

其他信息请加上，提交之后，大概两个工作日， 等系统给你分配了issue之后，就可以进行下面的工作了，这块可以参考 点击介绍

  • 上传包

    配置gradle

    整个结构，

    现在我们将红框内的task覆盖，具体如下

    ext {
  PROJ_GROUPID = ‘com.tamic.android‘
  PROJ_ARTIFACTID = ‘novate‘ //这是项目名字
   PROJ_VERSION_NAME = "1.0.0"//版本号

   POM_PACKAGING = ‘aar‘

  NEXUS_USERNAME = ‘注册的账号‘
  NEXUS_PASSWORD = ‘这是密码‘
  RELEASE_REPOSITORY_URL = ‘这里是sonatye配置好的线上路径‘
   SNAPSHOT_REPOSITORY_URL = ‘这里是在 sonatye配置好的snaphot路径‘

    }

    uploadArchives {

repositories {
mavenDeployer {
    snapshotRepository(url: SNAPSHOT_REPOSITORY_URL) {
        authentication(userName: NEXUS_USERNAME, password: NEXUS_PASSWORD)
    }
    repository(url: RELEASE_REPOSITORY_URL) {
        authentication(userName: NEXUS_USERNAME, password: NEXUS_PASSWORD)
    }

    pom.project {
        version PROJ_VERSION_NAME
        groupId PROJ_GROUPID
        artifactId PROJ_ARTIFACTID
        packaging ‘aar‘

     }

  }

    }

    当然密码可以加载jcenter公用的那个properties文件中，防止上传的代码git上，

    然后运行as命令，或点击下面这个task即可。

    发布maven包

    登陆 oss sonatype，登陆，选择左边栏里的 Staging Repositories, 然后点Close 按钮，sonatype 会做响应的 validation，通过的话，就可以点 Release 发布啦，如果不通过，就检查问题，先 Drop，并重新做 Staging 发布。

    检查包

    在 https://oss.sonatype.org/content/repositories/releases 可以看到你发布的包。

两者同步

如果你觉得这种方式比较麻烦，那么我们可以将JCenter的项目同步MavenCentral到上，

搭建企业maven私服

在项目不端庞大情况下，可能你的项目依赖的module越来越多，这样对版本控制越来越难，大家就像都push到maven库上，但有不想公开自己的maven包，所以MavenCentral提供了自己的企业私服，Sonatype 提供了免费的 sonatype/nexus。

请忽略 作者: http://blog.csdn.net/sk719887916

下载安装 docker 镜像

  $ docker pull sonatype/nexus

开启服务镜像

  $ docker run -d -p 8081:8089 --name nexus sonatype/nexus:oss

访问服务器

因为的 docker-machine ip 是：192.168.99.100，于是可以通过在浏览器访问http://192.168.99.100:8089/ 这个 URL 来访问 sonatype 私服。

条件允许的可以在内网部署一台服务器，用来运行这个maven私服。甚至找运维可以创建自己的Maven域名

默认账户密码是：

  admin
 admin123

配置仓库

点击左侧 repository，会出现 repository 的列表，把其中的 Releases 的 Configutation->Access Setting-> Deploy Polocy 设置成 Allow Redeploy 使得可以重复发布包。

配置上传插件

因为使用了自己的私服 chrisbanes/gradle-mvn-push 插件，稍微改动，所有我们需要修改自己的maven私服repository URL 等，

关键设置

   ext {
PROJ_GROUPID = ‘com.tamic.android‘
PROJ_ARTIFACTID = ‘android_statSdk‘
PROJ_VERSION_NAME = "1.0.0"

POM_PACKAGING = ‘aar‘

NEXUS_USERNAME = ‘admin‘
NEXUS_PASSWORD = ‘admin123‘
RELEASE_REPOSITORY_URL = ‘修改为你配置的路径‘
SNAPSHOT_REPOSITORY_URL = ‘修改为你配置的路径‘
}

检测是否成功

上传成功之后，就可以在浏览器的http://192.168.99.100:8089/content/repositories/releases看到这个包。发现存在，说明已经成功了。

使用

指定自己的mven仓库地址

在root的gradle指定你的maven服务器路径就ok了，其他moudule配置和使用第三方库一样。

发布本地Maven

有时候你不想发布到自己公司的内网私服上，只想测试下本地打包机制，这时候随便找个mven包，反到电脑任意路径下。指定本地路径就ok了，下面三种可以随你选择

allprojects {
    repositories {
     //本机仓库
     mavenLocal()

    //内网maven仓库
    maven {  url "你的内网私服地址"  }
    maven {

        url "你的Maven路径"
    }
}

}

经验总结

  • 上传失败，返回400，可能是Configutation->Access Setting-> Deploy Polocy没设置好；返回401，可能是账号密码错误。
  • 如果出现失败，请检版本号是否一致，如果服务器存在的版本号会上传不了，请先删除就版本再上传，
  • 如果出现NOT found you moudle无法上传情况，请只保留一个android STUDIO,在点击上传task.

华丽结束

上面展示了两种发布maven包到仓库的方式，开发者可以自我去选择，maven不仅很好的解决了模块化开发是带来的版本控制问题，也方便了项目对依赖的旧版本回滚控制， 具体在使用的地方可以自己指定maven版本，这次介绍了怎么在gradle发布maven的姿势，下节在总结下在多模块情况下，开发者想用同一套代码，生成不同apk,设置可以选择不同资源打包的问题。 gradle多渠道和多版本打包相关的知识，期待你的关注！

Tamic : http://blog.csdn.net/sk719887916

时间： 2024-10-15 03:16:10

[Gradle系列]Gradle发布module库到jcenter, 并构建自己的企业Maven私服的相关文章

Microsoft Azure 微软云平台系列新品发布

在移动为先,云为先的今天,微软为拥抱云文化的企业提供了技术和工具.利用创新且全面的移动解决方案和开发者工具,微软有独到之处,它帮助所有客户在云为先时代中发现潜在价值. 正如希望加快云创新步伐的你们所期待的,自 WPC 2015 之后我们已经为大家提供了跨越微软云平台的产品.以下就是一份最新整合的 Microsoft Azure 微软云平台系列新品发布名单. 这次更新包括以下方面: 企业移动 Azure 应用市场 Azure Pack v2 UR7 Visual Studio 企业移动 微软企业移

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

查看原文:http://blog.csdn.net/u010818425/article/details/52441711 Gradle实战系列文章: <Gradle基本知识点与常用配置> <Gradle实战:Android多渠道打包方案汇总> <Gradle实战:不同编译类型的包同设备共存> <Gradle实战:执行sql操作hive数据库> aar简介 aar文件是Google为Android开发所设计的一种library格式,全名为Android Ar

[Android]使用Gradle提交自己开源Android库到Maven中心库

以下内容为原创,欢迎转载,转载请注明 来自天天博客:http://www.cnblogs.com/tiantianbyconan/p/4388175.html 此文针对开源爱好者. 如果你想让别人使用你的Android开源库,第一种方法是,提供你的Github地址,让别人clone一份,然后让别人import到他的项目中.另一种更简单的方式就是直接让别人在他的Gradle中添加你的库依赖,如下: compile 'com.github.wangjiegulu:AndroidBucket:1.0.

Gradle系列之初识Gradle

原文首发于微信公众号:躬行之(jzman-blog) 学习 Android 有一段时间了,开发中经常使用到 Gradle ,但是不知道 Gradle 构建项目的原理,计划花一点时间学习一下 Gradle 相关的知识.Gradle 是一个非常优秀的项目构建工具,其 DSL(领域特定语言)基于 Groovy 实现,大部分功能通过插件的方式来实现,也可以自定义 Gradle 插件,下面开始入门 Gradle 系列的第一篇. 配置 Gradle 环境 首先确保在环境变量中配置好 JAVA_HOME,使用

AndroidStuio快速发布开源项目到Jcenter/Bintray

AndroidStuio快速发布开源项目到Jcenter/Bintray 版权声明:转载请注明本文转自严振杰的博客: http://blog.csdn.net/yanzhenjie1003 QQ交流群1:46505645 QQ交流群2:46523908 群资源有限,请不要重复加群,谢谢. 前言 最近做了两个开源项目,一个是Android网络框架NoHttp,和Volley.OkHttp一样做客户端请求的,更多相关信息请百度哦:另一个是Android Web服务器框架AndServer,用来在An

Android 快速发布开源项目到jcenter

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

简单理解Gradle，Gradle是什么，一分钟入门Gradle

Gradle构建脚本使用DSL(Domain Specific Language)来描述构建逻辑,使用的语言是Groovy.想了解Android Studio工程的Gradle构建系统,可以先从Project的settings.gradle.Project的build.gradle.Module的build.gradle.gradle/wrapper这些文件分析起. 1. Project的settings.gradle 这个文件描述的是Project里包含哪些module. include ':

Android Gradle Plugin指南（五）——Build Variants（构建变种版本）

原文地址:http://tools.android.com/tech-docs/new-build-system/user-guide#TOC-Build-Variants 6. Build Variants(构建变种版本) 新构建系统的一个目标就是允许为同一个应用创建不同的版本. 这里有两个主要的使用情景: 1.同一个应用的不同版本.例如一个免费的版本和一个收费的专业版本. 2.同一个应用需要打包成不同的apk以发布Google Play Store.查看http://developer.an

Win10 UWP开发系列——开源控件库：UWPCommunityToolkit

原文:Win10 UWP开发系列--开源控件库:UWPCommunityToolkit 在开发应用的过程中,不可避免的会使用第三方类库.之前用过一个WinRTXamlToolkit.UWP,现在微软官方发布了一个新的开源控件库—— UWPCommunityToolkit 项目代码托管在Github上:https://github.com/Microsoft/UWPCommunityToolkit 包括以下几个类库: 都可以很方便的从Nuget上安装. NuGet Package Name des