1.3.6 详解build.gradle文件——Android第一行代码(第二版)笔记

不同于Eclipse,Android Studio是采用Gradle来构建项目的。Gradle是一个非常先进的项目构建工具,它使用了一种基于Groovy的领域特定语言(DSL)来声明项目设置。
首先看项目最外层目录下的build.gradle文件,代码如下所示:

buildscript {
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.1.3'
    }
}
allprojects {
    repositories {
        google()
        jcenter()
    }
}
task clean(type: Delete) {
    delete rootProject.buildDir
}

这些代码是自动生成的,
首先两处,repositories的闭包中都声明了jcenter()这个配置。jcenter是一个代码托管仓库。
接下来,dependencies闭包中使用classpath声明一个Gradle插件。因为Gradle并不是专门为构建Android项目而开发的,因此如果我们要想使用它来构建Android项目,则需要声明com.android.tools.build:gradle:3.1.3这个插件。其中最后面的部分是版本号。

下面我们来看app目录下的build.gradle文件,代码如下所示:

apply plugin: 'com.android.application'

android {
    compileSdkVersion 28
    buildToolsVersion '28.0.0'
    defaultConfig {
        applicationId "com.lowthink.helloworld"
        minSdkVersion 15
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:28.0.0-alpha3'
    implementation 'com.android.support.constraint:constraint-layout:1.1.2'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'com.android.support.test:runner:1.0.2'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}

第一行应用了一个插件,一般有两种值可选:

  • com.android.application 表示这是一个应用程序模块,
  • com.android.library 表示这是一个库模块。
    应用程序模块和库模块的最大区别在于,一个是可以直接运行的,一个只能作为代码库依附于别的应用程序模块来运行。

android闭包:在这个闭包中我们可以配置项目构建的各种属性。

  • compileSdkVersion:用于指定项目构建的版本,这里指定成28标示使用Android 9.0系统的SDK编译。
  • buildToolsVersion:用于指定项目构建工具的版本,目前最新的28.0.0,如果有更新的版本时,Android Studio会进行提示。修改buildToolsVersion有两种方法,
    第一种直接在app中的build.gradle里添加
android {
    compileSdkVersion 28
    buildToolsVersion '28.0.0'
    defaultConfig {}
    buildTypes {}
}

第二种方法是选中项目,然后点鼠标右键,Open Module Settings,进入里面直接更改 buildTools的版本,如图

file
file

也可以点右上角的这个图片,如图

file
  • defultConfig闭包:可以对项目的更多细节进行配置。其中:
    applicationId:用于指定项目的包名;
    minSdkVersion:用于指定项目最低兼容的Android系统版本,这里设置成15标示最低兼容到Android 4.0系统;
    targetSdkVersion:指定的值标示你在该项目版本上已经做过了充分的测试,系统将会为你的应用程序启用一些最新的功能和特性;
    versionCode:用于指定项目的版本号;
    versionName:用于指定项目的版本名;
    API Level 与Android版本的对应关系
    | API Level | Android版本 |
    | --- | --- |
    | 28 | 9 |
    | 27 | 8.1 |
    | 26 | 8.0 |
    | 25 | 7.1.1 |
    | 24 | 7.0 |
    | 23 | 6.0 |
    | 22 | 5.1.1 |
    | 21 | 5.0.1 |
    | 20 | 4.4w.2 |
    | 19 | 4.4.2 |
    | 18 | 4.3.1 |
    | 17 | 4.2.2 |
    | 16 | 4.1.2 |
    | 15 | 4.0.3 |
    | 14 | 4.0 |
    | 10 | 2.3 |
    | 8 | 2.2 |

buildTypes闭包:用于指定生成安装文件的相关配置,通常只会有两个自闭包,一个是debug,一个是release。

  • debug闭包:用于指定生成测试版安装文件的配置;
  • release闭包:用于指定生成正式版安装文件的配置;
    minifyEnabled:用于指定是否对项目的代码进行混淆,true表示混淆,false表示不混淆;
    proguardFiles:用于指定混淆时使用的规则文件,这里指定了两个文件,第一个proguard-android.txt是Android SDK 目录下的,里面是所有项目通用的混淆规则,第二个proguard-rules.pro是在当前项目的根目录下的,里面可以编写当前项目特有的混淆规则。
    注:通过Andorid Studio直接运行项目生成的都是测试版安装文件;
    注:debug闭包是可以忽略不写的;

  • dependencies闭包:它可以指定向前项目所有的依赖关系。
    通常Android Studio项目一共有3种依赖方式:本地依赖、库依赖、远程依赖;
    • 本地依赖:可以对本地的Jar包或目录添加依赖关系;
    • 库依赖:可以对项目中的库模块添加依赖关系;
    • 远程依赖:可以对jcenter库上的开源项目添加依赖关系;
      注:2018开始用implementation代替compile
  • 第一行implementation fileTree就是一个本地依赖声明,它表示将libs目录下的所有.jar后缀的文件都添加到项目的构建路径当中。
  • 第二行implementation则是远程依赖声明,com.android.support:appcompat-v7:28.0.0-alpha3就是一个标准的远程依赖库格式,其中com.android.support是域名部分,用于和其他公司库做区分:appcompat-v7是组名称,用于和同一个公司中不同的库做区分;28.0.0-alpha3是版本号,用于和同一个库不同的版本做区分。加上这句声明后,Gradle在构建项目时会首先检查一下本地是否已经有这个库的缓存,如果没有的话则去自动联网下载,然后再添加到项目的构建路径当中。
  • 第三行代码implementation 'com.android.support.constraint:constraint-layout:1.1.2'声明,为了ConstraintLayout的使用(了解更多请移步这里)
  • 第四行代码testImplementation是用于声明测试用例库的;

本文由博客一文多发平台 OpenWrite 发布!

你可能感兴趣的:(1.3.6 详解build.gradle文件——Android第一行代码(第二版)笔记)