美文网首页
1.3.6 详解build.gradle文件——Android第

1.3.6 详解build.gradle文件——Android第

作者: 伪全栈工程师 | 来源:发表于2020-02-19 12:03 被阅读0次

    不同于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第

          本文链接:https://www.haomeiwen.com/subject/mqfafhtx.html