Android Studio里面的Build.gradle的详细配置说明

本文出自于：http://jingyan.baidu.com/article/bea41d4389bdc3b4c51be6be.html，http://my.oschina.net/u/1471093/blog/341990

，http://www.csdn123.com/html/topnews201408/74/9974.htm，

apply plugin: 'com.android.application'//说明module的类型，com.android.application为程序，com.android.library为库

android {

    compileSdkVersion 22//编译的SDK版本

    buildToolsVersion "22.0.1"//编译的Tools版本

    defaultConfig {//默认配置

        applicationId "com.nd.famlink"//应用程序的包名

        minSdkVersion 8//支持的最低版本

        targetSdkVersion 19//支持的目标版本

        versionCode 52//版本号

        versionName "3.0.1"//版本名

    }

    sourceSets {//目录指向配置

        main {

            manifest.srcFile 'AndroidManifest.xml'//指定AndroidManifest文件

            java.srcDirs = ['src']//指定source目录

            resources.srcDirs = ['src']//指定source目录

            aidl.srcDirs = ['src']//指定source目录

            renderscript.srcDirs = ['src']//指定source目录

            res.srcDirs = ['res']//指定资源目录

            assets.srcDirs = ['assets']//指定assets目录

            jniLibs.srcDirs = ['libs']//指定lib库目录

        }

        debug.setRoot('build-types/debug')//指定debug模式的路径

        release.setRoot('build-types/release')//指定release模式的路径

    }

    signingConfigs {//签名配置

        release {//发布版签名配置

            storeFile file("fk.keystore")//密钥文件路径

            storePassword "123"//密钥文件密码

            keyAlias "fk"//key别名

            keyPassword "123"//key密码

        }

        debug {//debug版签名配置

            storeFile file("fk.keystore")

            storePassword "123"

            keyAlias "fk"

            keyPassword "123"

        }

    }

    buildTypes {//build类型

        release {//发布

            minifyEnabled true//混淆开启

            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-project.txt'//指定混淆规则文件

            signingConfig signingConfigs.release//设置签名信息

        }

        debug {//调试

            signingConfig signingConfigs.release

        }

    }

    packagingOptions {

        exclude 'META-INF/ASL2.0'

        exclude 'META-INF/LICENSE'

        exclude 'META-INF/NOTICE'

        exclude 'META-INF/MANIFEST.MF'

    }

    lintOptions {

        abortOnError false//lint时候终止错误上报,防止编译的时候莫名的失败

    }

}

dependencies {

    compile fileTree(dir: 'libs', exclude: ['android-support*.jar'], include: ['*.jar'])   //编译lib目录下的.jar文件

    compile project(':Easylink')//编译附加的项目

    compile project(':ImageLibrary')

    compile project(':ImageResLibrary')

    compile project(':Ofdmtransport')

    compile project(':PullToRefreshLibrary')

    compile project(':RecorderLibrary')

    compile project(':WebSocket')

    compile project(':WidgetLibrary')

    compile 'com.nostra13.universalimageloader:universal-image-loader:1.9.3'//编译来自Jcenter的第三方开源库

}

Gradle 基本概念

首先我们学习几个gradle 的脚本语法，掌握了这几个语法，你就能非常简单的用gradle构建打包android项目了。 首先，我们来看下一个最简单android build.gradle。

