随着业务的增长,需求量增多,我们的App 组件也越来越多,几乎大部分组件都有用到同样的第三方库和公司内部封装的库,而团队中的所有人都重复的从maven 远程的中央仓库下载构建,这样就会加大了仓库的负载和浪费了外网的带宽,网速慢的话,就要等很久很久,半个小时,几个小时,都有可能!这样明显影响项目的开发进度,有的公司还是在内网的情况下开发,连接不到中央仓库怎么办?公司内部开发的公共组件怎么让其他项目共用呢?这个时候,我们不得不为自己的团队搭建一个私服maven仓库,来提高我们的开发效率。
起初,对gradle和maven不是很熟,看了网上的教程一脸懵逼,后来,花了点时间,发现整个过程也还是很简单的。↓↓
首先我们来了解一下,
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。
Gradle是一个基于Apache Ant和Apache Maven概念的项目自动化建构工具。它使用一种基于Groovy的特定领域语言来声明项目设置,而不是传统的XML
官网下载地址: http://www.sonatype.org/nexus/go/,我的开发环境是Windows,我下载的是Nexus Repository Manager OSS 2.xx下面的 All platforms nexus-2.13.0-01-bundle.zip压缩文件。↓
下载完成之后,解压后进入/nexus-2.1.2-bundle/nexus-2.1.2/bin/jsw/,根据操作系统类型选择文件夹,我选的是windows-x86-32文件夹,进入后可看到如下所示bat文件。
双击console-nexus.bat运行。再浏览器中输入 http://127.0.0.1:8081/nexus/, 出现图(2)所示就代表nexus已经启动成功了。
图(2)
8081是默认的端口号,要修改端口号,进入/conf/打开nexus.properties文件,修改application-port属性值就可以了。
默认的用户名和密码分别是:admin和admin123。点击右上角的log in 登录后如图所示:
点击左侧的 repositories 查看现有的仓库列表:
Public Repositories: 仓库组
3rd party:无法从公共仓库获得的第三方发布版本的构件仓库
Apache Snapshots:用了代理ApacheMaven仓库快照版本的构件仓库
Central:用来代理maven中央仓库中发布版本构件的仓库
Central M1 shadow:用于提供中央仓库中M1格式的发布版本的构件镜像仓库
Codehaus Snapshots:用来代理CodehausMaven 仓库的快照版本构件的仓库
Releases:用来部署管理内部的发布版本构件的宿主类型仓库
Snapshots:用来部署管理内部的快照版本构件的宿主类型仓库
新建一个内部仓库,步骤为Repositories –> Add –> Hosted Repository,在页面的下半部分输入框中填入Repository ID和Repository Name即可,另外把Deployment Policy设置为 Allow Redeploy ,点击save就创建完成了。这里我点击添加宿主类型的仓库,在仓库列表的下方会出现新增仓库的配置,如下所示:
建立好新的仓库之后需要配置一下相关账号信息.在安全选项下选择用户选项,可以看到三个默认的账号,分别是管理员账号,部署账号和Nexus账号.正常访问仓库内容的时候是不需要这三个账户的,一般也就是把部署账号暴露出去,方便仓库项目维护人员部署项目使用.所以这里可以用默认的Deployment账户(记得重置下密码).也可以新建一个账号来使用,新建的时候可以通过add role management来控制该账号的权限。
点击新建的仓库的url可以直接如今仓库的路劲,因为现在还没有部署项目,所以是空的仓库。
至此,搭建私服的maven仓库就已经完成,下面继续介绍Android 端在AS 上面的应用。
上传库到maven仓库有两种方式,我们先来介绍第一种:
然后,我们随便写一个功能供别人使用。例如我写一个ToastUtils:
然后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
}
#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 原有的仓库(你可以换成刚刚新建的仓库地址)。
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')
}
在as右边栏,找到Gradle打开如下:
然后双击uploadArchives,编译脚本并上传arr文件到私有仓库,最后在控制台可以看到日志是否上传成功。
可以去仓库查看到刚刚上传的库文件:
第二种,就是直接通过Nexus直接上传,这种就不详细说了,有兴趣的自己去研究下吧! 嘿嘿
这样我们就完工了。在项目中调用我们库了,别人按照上面的配置就可以引用库使用了。
附上Demo的GitHub项目源码: MavenRepoDemo
对于频繁更新的子项目是否适合采用这种方式。因为每次变动都需要上传,而主项目在引用该AAR的时候则需要每次都去检查是否更新, 这会使得编译时间大大增加,有了这个maven库,就不用那么麻烦了。