在项目的发展过程中,可能需要不断地引入新的第三方包,通常都是aar的形式。当项目不断地扩展,aar越来越多,会发现维护aar也是一件麻烦的事。
通常引用第三方aar会有两种形式,一种是远程访问,一种是本地访问。
Demo工程地址,通过代码可以更容易理解。
一是通过远程访问maven库地址的形式。需要做两件事:
第一步在工程的build.gradle中加入库地址
buildscript {
repositories {
maven {
//谷歌粑粑官方的地址是'https://maven.google.com/',一般无法访问。这里用阿里家的梯子。
url 'https://maven.aliyun.com/repository/google'
name 'google'
}
}
allprojects {
repositories {
maven {
url 'https://maven.aliyun.com/repository/google'
name 'Google'
}
}
}
第二步在项目的gradle中进行配置
compile + 空格 + 插件名。
举例:compile 'com.android.support:support-v4:26.0.0'
Notice:
此处有个小规范,如果是地址形式直接引用,使用'',也就是英文半角单引号;如果是中间插入版本等变量信息,使用"",英文半角双引号。
二是引用本地aar包。也是需要做两件事:
第一步在项目gradle内加入引用路径
repositories {
flatDir {
//默认aar本地存放路径在libs下
dirs'libs'
}
}
第二步在项目gradle中进行配置
compile(name: 'aar的包名', ext: 'aar')
比如把webp的aar保存在本地,可以通过
compile(name : 'webp-1.0.0', ext: 'aar')的形式配置。
随着项目的发展,可能引用的google包越来越多,比如appcompat,desigin,percent等等远程包。也可能是本地集成第三方项目的aar。如果在同一个gradle中维护,一会儿加个本地的,一会儿加个远程的,还要进行版本控制,就会看着眼晕。那么在此介绍两种“集中式”引用aar的方法。
一是远程aar的集中管理
本地引用的第一步还是不变的。
第二步在工程目录下,新加一个aar包引用目录。
创建一个目录文件,假设取名aarOnline.gradle。文件内容如下
ext {
dependVersion = [
//引用的SDK信息,需要更新时,直接修改此处就可以
androidSupportSdkVersion:'25.2.0'
]
supportLibrary = [
support:"com.android.support:support-v4:$dependVersion.androidSupportSdkVersion",
//recycleview
recycleview:"com.android.support:recyclerview-v7:$dependVersion.androidSupportSdkVersion",
//appcompat
appcompat:"com.android.support:appcompat-v7:$dependVersion.androidSupportSdkVersion",
]
//转换成引用对象
supportLibs = supportDeps.values()
}
这样,如果需要更新引用的support信息,只需要修改androidSupportSdkVersion对应的版本信息即可
第三步在工程的build.gradle中加入引用
在工程的build.gradle(也就是配置引用库地址的文件)的头部加入引用文件。
applyfrom: '引用文件名'
举例:applyfrom: 'aarOnline.gradle'
第四步修改项目build.gradle中的dependencies
将之前的complie '项目名'的引用删除,修改为:
compile rootProject.ext.引用包组
举例:compile rootProject.ext.supportLibs 即可。
至此,远程引用的集中式处理介绍完毕。这样做有三个好处,一是代码整洁,二是版本控制方便,三是增删改查方便。
二是本地aar的集中管理
本地引用的第一步还是不变的。
第二步在工程目录下,创建一个编译脚本
脚本的作用是批量处理aar文件。举例创建一个aarNative.gradle文件。文件内容如下:
def aarFolderName ='libs'
repositories {
flatDir {
dirs aarFolderName// aar目录
}
}
dependencies {
def aarNativeBat= {
//查找目录下所有.aar结尾的文件
fileTree(dir: aarFolderName,include:'*.aar').each { File file ->
//获取文件名
def name = file.name.lastIndexOf('.').with {
it != -1 ? file.name[0..<it] : file.name }
compile(name: name,ext:'aar')
}
}
//执行脚本
aarNativeBat()
}
第三步在项目的build.gradle中加入引用
只需要在文件头部加入引用文件即可。
applyfrom: '../引用文件名'
举例:applyfrom: '../aarNative.gradle'
Notice:需要注意引用路径。如果脚本在项目目录下,使用“applyfrom: '引用文件名'”即可。具体情况具体处理。
至此,本地集中引用aar介绍完毕。这样做的一大好处就是,直接拷贝aar文件即可,不比再担心版本不一致,版本写错的问题,因为不需要维护每个aar了。
Demo工程地址,通过代码更容易理解。
网友评论