转载

使用Gradle和Nexus 搭建私有maven仓库

随着业务的增长,需求量增多,我们的App 组件也越来越多,几乎大部分组件都有用到同样的第三方库和公司内部封装的库,而团队中的所有人都重复的从maven 远程的中央仓库下载构建,这样就会加大了仓库的负载和浪费了外网的带宽,网速慢的话,就要等很久很久,半个小时,几个小时,都有可能!这样明显影响项目的开发进度,有的公司还是在内网的情况下开发,连接不到中央仓库怎么办?公司内部开发的公共组件怎么让其他项目共用呢?这个时候,我们不得不为自己的团队搭建一个私服maven仓库,来提高我们的开发效率。

起初,对gradle和maven不是很熟,看了网上的教程一脸懵逼,后来,花了点时间,发现整个过程也还是很简单的。↓↓

首先我们来了解一下,

一、什么是Maven,Gradle?

Maven是一个项目管理和自动构建工具。Maven 包集中存放的地方,就是 Maven 仓库。这些仓库,可以是放在本地,也可以放在某个远程服务器上。 可以是私有仓库,也可以是公开的。下开发用的库列表:

mavenCentral();
jcenter()
maven {
url 'file:///Users/my-user-name/Documents/Android/repo/'
}
maven {
url 'http://localhost:8081/nexus/content/repositories/releases/'
}

Android Studio Gradle 主要支持两个 Maven 中央库:mavenCentral 和 jcenter。

  • mavenCentral 是最早的 maven 中央仓库
  • jcenter 是 Android Studio 0.8 版本起的默认 maven 中央仓库
  • 第三个是我的本机的仓库
  • 第四个是笔者部署在内网服务器的私有仓库

Gradle是一个基于Apache Ant和Apache Maven概念的项目自动化建构工具。它使用一种基于Groovy的特定领域语言来声明项目设置,而不是传统的XML

二、使用Nexus搭建maven私服

1.Nexus 下载安装:

官网下载地址: http://www.sonatype.org/nexus/go/,我的开发环境是Windows,我下载的是Nexus Repository Manager OSS 2.xx下面的 All platforms nexus-2.13.0-01-bundle.zip压缩文件。↓

使用Gradle和Nexus 搭建私有maven仓库

2.Nexus 启动:

下载完成之后,解压后进入/nexus-2.1.2-bundle/nexus-2.1.2/bin/jsw/,根据操作系统类型选择文件夹,我选的是windows-x86-32文件夹,进入后可看到如下所示bat文件。

使用Gradle和Nexus 搭建私有maven仓库

双击console-nexus.bat运行。再浏览器中输入 http://127.0.0.1:8081/nexus/, 出现图(2)所示就代表nexus已经启动成功了。

使用Gradle和Nexus 搭建私有maven仓库 图(2)

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

默认的用户名和密码分别是:admin和admin123。点击右上角的log in 登录后如图所示:

点击左侧的 repositories 查看现有的仓库列表:

使用Gradle和Nexus 搭建私有maven仓库

3.Nexus仓库:

这里的仓库分了四种类型

  1. hosted(宿主仓库):用来部署自己,第三方或者公共仓库的构件
  2. proxy(代理仓库):代理远程仓库
  3. virtual(虚拟仓库):默认提供了一个 Central M1虚拟仓库 用来将maven 2适配为maven 1
  4. group(仓库组):统一管理多个仓库

Public Repositories: 仓库组

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

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

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

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

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

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

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

4.建立Nexus宿主仓库

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

使用Gradle和Nexus 搭建私有maven仓库

建立好新的仓库之后需要配置一下相关账号信息.在安全选项下选择用户选项,可以看到三个默认的账号,分别是管理员账号,部署账号和Nexus账号.正常访问仓库内容的时候是不需要这三个账户的,一般也就是把部署账号暴露出去,方便仓库项目维护人员部署项目使用.所以这里可以用默认的Deployment账户(记得重置下密码).也可以新建一个账号来使用,新建的时候可以通过add role management来控制该账号的权限。

