美文网首页
gradle学习之依赖项配置

gradle学习之依赖项配置

作者: 我就是杨过 | 来源:发表于2018-08-26 17:17 被阅读0次

    依赖项类型

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

    相关文章

      网友评论

          本文标题:gradle学习之依赖项配置

          本文链接:https://www.haomeiwen.com/subject/omjoiftx.html