• 警察蜀黍变“戏精” 演绎最“正经”春节安全防范短片 2019-04-21
  • 湖南第六批短期援藏队联合中南大学湘雅医院在山南市开展“爱眼护眼”活动 2019-04-21
  • 2017年秋季学期学员第十六支部风采 2019-04-18
  • 中国核电发展处机遇期 未来20年发电量占比或翻两番 2019-04-14
  • 女性之声——全国妇联 2019-04-13
  • 我不是怕死,而是怕那种沉闷又无聊的生活 2019-04-12
  • 王国平应邀为杭州市农村历史建筑保护研讨会作专题讲座 2019-04-12
  • 零下12℃ 北京密云消防员练冰上救援功夫 2019-03-29
  • 女子5万卖掉1岁多女儿 当天就花6000元买化妆品等 2019-03-29
  • Conférence de presse du Premier ministre chinois 2019-03-23
  • 我发现从五+年代农业用化肥农药,在六+年代几百年长的柿树几乎死光。没人研究! 2019-03-23
  • 西部消化疾病内镜诊疗新力量杨琦 2019-03-21
  • 中纪委:有干部不信马列信鬼神 触犯纪律信小圈子 2019-03-21
  • 进度紧追中国航母!英第二艘女王级完工 2019-03-19
  • 凤凰公映礼之《父子雄兵》 2019-03-19
  • 双色球开奖号码走势图:一文搞清Gradle依赖

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

    依赖类型

    dependencies DSL 标签是标准 Gradle API 中的一部分,而不是 Android Gradle 插件的特性,所以它不属于 Android 标签。
    依赖有三种方式,如下面的例子:

    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'
    }

    本地 library ??橐览?/strong>

    implementation project(":mylibrary")

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

    本地二进制依赖

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

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

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

    implementation files('libs/foo.jar', 'libs/bar.jar')

    远程二进制依赖

    implementation 'com.example.android:app-magic:12.3'

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

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

    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 对应,用于注解处理器的依赖配置,这个没用过。

    查看依赖树

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

    1. View -> Tools Windows -> Gradle(或者点击右侧的 Gradle 栏);
    2. 展开 AppName -> Tasks -> Android,然后双击运行 AndroidDependencies。运行完,就会在 Run 窗口打出依赖树了。

    依赖冲突解决

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

    定位冲突

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

    Program type already present com.example.MyClass
    通过查找类的方式(command + O)定位到冲突的依赖,进行排除。

    如何排除依赖

    dependencies 中排除(细粒度)
    compile('com.taobao.android:accs-huawei:[email protected]') {
            transitive = true
            exclude group: 'com.taobao.android', module: 'accs_sdk_taobao'
    }

    全局配置排除

    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'
    }

    禁用依赖传递

    compile('com.zhyea:ar4j:1.0') {
        transitive = false
    }
    
    configurations.all {
        transitive = false
    }

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

    compile 'com.zhyea:ar4j:[email protected]'
    强制使用某个版本

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

    compile('com.zhyea:ar4j:1.0') {
        force = true
    }
    
    configurations.all {
        resolutionStrategy {
            force 'org.hamcrest:hamcrest-core:1.3'
        }
    }

    在打包时排除依赖

    先看一个示例:

    task zip(type: Zip) {
        into('lib') {
            from(configurations.runtime) {
                exclude '*unwanted*', '*log*'
            }
        }
        into('') {
            from jar
            from 'doc'
        }
    }

    代码表示在打 zip 包的时候会过滤掉名称中包含 “unwanted” 和 “log” 的 jar 包。这里调用的 exclude 方法的参数和前面的例子不太一样,前面的参数多是 map 结构,这里则是一个正则表达式字符串。

    也可以使用在打包时调用 include 方法选择只打包某些需要的依赖项:

    task zip(type: Zip) {
        into('lib') {
            from(configurations.runtime) {
                include '*ar4j*', '*spring*'
            }
        }
        into('') {
            from jar
            from 'doc'
        }
    }

    主要是使用 dependencies 中排除和全局配置排除。



    相关文章

    发表评论

    Comment form

    (*) 表示必填项

    还没有评论。

    广西快3龙虎
    返回顶部
  • 警察蜀黍变“戏精” 演绎最“正经”春节安全防范短片 2019-04-21
  • 湖南第六批短期援藏队联合中南大学湘雅医院在山南市开展“爱眼护眼”活动 2019-04-21
  • 2017年秋季学期学员第十六支部风采 2019-04-18
  • 中国核电发展处机遇期 未来20年发电量占比或翻两番 2019-04-14
  • 女性之声——全国妇联 2019-04-13
  • 我不是怕死,而是怕那种沉闷又无聊的生活 2019-04-12
  • 王国平应邀为杭州市农村历史建筑保护研讨会作专题讲座 2019-04-12
  • 零下12℃ 北京密云消防员练冰上救援功夫 2019-03-29
  • 女子5万卖掉1岁多女儿 当天就花6000元买化妆品等 2019-03-29
  • Conférence de presse du Premier ministre chinois 2019-03-23
  • 我发现从五+年代农业用化肥农药,在六+年代几百年长的柿树几乎死光。没人研究! 2019-03-23
  • 西部消化疾病内镜诊疗新力量杨琦 2019-03-21
  • 中纪委:有干部不信马列信鬼神 触犯纪律信小圈子 2019-03-21
  • 进度紧追中国航母!英第二艘女王级完工 2019-03-19
  • 凤凰公映礼之《父子雄兵》 2019-03-19