点击新建的仓库的url可以直接如今仓库的路劲,因为现在还没有部署项目,所以是空的仓库。

至此,搭建私服的maven仓库就已经完成,下面继续介绍Android 端在AS 上面的应用。

三、上传库到Maven仓库

上传库到maven仓库有两种方式,我们先来介绍第一种:

  1. 首先我们创建一个新的AndroidStudio 项目,然后新建一个module,选择Android Library。

使用Gradle和Nexus 搭建私有maven仓库

然后,我们随便写一个功能供别人使用。例如我写一个ToastUtils:

使用Gradle和Nexus 搭建私有maven仓库

然后RebuildProject生成依赖的arr包。

2.在MavenRepoDemo项目的根目录的build.gradle中配置刚刚建立的仓库:

allprojects {
repositories {
jcenter()
maven{ url 'http://localhost:8081/nexus/content/repositories/releases/'}

}
}

task clean(type: Delete) {
delete rootProject.buildDir
}
  1. 在同目录下配置gradle.properties文件,定义通用属性,方便如果有多个库需要部署时,不需要修改每一个库中的配置:
#Maven仓库的URL
MAVEN_REPO_RELEASE_URL=http://localhost:8081/nexus/content/repositories/releases/
MAVEN_REPO_SNAPSHOT_URL=http://localhost:8081/nexus/content/repositories/snapshots/

#对应maven的GroupId的值
GROUP = common
#登录nexus ossde的用户名

NEXUS_USERNAME=admin
#登录nexus oss的密码

NEXUS_PASSWORD=admin123

# groupid
GROUP_ID = common

# type
TYPE = aar

# description
DESCRIPTION = This is Toast lib

这里的仓库我用的是Nexus 原有的仓库(你可以换成刚刚新建的仓库地址)。

  1. 修改module对应的build.gradle文件,添加以下配置:
apply plugin: 'com.android.library'

apply plugin: 'maven'

android {
compileSdkVersion 23
buildToolsVersion "23.0.3"

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

sourceSets {
main {
jniLibs.srcDirs = ['libs']
}
}

lintOptions {
abortOnError false
}

}

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

uploadArchives {
configuration = configurations.archives
repositories {
mavenDeployer {
snapshotRepository(url: MAVEN_REPO_SNAPSHOT_URL) {
authentication(userName: NEXUS_USERNAME, password: NEXUS_PASSWORD)
}
repository(url: MAVEN_REPO_RELEASE_URL) {
authentication(userName: NEXUS_USERNAME, password: NEXUS_PASSWORD)
}
pom.project {
version '1.0.0'
artifactId 'toastutils-lib'
groupId GROUP_ID
packaging TYPE
description DESCRIPTION
}
}
}
}

artifacts {
archives file('toastutils.aar')
}
  1. 在as右边栏,找到Gradle打开如下:

    使用Gradle和Nexus 搭建私有maven仓库

然后双击uploadArchives,编译脚本并上传arr文件到私有仓库,最后在控制台可以看到日志是否上传成功。

可以去仓库查看到刚刚上传的库文件:

使用Gradle和Nexus 搭建私有maven仓库

第二种,就是直接通过Nexus直接上传,这种就不详细说了,有兴趣的自己去研究下吧! 嘿嘿

四、在项目中应用

  1. 在项目的根目录build.gradle配置如下:

使用Gradle和Nexus 搭建私有maven仓库

  1. 在app目录下的build.gradle配置如下:

使用Gradle和Nexus 搭建私有maven仓库

这样我们就完工了。在项目中调用我们库了,别人按照上面的配置就可以引用库使用了。

附上Demo的GitHub项目源码: MavenRepoDemo

对于频繁更新的子项目是否适合采用这种方式。因为每次变动都需要上传,而主项目在引用该AAR的时候则需要每次都去检查是否更新, 这会使得编译时间大大增加,有了这个maven库,就不用那么麻烦了。

原文  http://xuhao.tech/2016/08/30/maven.html
正文到此结束
Loading...