依赖项类型
- 在
build.gradle 中的dependencies中指定依赖项配置。
- 包含三种不同的类型
apply plugin: 'com.android.application'
android { ... }
dependencies {
// Dependency on a local library module
implementation project(":mylibrary")
// Dependency on local binaries
implementation fileTree(dir: 'libs', include: ['*.jar'])
// Dependency on a remote binary
implementation 'com.example.android:app-magic:12.3'
}
本地库模块依赖项
-
implementation project(":mylibrary") (mylibrary 是一个库模块 是一个库中的模块)(这个名称必须与使用include：在settings.gradle文件中定义的库名称相匹配TODO 待验证)
本地二进制依赖项
-
implementation fileTree(dir: 'libs', include: ['*.jar']) 生命对项目的module_name/libs/目录的JAR文件的依赖项。或者可以写成这样implementation files('libs/foo.jar', 'libs/bar.jar')
远程二进制依赖项
-
implementation 'com.example.android:app-magic:12.3' 声明了对"com.example.android"命名看空间内"app-magic"库12.3的依赖性。
依赖项配置
依赖项配置有很多种 列举如下 TODO 查看每个具体的用法 官网看的不是太懂
- implementation
- api
- compileOnly
- runtimeOnly
- annotationProcessor
- compile
- provided
- apk
不同编译环境的依赖项配置
- 单纯的使用上面的依赖项配置，会适用于所有编译环境。
- 添加到单个编译环境中药将配置名称首字母大写，并且使用编译环境（产品风味）名称对其进行前缀。 如下所示：
dependencies {
freeImplementation 'com.google.firebase:firebase-ads:9.8.0'
}
不同的编译环境和生成类型
- 组合产品风味（编译环境）和生成类型（debug还是release）必须在
configurations中初始化配置名称。下面的代码是将runtimeOnly依赖项添加到"freeDebug" 生成变量。代码如下：
configurations {
// Initializes a placeholder for the freeDebugRuntimeOnly dependency
// configuration.
freeDebugRuntimeOnly {}
}
dependencies {
freeDebugRuntimeOnly fileTree(dir: 'libs', include: ['*.jar'])
}
为本地测试和检测测试添加implementation 代码如下：
dependencies {
// Adds a remote binary dependency only for local tests.
testImplementation 'junit:junit:4.12'
// Adds a remote binary dependency only for the instrumented test APK.
androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}
在依赖中添加注释处理器到编译路径中，会出现错误，解决如下：
dependencies {
// Adds libraries defining annotations to only the compile classpath.
compileOnly 'com.google.dagger:dagger:version-number'
// Adds the annotation processor dependency to the annotation processor classpath.
annotationProcessor 'com.google.dagger:dagger-compiler:version-number'
}
排除可传递依赖项
- 项目的中的依赖项可以分为直接依赖项和可传递依赖项。下面的做法就是排除不再需要传递的依赖项，使用
exclude关键字。TODO需要验证具体的作用
dependencies {
implementation('some-library') {
exclude group: 'com.example.imgtools', module: 'native'
}
}
使用变量控制依赖项管理
- 适用于3.0.0 版本以上
- TODO 这个地方官网没有详细说明 grindr代码里面应该有 这个很重要
远程存储库
- 如果依赖项不是本地库或者文件树。Gradle将会在
build.gradle文件中的repositories块中置顶任何联机存储库中的文件。
- 一般远方存储库包括 Maven， JCenter和ivy。 代码如下所示：
allprojects {
repositories {
jcenter()
mavenCentral()
mavenLocal()
}
}
// 指定特定的Maven和常春藤存储库
allprojects {
repositories {
maven {
url "https://repo.example.com/maven2"
}
maven {
url "file://local/repo/"
}
ivy {
url "https://repo.example.com/ivy"
}
}
}
- 远程存储库可以在谷歌官网下载名为“master”的xml列表，里面详细列出列出来了每个组下面的内容
- google Maven存储库中比较旧的版本不可用的库，可以使用SDK管理器进行下载，然后进行依赖添加。
- TODO 远程库的了解不够深入 希望可以加深理解
依赖顺序
- 依赖项在代码中的顺序决定了优先级： 第一个库的优先级高于第二个，第二个高于第三个。在某些场合下特别有用。（合并多个清单文件）
- TODO 这个地方不是太明白。 再看。
查看依赖关系树
- "视图" > "工具窗口" >gradle > "展开AppName" > 任务 > android 和双击androidDepencies。Gradle 执行任务后， 运行窗口打开 显示输出。
解决重复的类错误
- 当向应用添加多个依赖项的时候， 直接和可传递的依赖关系可能会相互冲突，导致编译时或运行时错误。出现"already present"的错误提示。
出现这种情况的原因：
- 应用程序中声明直接依赖于库a和库b，但是库a已经包含了库b。 删除库b的直接依赖项
- 一个本地二进制依赖项 和一个远程二进制依赖 是同一个库。删除其中一个就可以。
- 两个重复依赖项的版本不同，会出现包含两个版本的错误。
- 识别重复依赖项的方法:
- 导航 -> 类
- 在弹出的搜索框中，确保选中"包含非项目项的"
- 键入生成错误的类，
- 检查包含改类的依赖项的结果。
