Android gradle 强制依赖低版本 gradle api依赖

转载

mob6454cc71b244 2024-04-11 08:45:14

文章标签 aar打包依赖 android Gradle ci Android 文章分类 Android 移动开发

Android gradle 强制依赖低版本 gradle api依赖_ci

之前对 Android Gradle 构建的依赖一直傻傻分不清，这段时间正好接入集团的一个二方库，踩了很多坑，也顺带把 Gradle 依赖这块搞清楚了，主要整理了下 Gradle 依赖的类型、依赖配置、如何查看依赖、依赖冲突如何解决。

依赖类型

dependencies DSL 标签是标准 Gradle API 中的一部分，而不是 Android Gradle 插件的特性，所以它不属于 Android 标签。

依赖有三种方式，如下面的例子：

Android gradle 强制依赖低版本 gradle api依赖_Gradle_02

本地 library 模块依赖

Android gradle 强制依赖低版本 gradle api依赖_aar打包依赖 android_03

这种依赖方式是直接依赖本地库工程代码的(需要注意的是，mylibrary 的名字必须匹配在 settings.gradle 中 include 标签下定义的模块名字)。

本地二进制依赖

Android gradle 强制依赖低版本 gradle api依赖_aar打包依赖 android_04

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

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

Android gradle 强制依赖低版本 gradle api依赖_ci_05

远程二进制依赖

Android gradle 强制依赖低版本 gradle api依赖_Android_06

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

Android gradle 强制依赖低版本 gradle api依赖_Gradle_07

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

依赖配置

目前 Gradle 版本支持的依赖配置有：implementation、api、compileOnly、runtimeOnly 和 annotationProcessor。已经废弃的配置有：compile、provided、apk、providedCompile。此外依赖配置还可以加一些配置项，例如 AndroidTestImplementation、debugApi 等等。

常用的是 implementation、api、compileOnly 三个依赖配置，含义如下：

implementation：与compile对应，会添加依赖到编译路径，并且会将依赖打包到输出(aar或apk)，但是在编译时不会将依赖的实现暴露给其他module，也就是只有在运行时其他module才能访问这个依赖中的实现。使用这个配置，可以显著提升构建时间，因为它可以减少重新编译的module的数量。建议，尽量使用这个依赖配置。
api：与 compile 对应，功能完全一样，会添加依赖到编译路径，并且会将依赖打包到输出(aar 或a pk)。与 implementation 不同，这个依赖可以传递，其他 module 无论在编译时和运行时都可以访问这个依赖的实现，也就是会泄漏一些不应该不使用的实现。举个例子，A 依赖 B，B 依赖 C，如果都是使用 api 配置的话，A 可以直接使用 C 中的类(编译时和运行时)。而如果是使用 implementation 配置的话，在编译时，A 无法访问 C 中的类。
compileOnly：与 provided 对应，Gradle 把依赖加到编译路径，编译时使用，不会打包到输出(aar 或 apk)。这可以减少输出的体积，在只在编译时需要，在运行时可选的情况，很有用。
runtimeOnly：与 apk 对应。Gradle添加依赖只打包到 apk，运行时使用，但不会添加到编译路径。这个没有使用过。
annotationProcessor：与 compile 对应，用于注解处理器的依赖配置，这个没用过。