6.2、Android Studio 添加编译依赖

文章摘要
1、 三种依赖类型
2、库依赖关系配置
3、远程仓库
4、查看依赖关系树


英文文献

Android Studio中的摇篮构建系统可以很容易地包括外部的二进制文件或其他库模块到您的构建与依赖。该依赖性可以位于您的计算机上或远程仓库中,他们宣布任何传递依赖将自动包括在内。

一、依赖类型

要添加一个依赖于你的项目,指定诸如依赖配置compile在dependencies您的块build.gradle文件。

例如,下面build.gradle为应用模块文件包括三种不同类型的依赖关系:

apply plugin: 'com.android.application'

android { ... }
dependencies {
    // Dependency on a local library module
    compile project(":mylibrary")

    // Dependency on local binaries
    compile fileTree(dir: 'libs', include: ['*.jar'])

    // Dependency on a remote binary
    compile 'com.example.android:app-magic:12.3'
}

每个这些要求不同类型的依赖关系如下:

  • 1、本地库模块依赖
compile project(':mylibrary')

此声明一有依赖性的Android库模块 名为“在MyLibrary”(此名称必须定义为库名称相匹配include你的settings.gradle文件)。它需要构建系统编译库模块与应用模块,并在您的APK所产生的AAR文件。

  • 2、本地二进制依赖
compile fileTree(dir: 'libs', include: ['*.jar'])

由于Gradle读取相对路径的build.gradle 文件,这告诉构建系统添加您的项目内的所有JAR文件 module_name/libs/的目录的依赖。
或者,您可以指定单独的文件如下:

compile files('libs/foo.jar', 'libs/bar.jar')
  • 3、远程二进制依赖
compile 'com.example.android:app-magic:12.3'

这实际上是以下简写:

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

这宣告了“应用程序魔”库的12.3版本的依赖,在“code.example.android”命名空间组内。

注意:这样的远程依赖性要求你申报相应的远程资源库,其中摇篮应该寻找库。如果库已经不存在本地,摇篮从远程站点时,构建需要它(当您单击如拉它同步工程与摇篮文件 或当您运行构建)。

二、库依赖关系配置

内侧dependencies块,可以声明使用几种不同的一个库依赖依赖关系配置(诸如compile上面示出)。每个相关配置提供了摇篮有关如何使用图书馆不同的指令。下面的列表描述了每个可使用在你的Android项目库依赖的配置。

注:虽然 Java Plugin for Gradle 提供了类似于下面定义的依赖关系配置,你不能在你的Android使用它们的项目,只有下面配置了Android Plugin for Gradle兼容。

  • compile
    摇篮增加依赖于编译类路径,并在APK。
  • apk
    摇篮增加了依赖性只有APK(它不添加到编译类路径)。

注意:您可以使用apk只为JAR二进制依赖。它不支持库模块或AAR二进制依赖。

  • provided
    摇篮增加依赖于编译类路径中唯一(它不添加到APK)。
    当你创建一个,这是有用的Android库模块 ,你在编译过程中需要的依赖性,但它是可选的有在运行时出现。也就是说,如果你使用这种配置,那么你的库模块必须包括一个运行状况检查依赖性是否可用,然后优雅地改变其行为,如果它没有提供它仍然可以正常工作。这有助于通过不添加短暂的依赖关系不是关键减少最终APK的大小。
    您也可以在Android应用模块中,当你依赖的是,你需要在编译时的JAR文件使用,并且您可以安全地假设已经在运行时可用(因此你不希望将它复制到你的APK) 。或者,也许你想编译反对使用指定的JAR provided配置,但使用apk 的配置来包装不同的JAR到APK,其中包括需要在运行相同的API。

注意:如果你要创建一个Android应用程序模块,则不能使用 provided了AAR的依赖,只为JAR文件。在Android库模块,你可以用它两个JAR和AARS。

以上配置适用于项目的主要来源集,它适用于所有的构建变种。
如果你不是想声明的依赖只有特定的 构建变量源设置或更改一个 测试源设置,你必须利用配置名称以及与构建变量或测试源集的名称前缀它。

例如,在添加compile
依赖关系只为您的“免费”产品的风味(使用远程二进制依赖),它看起来像这样:

dependencies {
    freeCompile 'com.google.firebase:firebase-ads:9.8.0'
}

但是,如果你想添加一个依赖于结合了产品的风味变体和构建类型,那么你必须初始化的配置名称configurations块。下面的示例增加了一个apk依赖于你的“freeDebug”打造变种(使用本地二进制依赖):

configurations {
    // Initializes a placeholder for the freeDebugApk dependency configuration.
    freeDebugApk {}
}

dependencies {
    freeDebugApk fileTree(dir: 'libs', include: ['*.jar'])
}

要添加compile为本地测试和仪表测试的依赖性,它看起来像这样:

dependencies {
    // Adds a remote binary dependency only for local tests.
    testCompile 'junit:junit:4.12'

    // Adds a remote binary dependency only for the instrumented test APK.
    androidTestCompile 'com.android.support.test.espresso:espresso-core:2.2.2'
}

