依赖项类型

• 在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的直接依赖项
• 一个本地二进制依赖项 和一个远程二进制依赖 是同一个库。删除其中一个就可以。
• 两个重复依赖项的版本不同，会出现包含两个版本的错误。
• 识别重复依赖项的方法:
• 导航 -> 类
• 在弹出的搜索框中，确保选中"包含非项目项的"
• 键入生成错误的类，
• 检查包含改类的依赖项的结果。