一文彻底搞清 Gradle 依赖,零基础学android

2. 本地二进制依赖

implementation fileTree(dir: ‘libs’, include: [’*.jar’])

这种依赖方式是依赖工程中的 module_name/libs/目录下的Jar文件(注意Gradle的路径是相对于build.gradle文件来读取的,所以上面是这样的相对路径)。

如果只想依赖单个特定本地二进制库,可以如下配置:

implementation files(‘libs/foo.jar’, ‘libs/bar.jar’)

3. 远程二进制依赖

implementation ‘com.example.android:app-magic:12.3’

上面是简写的方式,这种依赖完整的写法如下:

implementation group: ‘com.example.android’, name: ‘app-magic’, version: ‘12.3’

groupnameversion 共同定位一个远程依赖库。需要注意的点是,version 最好不要写成"12.3+"这种方式,除非有明确的预期,因为非预期的版本更新会带来构建问题。远程依赖需要在repositories标签下声明远程仓库,例如jcenter()google()maven仓库等。

依赖配置

目前Gradle版本支持的依赖配置有:implementationapicompileOnlyruntimeOnlyannotationProcessor,已经废弃的配置有:compileprovidedapkprovidedCompile。此外依赖配置还可以加一些配置项,例如AndroidTestImplementationdebugApi等等。

常用的是implementationapicompileOnly三个依赖配置,含义如下:

implementation

与compile对应,会添加依赖到编译路径,并且会将依赖打包到输出(aar或apk),但是在编译时不会将依赖的实现暴露给其他module,也就是只有在运行时其他module才能访问这个依赖中的实现。使用这个配置,可以显著提升构建时间,因为它可以减少重新编译的module的数量。建议,尽量使用这个依赖配置。

api

与compile对应,功能完全一样,会添加依赖到编译路径,并且会将依赖打包到输出(aar或apk),与implementation不同,这个依赖可以传递,其他module无论在编译时和运行时都可以访问这个依赖的实现,也就是会泄漏一些不应该不使用的实现。举个例子,A依赖B,B依赖C,如果都是使用api配置的话,A可以直接使用C中的类(编译时和运行时),而如果是使用implementation配置的话,在编译时,A是无法访问C中的类的。

compileOnly

与provided对应,Gradle把依赖加到编译路径,编译时使用,不会打包到输出(aar或apk)。这可以减少输出的体积,在只在编译时需要,在运行时可选的情况,很有用。

runtimeOnly

与apk对应,gradle添加依赖只打包到APK,运行时使用,但不会添加到编译路径。这个没有使用过。

annotationProcessor

与compile对应,用于注解处理器的依赖配置,这个没用过。

查看依赖树

《Android学习笔记总结+最新移动架构视频+大厂安卓面试真题+项目实战源码讲义》

【docs.qq.com/doc/DSkNLaERkbnFoS0ZF】 完整内容开源分享

可以查看单个module或者这个project的依赖,通过运行依赖的Gradle任务,如下:

1、View -> Tools Windows -> Gradle或者点击右侧的Gradle栏);

2、展开 AppName -> Tasks -> android,然后双击运行AndroidDependencies。运行完,就会在Run窗口打出依赖树了。

依赖冲突解决

随着很多依赖加入到项目中,难免会出现依赖冲突,出现依赖冲突如何解决?

定位冲突

依赖冲突可能会报类似下面的错误:

Program type already present com.example.MyClass

通过查找类的方式(command + O)定位到冲突的依赖,进行排除。

如何排除依赖

1、dependencies中排除(细粒度)

compile(‘com.taobao.android:accs-huawei:1.1.2@aar’) {
transitive = true
exclude group: ‘com.taobao.android’, module: ‘accs_sdk_taobao’
}

2、全局配置排除

configurations {
compile.exclude module: ‘cglib’
//全局排除原有的tnet jar包与so包分离的配置,统一使用aar包中的内容
all*.exclude group: ‘com.taobao.android’, module: ‘tnet-jni’
all*.exclude group: ‘com.taobao.android’, module: ‘tnet-so’
}

3、禁用依赖传递

compile(‘com.zhyea:ar4j:1.0’) {
transitive = false
}

configurations.all {
transitive = false
}

还可以在单个依赖项中使用@jar标识符忽略传递依赖:

compile ‘com.zhyea:ar4j:1.0@jar’

4、强制使用某个版本

如果某个依赖项是必需的,而又存在依赖冲突时,此时没必要逐个进行排除,可以使用force属性标识需要进行依赖统一。当然这也是可以全局配置的:

compile(‘com.zhyea:ar4j:1.0’) {
force = true
}

configurations.all {
resolutionStrategy {
force ‘org.hamcrest:hamcrest-core:1.3’
}
}

5、在打包时排除依赖

先看一个示例:

task zip(type: Zip) {
into(‘lib’) {

上一篇:【Android】使用后端云Bmob实现登录、注册


下一篇:【工作随笔记】SiliconLabs Android aar 库使用