一个新建的Android Studio项目中会有两个build.gradle文件,一个在最外层目录下,一个在app模块目录下。这两个文件对于项目的构建都起到了至关重要的作用。
先看一下最外层目录下的build.gradle文件。
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:3.4.0'
}
}
allprojects {
repositories {
jcenter()
}
}
两处repositories闭包中都声明了jcenter()这行配置。jcenter是一个代码托管仓库,里面有很多开源项目,声明后可以很方便的引用jcenter上的开源项目。
dependencies闭包中声明了一个Gradle插件。为啥要声明这个插件呢?因为Gradle并不是专门为Android项目开发的,如果要使用就要申明。
再看一下app模块中的build.gradle文件
apply plugin: 'com.android.application'
android {
compileSdkVersion 24
buildToolsVersion "24.0.2"
defaultConfig {
applicationId "com.example.myapplication"
minSdkVersion 15
targetSdkVersion 24
versionCode 1
versionName "1.0"
}
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:24.2.1'
testImplementation 'junit:junit:4.12'
}
第一行应用了一个插件,一般有两个值可选:com.android.application 表示这是一个应用程序模块, com.android.library 表示这是一个库模块。两者的区别是,前者可以直接运行,后者只能作为代码库依附于别的应用程序模块来运行。
下面是一个android闭包。
- compileSdkVersion 指定项目的编译版本,24表示使用Android 7.0系统的SDK编译。
- buildToolsVersion 指定项目构建工具版本。
在android闭包中嵌套了一个defaultConfig闭包
- applicationId 指定项目包名
- minSdkVersion 指定项目最低兼容的Android系统版本
- targetSdkVersion 指定的值表示在这个版本上已经做过充分的测试了,系统会为你的应用启动一些新的功能和特性。
- versionCode 指定项目的版本号
- versionName 指定项目的版本名
接下来是一个buildTypes 闭包
用于指定生成安装文件的相关配置,通常只会有两个子闭包,debug 和 release。debug 用于指定测试版安装文件的配置,release用于指定生成正式版安装文件的配置。
debug闭包可以不写,在release闭包中
minifyEnabled 用于指定是否对项目代码进行混淆,true代表混淆,false代表不混淆。
proguardFiles 用于指定混淆是使用的规则文件。这里指定了两个文件:
- proguard-android-optimize.txt 在Android SDK目录下,里面是所有的项目通用的混淆规则
- proguard-rules.pro 在当前项目根目录下,用于编写当前项目特有的混淆规则。
接下来还剩下一个dependencies 闭包
指定当前项目所有的依赖关系。
通常Android Studio项目一共有3种依赖关系:
- 本地依赖 – 可以对本地的jar包或目录添加依赖关系
- 库依赖 – 可以对项目中的库模块添加依赖关系
- 远程依赖 – 可以对jcenter仓库中的开源项目添加依赖关系
例如:
第一行 implementation fileTree(dir: ‘libs’, include: [’*.jar’]) 就是一个本地依赖,它表示将libs目录下所有的 .jar 后缀的文件都添加到项目的构建路径中。
第二行 implementation ‘com.android.support:appcompat-v7:24.2.1’ 则是一个远程依赖,其中 com.android.support 是域名部分,用于区分公司,appcompat-v7 是组名,用于区分同一家公司的不同库, 24.2.1 是版本号。声明后,Gradle在构建项目时会首先检查本地是否有这个库的缓存,如果没有就会自动联网下载。