build.gradle

    //设置脚本的运行环境
    buildscript {
         //支持java 依赖库管理（maven/ivy）,用于项目的依赖。
	 repositories {
            mavenCentral()
        }
        //依赖包的定义。支持maven/ivy，远程，本地库，也支持单文件
        dependencies {
            classpath 'com.android.tools.build:gradle:0.4'
        }
    }
    //声明构建的项目类型，这里当然是android了
    apply plugin: 'android'
    //设置编译android项目的参数
    android {
        compileSdkVersion 17
        buildToolsVersion "17"
    
        defaultConfig {
            minSdkVersion 8
            targetSdkVersion 17
        }
        //Android默认配置
        sourceSets {
            main {
                manifest.srcFile 'AndroidManifest.xml'
                java.srcDirs = ['src']
                resources.srcDirs = ['src']
                aidl.srcDirs = ['src']
                renderscript.srcDirs = ['src']
                res.srcDirs = ['res']
                assets.srcDirs = ['assets']
            }
            //测试所在的路径，这里假设是tests文件夹，没有可以不写这一行
            instrumentTest.setRoot('tests')
        }
        
        //这个是解决lint报错的代码
        lintOptions {
            abortOnError false
        }
        /**
         * 签名设置
         */
        signingConfigs {
            myConfigs {
                storeFile file("签名文件地址")
                keyAlias "..."
                keyPassword "..."
                storePassword "..."
            }
        }
        /**
         * 混淆设置
         */
        buildTypes {
            release {
                signingConfig signingConfigs.myConfigs
                runProguard true
                proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            }
        }
        /**
         * 渠道打包（不同包名）
         */
        productFlavors {
            qqqq {
                applicationId = '包名'
            }
            hhhhh {
                applicationId='包名'
            }
        }
    }
    /**
     * .so文件的导入
     */
    task copyNativeLibs(type: Copy) {
        from fileTree(dir: 'libs', include: 'armeabi/*.so') into 'build/lib'
    }

    tasks.withType(Compile) {
        options.encoding = "UTF-8"
    }
    
    tasks.withType(Compile) {
        compileTask -> compileTask.dependsOn copyNativeLibs
    }
    clean.dependsOn 'cleanCopyNativeLibs'
    tasks.withType(com.android.build.gradle.tasks.PackageApplication) { pkgTask ->
        pkgTask.jniFolders = [new File(buildDir, 'lib')]
    }
    //依赖库
    dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    }

本地依赖

gradle 作为构建工具，能够很方便的使用本地jar包，以下为使用的代码块。

dependencies {	
        //单文件依赖
	compile files('libs/android-support-v4.jar')	
	//某个文件夹下面全部依赖
	compile fileTree(dir: 'libs', include: '*.jar')
}

android {
	
}

远程依赖

gradle 同时支持maven，ivy，由于ivy我没用过，所以用maven 作为例子，以下为代码块：

repositories {	
        //从中央库里面获取依赖
	mavenCentral()	
	//或者使用指定的本地maven 库
	maven{
		url "file://F:/githubrepo/releases"
	}	
	//或者使用指定的远程maven库
	maven{
		url "远程库地址"
	}
}

dependencies {	
        //应用格式: packageName:artifactId:version
	compile 'com.google.android:support-v4:r13'}

android {

}

android library 依赖

对于项目依赖 android library的话，就不是依赖一个jar，那么简单了，在这里需要使用gradle mulit project 机制。在过去，android library并没有一个很好的包管理方式，简单来说，在gradle出现以前，官方并没有一种用于管理android library 依赖包的方式，一般我们都是直接下载别人的android library project 源码进行集成，而对于第三方的android-maven-plugin 用的是apklib 格式。

而现在，官方终于推出一种android library的打包格式，扩展名为*.aar。前面提到，目前android gradle插件并不支持本地直接使用*.aar文件，不过，支持包管理库的引用方式，下面，我为大家说一下，怎么对android library 发布使用。

打包android library

对android library 进行打包直接在library项目下面使用gradle build 即可，然后，你就会在 build/libs 目录下看到两个*.aar文件，一个debug包用的，一个是release 下用的，看个人需求使用，这里我们用的是release 版本的 .aar 文件。

引用脚本跟前面讲的依赖库相似

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

最后，分享个maven库地址：http://mvnrepository.com/和gradle版本地址：http://tools.android.com/tech-docs/new-build-system

另外，gradle文件配置部分更新：http://my.oschina.net/u/1471093/blog/354442

在此添加，最新grad了配置地址为：http://my.oschina.net/u/1471093/blog/539075

The dependency, mother of all dependencies

开始之前，这里有一个重要的工具可以让你处理依赖更简单方便：SDK Manager Plugin,它会自动下载和更新你的一些依赖（例如：API,support library,emulator）,非常好用，尤其是当你下载了别人的代码项目时，什么也干不了，这时只需打开项目，等待下载或更新依赖，然后你可以启动应用程序了！

使用这个插件，只需要在你Project的根目录的build.gradle加上一行就可以了

 dependencies {
   classpath 'com.android.tools.build:gradle:1.3.0'
   classpath 'com.jakewharton.sdkmanager:gradle-plugin:0.12.0' //添加该行
}

更多该插件相关信息 github