Android Gradle 中的使用maven私有仓库

1  如果没有私服，我们所需的所有构件都需要通过maven的中央仓库和第三方的Maven仓库下载到本地，而一个团队中的所有人都重复的从maven仓库下载构件无疑加大了仓库的负载和浪费了外网带宽，如果网速慢的话，还会影响项目的进程。很多情况下项目的开发都是在内网进行的，连接不到maven仓库怎么办呢？开发的公共构件怎么让其它项目使用？这个时候我们不得不为自己的团队搭建属于自己的maven私服，这样既节省了网络带宽也会加速项目搭建的进程，当然前提条件就是你的私服中拥有项目所需的所有构件。


所以我们希望通过搭建一个私有maven仓库，来提高我们的开发效率。


二 使用Nexus搭建 maven 私服


1、Nexus下载


下载地址：http://www.sonatype.org/nexus/go


2、Nexus启动


我下载的是zip包进入解压后的目录执行 ./bin/nexus { console | start | stop | restart | status | dump }，然后在浏览器中输入http://127.0.0.1:8081/nexus/，出现图（2）所示就代表nexus已经启动成功。

8081为默认的端口号，要修改端口号可进入\conf\打开nexus.properties文件，修改application-port属性值就可以了。


默认的用户名和密码：admin/admin123，登录后看到图（3）所示：




3、Nexus仓库


nexus的仓库类型分为以下四种：


group: 仓库组


hosted：宿主


proxy：代理


virtual：虚拟


首次登陆nexus后可以看到以下一个仓库组和多个仓库。





Public Repositories:  仓库组


3rd party: 无法从公共仓库获得的第三方发布版本的构件仓库


Apache Snapshots: 用了代理ApacheMaven仓库快照版本的构件仓库


Central: 用来代理maven中央仓库中发布版本构件的仓库


Central M1 shadow: 用于提供中央仓库中M1格式的发布版本的构件镜像仓库


Codehaus Snapshots: 用来代理CodehausMaven 仓库的快照版本构件的仓库


Releases: 用来部署管理内部的发布版本构件的宿主类型仓库


Snapshots:用来部署管理内部的快照版本构件的宿主类型仓库


4、配置nexus


4.1、开启远程索引


新搭建的neuxs环境只是一个空的仓库，需要手动和远程中心库进行同步，nexus默认是关闭远程索引下载，最重要的一件事情就是开启远程索引下载。登陆nexus系统，默认用户名密码为admin/admin123。点击左边Administration菜单下面的Repositories，找到右边仓库列表中的三个仓库Apache Snapshots，Codehaus Snapshots和Maven Central，然后再没有仓库的configuration下把Download Remote Indexes修改为true。如下图






然后在Apache Snapshots，Codehaus Snapshots和Maven Central这三个仓库上分别右键，选择Repair Index，这样Nexus就会去下载远程的索引文件。




这样设置以后, Nexus会自动从远程中央仓库下载索引文件, 为了检验索引文件自动下载是否生效,可以却换到Browse Index






在左边菜单栏里面有个Artifact Search, 在输入框里面输入你想要搜索的构件名字,比如:maven, 那么查询结果如下：






  4.2 建立宿主仓库
新 建公司的内部仓库，步骤为Repositories –> Add –> Hosted Repository，在页面的下半部分输入框中填入Repository ID和Repository Name即可，比如分别填入zfy 和 zfy repostiory，另外把Deployment Policy设置为Allow Redeploy，点击save就创建完成了。这里我点击添加宿主类型的仓库，在仓库列表的下方会出现新增仓库的配置，如下所示：




点击save按钮后就会在仓库列表中看到刚才新增的仓库。


4.3、创建Nexus仓库组


