build.gradle文件

2018-05-02 本文已影响0人沐左

Gradle快速查看指南

官网提供：https://docs.gradle.org/current/dsl/index.html

一、简介

Android Studio是采用Gradle来构建项目的。

1、补充项目构建的知识

构建工具是一个把源代码生成可执行应用程序的过程自动化的程序（例如Android app生成apk）。
构建包括编译、连接以及把代码打包成可用的或可执行的形式。
构建也可以理解为使一大部分任务自动执行的一个动作，比如：

下载依赖
将源代码编译成二进制代码
打包生成的二进制代码
进行单元测试
部署到生产系统

2、各种现有构建工具

For java - Ant,Maven,Gradle.
For .NET framework - NAnt
c# - MsBuild.

3、Maven介绍、

maven用来解决依赖包管理问题,同时优化测试，打包，部署等流程，
在android里,

maven可以管理你的依赖包
打包成apklib,管理自己的组件库
动态配置你的发布渠道(此点非常方便)
签名，打包，混淆一条龙服务.

4、学习地址

Build automation
List of build automation software

二、build.gradle文件

项目中一般会出现2个或者多个build.gradle文件，在Project模式下存在于Project目录以及各Module目录下；Android模式下则都存在于Gradle Scripts下。

1、Project目录下的build.gradle文件

// Top-level build file where you can add configuration options common to all sub-projects/modules.
//顶级构建文件，您可以在其中添加对所有子项目/模块通用的配置选项。
buildscript {   //构建的脚本
    
    repositories {  //代码仓库
        google()  //google代码托管库：设置之后可以在项目中轻松引用google上的开源项目
        jcenter()  //jcenter代码托管库：设置之后可以在项目中轻松引用jcenter上的开源项目
    }
    dependencies {  //添加依赖，可以在这里加入项目常用的插件
        classpath 'com.android.tools.build:gradle:3.0.1'  //声明gradle插件，2.2.0为插件版本号
        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8' //开发者个人添加ButterKnife插件
        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'  //
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
        //不要在这里放置您的应用程序依赖关系; 它们属于单独的模块build.gradle文件
    }
}

allprojects {  //所有项目
    repositories {  //代码仓库
        google()  //google代码托管库
        jcenter()  //jcenter代码托管库
        maven {  
            url 'https://esri.bintray.com/arcgis'
        }
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

2、Module目录下的build.gradle文件

apply plugin: 'com.android.application'  //默认的应用程序模块（插件）
apply plugin: 'com.neenbedankt.android-apt' //开发者添加butterkinfe插件

android {
    compileSdkVersion 26  //当前项目编译时基于的Android版本
    defaultConfig {    //默认配置
        applicationId "com.example.zuo.gisdemo"    //包名
        minSdkVersion 19    //最低兼容的AndroidSDK
        targetSdkVersion 26  //目标版本（建议版本）
        versionCode 1  //版本号
        versionName "1.0"   //版本名称
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"  //单元测试
    }
    buildTypes {  //编译类型，release or debug
        release {
            minifyEnabled false   //是否混淆（true为混淆）
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            // 'proguard-rules.pro'能够对 Java 类中的代码进行压缩（Shrink），优化（Optimize），混淆（Obfuscate），预检（Preveirfy）。
        }
    }
    //使用packagingOptions排除不想添加到apk中的文件
    packagingOptions {
        exclude 'META-INF/LGPL2.1'
        exclude 'META-INF/LICENSE'
        exclude 'META-INF/NOTICE'
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:26.1.0'
    implementation 'com.android.support.constraint:constraint-layout:1.1.0'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'com.android.support.test:runner:1.0.1'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.1'
    compile 'com.jakewharton:butterknife:8.8.1'
    annotationProcessor 'com.jakewharton:butterknife-compiler:8.8.1'
    compile "com.esri.arcgis.android:arcgis-android:10.2.9"
}

3、在根项目中声明Module中工具/库使用的版本号

4、引用第三方库的方式

Android Studio 里面的引用第三方库总结，以及compile、provided使用

自动下载包，并且引用它

compile 'com.android.support:support-v4:23.3.0'

引用libs下所有jar包

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

引用一个jar

compile files('libs/fastjson-1.1.53.android.jar')

引用一个aar文件
不能自动引用全部的aar，需要对每个aar分别进行引用

compile(name: 'aar_file_name', ext: 'aar')

引用库类型（Module）的项目

compile project(':xxxsdk')

仅在编译时使用，最终不会被编译到apk或aar里

provided files('libs/glide-3.7.0.jar')

implementation不可以依赖传递，但是compile可以依赖传递
举例：
我们的项目中有app,moduleA,moduleB三个module；
app依赖moduleA，moduleA依赖moduleB；
使用compile时，我们可以在app内能调用module2的参数和方法，
但是使用implementation时就不行。
优劣：
使用compile依赖，操作简单，但是会导致模块耦合度高，
使用implementation依赖，操作稍复杂，但是可以做到降低偶合度。

 implementation 'com.android.support:appcompat-v7:26.1.0'