Gradle 基本概念

下面就以我的开源项目 9GAG 来详细讲解下和Gradle相关的知识, 和Gradle相关的几个文件一般有如下几个：

Gradle 基本概念 - 图1

红色标记部分从上到下咱们来一步步分析：

1. 9GAG/app/build.gradle

这个文件是app文件夹下这个Module的gradle配置文件，也可以算是整个项目最主要的gradle配置文件，我们来看下这个文件的内容：

  1. // 声明是Android程序
  2. apply plugin: 'com.android.application'
  4. android {
  5.     // 编译SDK的版本
  6.     compileSdkVersion 21
  7.     // build tools的版本
  8.     buildToolsVersion "21.1.1"
  10.     defaultConfig {
  11.         // 应用的包名
  12.         applicationId "me.storm.ninegag"
  13.         minSdkVersion 14
  14.         targetSdkVersion 21
  15.         versionCode 1
  16.         versionName "1.0.0"
  17.     }
  19.     // java版本
  20.     compileOptions {
  21.         sourceCompatibility JavaVersion.VERSION_1_7
  22.         targetCompatibility JavaVersion.VERSION_1_7
  23.     }
  25.     buildTypes {
  26.         debug {
  27.             // debug模式
  28.         }
  30.         release {
  31.             // 是否进行混淆
  32.             minifyEnabled false
  33.             // 混淆文件的位置
  34.             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.txt'
  35.         }
  36.     }
  38.     // 移除lint检查的error
  39.     lintOptions {
  40.       abortOnError false
  41.     }
  42. }
  44. dependencies {
  45.     // 编译libs目录下的所有jar包
  46.     compile fileTree(dir: 'libs', include: ['*.jar'])
  47.     compile 'com.android.support:support-v4:21.0.2'
  48.     compile 'com.etsy.android.grid:library:1.0.5'
  49.     compile 'com.alexvasilkov:foldable-layout:1.0.1'
  50.     // 编译extras目录下的ShimmerAndroid模块
  51.     compile project(':extras:ShimmerAndroid')
  52. }
  53.

这里需要说明几点：

  • 文件开头apply plugin是最新gradle版本的写法，以前的写法是apply plugin: ‘android’, 如果还是以前的写法，请改正过来。

  • buildToolsVersion这个需要你本地安装该版本才行，很多人导入新的第三方库，失败的原因之一是build version的版本不对，这个可以手动更改成你本地已有的版本或者打开 SDK Manager 去下载对应版本。

  • applicationId代表应用的包名，也是最新的写法，这里就不在多说了。

  • android 5.0开始默认安装jdk1.7才能编译，但是由于mac系统自带jdk的版本是1.6，所以需要手动下载jdk1.7并配置下，具体可以见我这篇博客Mac下安装和管理Java

  • minifyEnabled也是最新的语法，很早之前是runProguard,这个也需要更新下。

  • proguardFiles这部分有两段，前一部分代表系统默认的android程序的混淆文件，该文件已经包含了基本的混淆声明，免去了我们很多事，这个文件的目录在 toolsproguard/proguard-android.txt , 后一部分是我们项目里的自定义的混淆文件，目录就在 app/proguard-rules.txt , 如果你用Studio 1.0创建的新项目默认生成的文件名是 proguard-rules.pro , 这个名字没关系，在这个文件里你可以声明一些第三方依赖的一些混淆规则，由于是开源项目，9GAG里并未进行混淆，具体混淆的语法也不是本篇博客讨论的范围。最终混淆的结果是这两部分文件共同作用的。

  • compile project(‘:extras:ShimmerAndroid’)这一行是因为9GAG中存在其他Module，不知道Module的概念可以看下这篇博客Android Studio系列教程二–基本设置与运行, 总之你可以理解成Android Library，由于Gradle的普及以及远程仓库的完善，这种依赖渐渐的会变得非常不常见，但是你需要知道有这种依赖的。

  • 以上文件里的内容只是基本配置，其实还有很多自定义部分，如自动打包debug，release，beta等环境，签名，多渠道打包等，后续会单独拿出来讲解。

2. 9GAG/extras/ShimmerAndroid/build.gradle

每一个Module都需要有一个gradle配置文件，语法都是一样，唯一不同的是开头声明的是 apply plugin: ‘com.android.library’

3. 9GAG/gradle

这个目录下有个 wrapper 文件夹，里面可以看到有两个文件，我们主要看下 gradle-wrapper.properties 这个文件的内容：

  1. #Thu Dec 18 16:02:24 CST 2014
  2. distributionBase=GRADLE_USER_HOME
  3. distributionPath=wrapper/dists
  4. zipStoreBase=GRADLE_USER_HOME
  5. zipStorePath=wrapper/dists
  6. distributionUrl=https\://services.gradle.org/distributions/gradle-2.2.1-all.zip
  7.

可以看到里面声明了gradle的目录与下载路径以及当前项目使用的gradle版本，这些默认的路径我们一般不会更改的，这个文件里指明的gradle版本不对也是很多导包不成功的原因之一。