Nexus 中仓库组的概念是Maven没有的，在Maven看来，不管你是hosted也好，proxy也好，或者group也好，对我都是一样的，我只管根据 groupId，artifactId，version等信息向你要构件。为了方便Maven的配置，Nexus能够将多个仓库，hosted或者 proxy合并成一个group，这样，Maven只需要依赖于一个group，便能使用所有该group包含的仓库的内容。neuxs- 1.9.2.3中默认自带了一个名为“Public Repositories”组，点击该组可以对他保护的仓库进行调整，把刚才建立的公司内部仓库zfy repostiory加入其中，这样就不需要再在maven中明确指定内部仓库 的地址了。同时创建一个Group ID为public-snapshots、Group Name为Public Snapshots Repositories的组，把Apache Snapshots、Codehaus Snapshots、Snapshots和zfy repostiory加入其中。

 到这里neuxs的安装配置就完成了，下面介绍如何在maven中使用自己的私服。


4.4、创建NEXUS代理仓库


点击菜单栏上的Add按钮后选择Proxy Repository，看到如下所示配置界面：




三  Android 依赖包 AAR


1. 什么是aar?


AAR文件是Google为Android开发所设计的一种library格式,全名为Android Archive Library, 与Java Jar Library不同的地方是AAR除了java code之外也包含res,也就是一些图片、文字等 资源文件。会设计形式的类别库是因为Google在Android SDK tool r14之后开始支持Library Project的开发方式,这种Library Project可以说是Android APP的半成品,其目标并不是制作成APK来执行,而是提供现成的View/Activiy等一些资源给其他开发者使用。而 AAR正是这种Library Project编译后的压缩包,压缩后只需传递单一文件即可分享,可以说是相当方便。


 2.Android项目打包成AAR


在项目中我们使用gradel的方式编译打包 ,Android使用gradle编译打包具体方式请读者自行学习，在此不再赘述。将一个Android项目打包成AAR你需要在项目的gradle脚本build.gradle文件中添加 apply plugin: ‘android-library’，然后编译项目。


3.Android项目使用AAR


引用远端的aar

首先配置引⽤用⽂文件的仓库地址(具体⽅方式后⾯面会讲到),然后配置脚本 如下：

compile 'com.actionbarsherlock:actionbarsherlock:4.4.0@aar'

首先配置引⽤用⽂文件的仓库地址(具体⽅方式后⾯面会讲到),然后配置脚本 如下：
compile 'com.actionbarsherlock:actionbarsherlock:4.4.0@aar'
引用本地aar文件

compile fileTree(dir: 'libs', include: '*.aar')
4. aar文件结构和在在使用项目中的位置(有助于我们排查问题看看是否那些文件没有被打包等)


在使用aar文件的android 项目中使用编译后aar文件会被解压在: app/build/intermediates/exploded-aar


其 目录结构 如连接所示。


四.使用maven私有仓库,并上传子项目打包文件到仓库


1.使用自定义maven 仓库()


需要在gradle脚本中添加你自定义仓库

repositories {
    mavenCentral()
    maven { url "your respository URL" }//可在刚才配置的仓库里查看

}

2. 编译并上传aar文件到私有仓库


添加maven发布插件

apply plugin: 'maven-publish'
apply plugin: 'maven'

定义aar属性以及上传目标仓库地址

def MAVEN_LOCAL_PATH ='$(your private maven repository URL)'
def ARTIFACT_ID = 'baselib'
def VERSION_NAME = '1.0.0-SNAPSHOT'
def GROUP_ID = 'co
编写上传脚本

uploadArchives {
    repositories {
        mavenDeployer {
            repository(url:MAVEN_LOCAL_PATH ){
                authentication(userName: “$(user_name)”, password:“$(passport)”)
            }
        pom.project {
        groupId GROUP_ID
        artifactId ARTIFACT_ID
        version VERSION_NAME
        packaging 'aar'
            }
        }
    }
}
 ps: (注意用户名和密码的填写,需要有上传的权限才行)


编译项目并且上传


使用gradle + task_name的方式 如： gradle uploadArchives 成功后可在web上看见生成的文件：


至此，我们就成功的搭建了自己的私有仓库，并且上传了Android AAR文件，别人就可以引用了。

讨论：对于频繁更新的子项目是否适合采用这种方式。因为每次变动都需要上传，而主项目在引用该AAR的时候则需要每次都去检查是否更新，gradle 就不能使用offline mode 这会使得编译时间大大增加。尤其在开发模式下我们会花费大量的时间等待编译。

转自：http://techtalk.alo7.com/?p=220