Gradle for Android 第三篇( 依赖管理 )

时间 2019-11-06

原文原文链接

这一系列暂不更新，相关技术讨论，请移步微信群，谢谢，但愿你们多多支持！android

依赖管理

这会是一个系列，因此若是你尚未看我以前的几篇文章，请先查看如下文章：c++

依赖管理是Gradle最闪耀的地方，最好的情景是，你仅仅只需添加一行代码在你的build文件，Gradle会自动从远程仓库为你下载相关的jar包，而且保证你可以正确使用它们。Gradle甚至能够为你作的更多，包括当你在你的工程里添加了多个相同的依赖，gradle会为你排除掉相同的jar包。在这一章咱们将学习如下内容：网络

仓库app
本地依赖
详解依赖这一律念

仓库

当咱们讨论依赖的时候，咱们一般说的是远程仓库，就像那些依赖库专门用来提供给其余开发者使用的依赖库。手动管理依赖将会为你带来很大麻烦。你必须定位到该依赖文件位置，而后下载jar文件，复制该文件到你的项目，而后引用它们。一般这些jar文件尚未具体的版本号，因此你还必须去记忆它们的版本号，这样当须要更新的时候，你才会知道须要替换成哪一个版本。你同时必须将该依赖包放在svn或者git上，这样你的其余同事才能够不用手动去下载这些依赖jar。

使用远程仓库能够解决这些问题，一个仓库能够被视为一些文件的集合体。Gradle不会默认为你的项目添加任何仓库。因此你须要把它们添加到repositories方法体内。若是是使用的是Android studio，那么工具已经为你准备好了这一切：

repositories {
    jcenter()
}

Gradle支持三种不一样的仓库，分别是：Maven和Ivy以及文件夹。依赖包会在你执行build构建的时候从这些远程仓库下载，固然Gradle会为你在本地保留缓存，因此一个特定版本的依赖包只须要下载一次。

一个依赖须要定义三个元素：group，name和version。group意味着建立该library的组织名，一般这会是包名，name是该library的惟一标示。version是该library的版本号，咱们来看看如何申明依赖：

dependencies {
       compile 'com.google.code.gson:gson:2.3'
       compile 'com.squareup.retrofit:retrofit:1.9.0'
}

上述的代码是基于groovy语法的，因此其完整的表述应该是这样的：

dependencies {
      compile group: 'com.google.code.gson', name: 'gson', version:'2.3'
      compile group: 'com.squareup.retrofit', name: 'retrofit'
           version: '1.9.0'
     }

为你的仓库预约义

为了方便，Gradle会默认预约义三个maven仓库：Jcenter和mavenCentral以及本地maven仓库。你能够同时申明它们：

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

Maven和Jcenter仓库是很出名的两大仓库。咱们不必同时使用他们，在这里我建议大家使用jcenter，jcenter是maven中心库的一个分支，这样你能够任意去切换这两个仓库。固然jcenter也支持了https，而maven仓库并无。

本地maven库是你曾使用过的全部依赖包的集合，固然你也能够添加本身的依赖包。默认状况下，你能够在你的home文件下找到.m2的文件夹。除了这些仓库外，你还可使用其余的公有的甚至是私有仓库。

远程仓库

有些组织，建立了一些有意思的插件或者library,他们更愿意把这些放在本身的maven库，而不是maven中心库或jcenter。那么当你须要是要这些仓库的时候，你只须要在maven方法中加入url地址就好：

repositories {
       maven {
           url "http://repo.acmecorp.com/maven2"
       }
}

一样的，Ivy仓库也能够这么作。Apache Ivy在ant世界里是一个很出名的依赖管理工具。若是你的公司有本身的仓库，若是他们须要权限才能访问，你能够这么编写：

repositories {
       maven {
           url "http://repo.acmecorp.com/maven2"
           credentials {
               username 'user'
               password 'secretpassword'
           }
        } 
   }

注意：这不是一个好主意，最好的方式是把这些验证放在Gradle properties文件里，这些咱们已经介绍过在第二章。

本地依赖

可能有些状况，你须要手动下载jar包，或者你想建立本身的library，这样你就能够复用在不一样的项目，而没必要将该library publish到公有或者私有库。在上述状况下，可能你不须要网络资源，接下来我将介绍如何是使用这些jar依赖，以及如何导入so包，如何为你的项目添加依赖项目。

文件依赖

若是你想为你的工程添加jar文件做为依赖，你能够这样：

dependencies {
       compile files('libs/domoarigato.jar')
}

若是你这么作，那会很愚蠢，由于当你有不少这样的jar包时，你能够改写为：

dependencies {
       compile fileTree('libs')
 }

默认状况下，新建的Android项目会有一个lib文件夹，而且会在依赖中这么定义（即添加全部在libs文件夹中的jar）：

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

这也意味着，在任何一个Android项目中，你均可以把一个jar文件放在到libs文件夹下，其会自动的将其添加到编译路径以及最后的APK文件。

native包（so包）

用c或者c++写的library会被叫作so包，Android插件默认状况下支持native包，你须要把.so文件放在对应的文件夹中：

