5.详解build.gradle文件

最新推荐文章于 2024-10-01 01:40:11 发布

维所欲为

最新推荐文章于 2024-10-01 01:40:11 发布

阅读量3k

点赞数 3

分类专栏： Android 文章标签： build.gradle

本文链接：https://blog.csdn.net/qq564425/article/details/86672075

版权

Android 专栏收录该内容

6 篇文章 1 订阅

订阅专栏

我之前所开发的java项目都是使用Maven构建的，而安卓项目则是通过gradle构建的。

我们在之前分析安卓项目的目录结构的时候，可以看到build.gradle有两个，一个是位于最外层的，一个是位于app目录下的，这两个文件都对构建安卓项目都起着至关重要的作用。先来看看最外层的build.gradle

buildscript {
    repositories {
        google()
        jcenter()
        
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.3.0'
        
        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        google()
        jcenter()
        
    }
}

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

这些代码都是自动生成的，虽然看上去有点难以理解，我们忽略它的语法结构，只看最关键的部分，首先两处repositories的闭包中都声明了jcenter()这行配置，这行配置的意思是一个代码托管库，很多的Andriod开源项目都会托管到jcenter上，声明了这行配置后，我们就可以在项目中轻松的引用任何的jcenter上的开源项目了，同理google()也是如此。

接下来，dependencies 闭包中使用classpath 声明了一个Gradle插件。为什么要声明这个插件呢？因为Gradle并不是专门为构建Android项目而开发的，Java、C++等很多种项目都可以使用Gradle来构建。因此如果我们要想使用它来构建Android项目，则需要声明com.android.tools.build:gradle:3.3.0 这个插件。其中，最后面的部分是插件的版本号，我在写作本书时最新的插件版本是3.3.0。

下面，我们分析一下app目录下的build.gradle,代码如下：

apply plugin: 'com.android.application'

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

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:28.0.0'
    implementation 'com.android.support.constraint:constraint-layout:1.1.3'
    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'
}

我们逐行的分析：

第一行

    apply plugin: 'com.android.application'，第一行应用了一个插件，一般有两个可供选择的值，com.android.application：表示这是一个应用程序的模块，是可以直接运行的。另一个可供选择的值是com.android.library，表示是一个库模块，它只能作为代码库依附于别的应用程序模块来运行。

接下来是一个android的大闭包，在这个闭包中我们可以配置项目构建的各种属性。其中compileSdkVersion 28用于指定项目的编译版本，这里指定为28表示使用的Andriod9.0的SDK编译。然后我们看到，这里在android闭包中又嵌套了一个defaultConfig闭包，defaultConfig闭包中可以对项目的更多细节进行配置。其中，applicationId 用于指定项目的包名，前面我们在创建项目的时候其实已经指定过包名了，如果你想在后面对其进行修改，那么就是在这里修改的。minSdkVersion 用于指定项目最低兼容的Android系统版本，这里指定成15表示最低兼容到Android 4.0系统。targetSdkVersion 指定的值表示你在该目标版本上已经做过了充分的测试，系统将会为你的应用程序启用一些最新的功能和特性。比如说Android 6.0系统中引入了运行时权限这个功能，如果你将targetSdkVersion 指定成23或者更高，那么系统就会为你的程序启用运行时权限功能，而如果你将targetSdkVersion 指定成22，那么就说明你的程序最高只在Android 5.1系统上做过充分的测试，Android 6.0系统中引入的新功能自然就不会启用了。剩下的两个属性都比较简单，versionCode 用于指定项目的版本号，versionName 用于
指定项目的版本名，这两个属性在生成安装文件的时候非常重要，我们在后面都会学到。分析完了defaultConfig闭包，接下来我们看一下buildTypes闭包。buildTypes闭包中用于指定生成安装文件的相关配置，通常只会有两个子闭包，一个是debug，一个是release。debug闭包用于指定生成测试版安装文件的配置，release闭包用于指定生成正式版安装文件的配置。另外， debug闭包是可以忽略不写的，因此我们看到上面的代码中就只有一个release闭包。下面来看一下release闭包中的具体内容吧，minifyEnabled 用于指定是否对项目的代码进行混淆，true 表示混淆，false 表示不混淆。proguardFiles 用于指定混淆时使用的规则文件，这里指定了两个文件，第一个proguard-android.txt 是在Android SDK目录下的，里面是所有项目通用的混淆规则，第二个proguard-rules.pro 是在当前项目的根目录下的，里面可以编写当前项目特有的混淆规则。需要注意的是，通过Android Studio直接运行项目生成的都是测试版安装文件，关于如何生成正式版安装文件我们将会后面学习。

这样整个android闭包中的内容就都分析完了，接下来还剩一个dependencies闭包。这个闭包的功能非常强大，它可以指定当前项目所有的依赖关系。通常Android Studio项目一共有3种依赖方式：本地依赖、库依赖和远程依赖。本地依赖可以对本地的Jar包或目录添加依赖关系，库依赖可以对项目中的库模块添加依赖关系，远程依赖则可以对jcenter库上的开源项目添加依赖关系。观察一下dependencies闭包中的配置，第一行的compile fileTree 就是一个本地依赖声明，它表示将libs目录下所有.jar后缀的文件都添加到项目的构建路径当中。而第二行的compile 则是远程依赖声明，com.android.support:appcompat-v7:24.2.1 就是一个标准的远程依赖库格式，其中com.android.support 是域名部分，用于和其他公司的库做区分；appcompat-v7 是组名称，用于和同一个公司中不同的库做区分；24.2.1是版本号，用于和同一个库不同的版本做区分。加上这句声明后，Gradle在构建项目时会首先检查一下本地是否已经有这个库的缓存，如果没有的话则会去自动联网下载，然后再添加到项目的构建路径当中。至于库依赖声明这里没有用到，它的基本格式是compile project 后面加上要依赖的库名称，比如说有一个库模块的名字叫helper，那么添加这个库的依赖关系只需要加入compile project(':helper') 这句声明即可。另外剩下的一句testCompile 是用于声明测试用例库的，这个我们暂时用不到，先忽略它就可以了。