如果你的库模块提供了多个变种,你可以添加不同的库变体像这样不同的应用程序变量:

dependencies {
  // Adds the 'debug' varaint of the library to the debug varaint of the app
  debugCompile project(path: ':my-library-module', configuration: 'debug')

  // Adds the 'release' varaint of the library to the release varaint of the app
  releaseCompile project(path: ':my-library-module', configuration: 'release')
}

三、远程仓库

当你的依赖比当地的图书馆或文件树以外的东西,摇篮会在哪个在线存储库中指定的文件 repositories的块build.gradle文件。

默认情况下,新的Android Studio项目申报JCenter作为该项目的顶级存储库位置build.gradle的文件,如下图所示:

allprojects {
    repositories {
        jcenter()
    }
}

如果你想从Maven的中央仓库的东西,然后再添加 mavenCentral(),或本地存储库使用mavenLocal():

allprojects {
    repositories {
        jcenter()
        mavenCentral()
        mavenLocal()
    }
}

参考配置:

allprojects {
    repositories {
        maven {
            url "https://repo.example.com/maven2"
        }
        maven {
            url "file://local/repo/"
        }
        ivy {
            url "https://repo.example.com/ivy"
        }
    }
}

四、查看依赖关系树

有些直接依赖可能有自己的依赖。这些被称为 传递依赖。而不是要求您手动声明每个传递依赖,摇篮自动收集,并增加了它们。为了形象化两个项目的直接和传递依赖,对于摇篮的Android插件提供了生成依赖关系树为每个摇篮任务构建变量测试源集合

要生成此报告,步骤如下:

  • 1、选择视图>工具的Windows>Gradle(或单击 Gradle中的工具窗口栏)。

  • 2、展开AppName的 >任务>的android并双击androidDependencies

  • 3、要查看报告,选择查看>工具的Windows>摇篮控制台

下面的示例报告显示调试构建变量的依赖关系树,包括前面例子中的本地库模块依赖和远程依赖性。

Executing tasks: [androidDependencies]
:app:androidDependencies
debug
/**
 * Both the library module dependency and remote binary dependency are listed
 * with their transitive dependencies.
 */
+--- MyApp:mylibrary:unspecified
|    \--- com.android.support:appcompat-v7:26.0.0
|         +--- com.android.support:animated-vector-drawable:26.0.0
|         |    \--- com.android.support:support-vector-drawable:26.0.0
|         |         \--- com.android.support:support-v4:26.0.0
|         |              \--- LOCAL: internal_impl-26.0.0.jar
|         +--- com.android.support:support-v4:26.0.0
|         |    \--- LOCAL: internal_impl-26.0.0.jar
|         \--- com.android.support:support-vector-drawable:26.0.0
|              \--- com.android.support:support-v4:26.0.0
|                   \--- LOCAL: internal_impl-26.0.0.jar
\--- com.android.support:appcompat-v7:26.0.0
     +--- com.android.support:animated-vector-drawable:26.0.0
     |    \--- com.android.support:support-vector-drawable:26.0.0
     |         \--- com.android.support:support-v4:26.0.0
     |              \--- LOCAL: internal_impl-26.0.0.jar
     +--- com.android.support:support-v4:26.0.0
     |    \--- LOCAL: internal_impl-26.0.0.jar
     \--- com.android.support:support-vector-drawable:26.0.0
          \--- com.android.support:support-v4:26.0.0
               \--- LOCAL: internal_impl-26.0.0.jar
...
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 225,928评论 6 523
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 97,032评论 3 410
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 173,382评论 0 370
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 61,580评论 1 304
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 70,558评论 6 403
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 54,018评论 1 316
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 42,261评论 3 432
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 41,328评论 0 281
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 47,858评论 1 328
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 39,843评论 3 351
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 41,954评论 1 358
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 37,565评论 5 352
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 43,251评论 3 342
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 33,677评论 0 25
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 34,834评论 1 278
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 50,558评论 3 383
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 47,033评论 2 368

推荐阅读更多精彩内容

  • 原文地址:Android Studio 简单介绍和使用问题小结 Google在2013的I/O开发者大会上引入的该...
    如若成枫阅读 2,207评论 0 3
  • 在 Android Studio 构建的项目中,基于 Gradle 进行项目的构建,同时使用 Android DS...
    Ant_way阅读 7,385评论 0 16
  • 1.介绍 如果你正在查阅build.gradle文件的所有可选项,请点击这里进行查阅:DSL参考 1.1新构建系统...
    Chuckiefan阅读 12,146评论 8 72
  • 近段时间有机会接触到iOS开发,但是光Xcode上配置证书,描述文件,上真机调试等就费了挺大劲。结合看到很多And...
    锦葛格阅读 3,854评论 0 1
  • 长阴镇给我的第一个礼物是在我出生时照进的阳光。对于一个时常阴沉的小镇来说,这是件很好的事情。 今天周末,恰好...
    大南啊阅读 522评论 0 0