app
   ├── AndroidManifest.xml
   └── jniLibs
       ├── armeabi
       │   └── nativelib.so
       ├── armeabi-v7a
       │   └── nativelib.so
       ├── mips
       │   └── nativelib.so
       └── x86
           └── nativelib.so

aar文件

若是你想分享一个library,该依赖包使用了Android api，或者包含了Android 资源文件，那么aar文件适合你。依赖库和应用工程是同样的，你可使用相同的tasks来构建和测试你的依赖工程，固然他们也能够有不一样的构建版本。应用工程和依赖工程的区别在于输出文件，应用工程会生成APK文件，而且其能够安装在Android设备上，而依赖工程会生成.aar文件。该文件能够被Android应用工程当作依赖来使用。

建立和使用依赖工程模块

不一样的是，你须要加不一样的插件：

apply plugin: 'com.android.library'

咱们有两种方式去使用一个依赖工程。一个就是在你的工程里面，直接将其做为一个模块，另一个就是建立一个aar文件，这样其余的应用也就能够复用了。

若是你把其做为模块，那你须要在settings.gradle文件中添加其为模块：

include ':app', ':library'

在这里，咱们就把它叫作library吧，若是你想使用该模块，你须要在你的依赖里面添加它，就像这样:

dependencies {
       compile project(':library')
  }

使用aar文件

若是你想复用你的library，那么你就能够建立一个aar文件，并将其做为你的工程依赖。当你构建你的library项目，aar文件将会在 build/output/aar/下生成。把该文件做为你的依赖包，你须要建立一个文件夹来放置它，咱们就叫它aars文件夹吧，而后把它拷贝到该文件夹里面，而后添加该文件夹做为依赖库：

repositories {
    flatDir {
        dirs 'aars' 
    }
}

这样你就能够把该文件夹下的全部aar文件做为依赖，同时你能够这么干：

dependencies {
       compile(name:'libraryname', ext:'aar')
}

这个会告诉Gradle，在aars文件夹下，添加一个叫作libraryname的文件，且其后缀是aar的做为依赖。

依赖的概念

配置

有些时候，你可能须要和sdk协调工做。为了能顺利编译你的代码，你须要添加SDK到你的编译环境。你不须要将sdk包含在你的APK中，由于它早已经存在于设备中，因此配置来啦，咱们会有5个不一样的配置：

compile
apk
provided
testCompile
androidTestCompile

compile是默认的那个，其含义是包含全部的依赖包，即在APK里，compile的依赖会存在。

apk的意思是apk中存在，可是不会加入编译中，这个貌似用的比较少。

provided的意思是提供编译支持，可是不会写入apk。

testCompile和androidTestCompile会添加额外的library支持针对测试。

这些配置将会被用在测试相关的tasks中，这会对添加测试框架例如JUnit或者Espresso很是有用，由于你只是想让这些框架们可以出如今测试apk中，而不是生产apk中。

除了这些特定的配置外，Android插件还为每一个构建变体提供了配置，这让debugCompile或者releaseProvided等配置成为可能。若是你想针对你的debug版本添加一个logging框架，这将颇有用。这些内容的详细介绍，我会在下一个博客里详细介绍。

动态版本

在一些情形中，你可能想使用最新的依赖包在构建你的app或者library的时候。实现他的最好方式是使用动态版本。我如今给大家展现几种不一样的动态控制版本方式：

dependencies {
       compile 'com.android.support:support-v4:22.2.+'
       compile 'com.android.support:appcompat-v7:22.2+'
       compile 'com.android.support:recyclerview-v7:+'
}

第一行，咱们告诉gradle,获得最新的生产版本。第二行，咱们告诉gradle，咱们想获得最新的minor版本，而且其最小的版本号是2. 第三行，咱们告诉gradle,获得最新的library。

你应该当心去使用动态版本，若是当你容许gradle去挑选最新版本，可能致使挑选的依赖版本并非稳定版，这将会对构建产生不少问题，更糟糕的是你可能在你的服务器和私人pc上获得不一样的依赖版本，这直接致使你的应用不一样步。

若是你在你的build.gradle中使用了动态版本，Android studio将会警告你关于动态版本的潜在问题，就像你下面看到的这样：

Android studio UI操做依赖库

在使用Android studio中，最简单的添加新依赖包的方法是使用工程结构弹框。从文件按钮中打开界面，导航到依赖包导航栏，而后你就能够看到你当前的依赖包了：

当你想添加新的依赖包的时候，能够点击绿色的小按钮，你能够添加其余模块，文件，甚至是上网搜索。

使用Android studio的界面让你可以很简单的浏览你项目中的全部依赖，而且添加新的依赖包。你没必要在build.gradle中手动的添加代码了，而且你能够直接搜索JCenter库中的依赖资源。

总结

在这一章里，咱们了解了多种方式添加依赖，咱们学习了什么是仓库，以及如何使用他们，同时学习了如何在不使用仓库的状况下使用jar文件。

你如今知道了依赖包的属性配置，动态版本控制等。

咱们也谈到了关于在多个环境下构建app变种，在下一章，咱们将会学习到什么是构建变种，以及为何他们很重要，构建变种将会使得开发测试以及分发app变得更加容易。理解变种的工做原理能够加快你的开发和分发效率。