Android Studio系列教程四--Gradle基础

Android Studio系列教程四--Gradle基础

本文为个人原创，欢迎转载，但请务必在明显位置注明出处！

事实上非常早之前也写了一篇Gradle的基础博客，可是时间非常久了，如今Gradle已经更新了非常多，所以暂且结合Stduio 1.0正式版与最新的Gradle语法来具体解说下。小伙伴们直接跟我一步步来学习吧。

什么是Gradle？

Gradle是一种依赖管理工具，基于Groovy语言，面向Java应用为主，它抛弃了基于XML的各种繁琐配置。取而代之的是一种基于Groovy的内部领域特定（DSL）语言。

安装Gradle

在Android Studio系列教程一–下载与安装中新建项目成功后会下载Gradle，貌似这个过程不翻墙也是能够下载，可是訪问特别慢，建议翻墙下载。

那么下载的Gradle到什么地方呢？

• Mac上会默认下载到 **/Users/<username>/.gradle/wrapper/dists** 文件夹

• Win平台会默认下载到 C:Documents and Settings<username>.gradlewrapperdists 文件夹

你会看到这个文件夹下有个 gradle-x.xx-all 的文件夹, 假设下载实在太慢。可是又不想翻墙的话，能够自己手动到Gradle官网下载相应的版本号。然后将下载的.zip文件(也能够解压)拷贝到上述的gradle-x.xx-all 目录下，只是还是建议让它直接下载的好。

Gradle 基本概念

以下就以我的开源项目 9GAG 来具体解说下和Gradle相关的知识, 和Gradle相关的几个文件一般有例如以下几个：

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

1. 9GAG/app/build.gradle

这个文件是app目录下这个Module的gradle配置文件，也能够算是整个项目最基本的gradle配置文件，我们来看下这个文件的内容：

// 声明是Android程序
apply plugin: 'com.android.application'

android {
    // 编译SDK的版本号
    compileSdkVersion 21// build tools的版本号
    buildToolsVersion "21.1.1"

    defaultConfig {
    	// 应用的包名
        applicationId "me.storm.ninegag"
        minSdkVersion 14
        targetSdkVersion 21
        versionCode 1
        versionName "1.0.0"
    }

    // java版本号
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_7
        targetCompatibility JavaVersion.VERSION_1_7
    }
    
    buildTypes {
        debug {
            // debug模式
        }
        
        release {
            // 是否进行混淆
            minifyEnabled false// 混淆文件的位置
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.txt'
        }
    }
    
    // 移除lint检查的error
    lintOptions {
      abortOnError false
    }
}

dependencies {
    // 编译libs文件夹下的全部jar包
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile 'com.android.support:support-v4:21.0.2'
    compile 'com.etsy.android.grid:library:1.0.5'
    compile 'com.alexvasilkov:foldable-layout:1.0.1'// 编译extras文件夹下的ShimmerAndroid模块
    compile project(':extras:ShimmerAndroid')
}

这里须要说明几点：

• 文件开头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程序的混淆文件，该文件已经包括了主要的混淆声明。免去了我们非常多事。这个文件的文件夹在 **/tools/proguard/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 这个文件的内容：

#Thu Dec 18 16:02:24 CST 2014
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https://services.gradle.org/distributions/gradle-2.2.1-all.zip

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

4. 9GAG/build.gradle

这个文件是整个项目的gradle基础配置文件,我们来看看这里面的内容

//Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.0.0'
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

内容主要包括了两个方面：一个是声明仓库的源，这里能够看到是指明的jcenter(), 之前版本号则是mavenCentral(), jcenter能够理解成是一个新的中央远程仓库。兼容maven中心仓库，并且性能更优。还有一个是声明了android gradle plugin的版本号，android studio 1.0正式版必需要求支持gradle plugin 1.0的版本号。

5. 9GAG/settings.gradle

这个文件是全局的项目配置文件，里面主要声明一些须要增加gradle的module，我们来看看9GAG该文件的内容：

include':app', ':extras:ShimmerAndroid'

文件里的 app, extras:ShimmerAndroid 都是module，假设还有其它module都须要依照如上格式加进去。

总结

关于gradle的基础知识就介绍到这里，接下来会介绍一种我经常使用的高速方便的编译查看第三方开源项目的方法，怎样导入Android Studio，Gradle经常使用基本命令，多渠道打包配置等。有疑问或者发现错误欢迎大家直接博客留言。