Gradle解析

最新推荐文章于 2024-08-08 10:42:50 发布

井冈山市监人

最新推荐文章于 2024-08-08 10:42:50 发布

阅读量275

点赞数

分类专栏： android基础

本文链接：https://blog.csdn.net/liu943367080/article/details/86467216

版权

android基础专栏收录该内容

68 篇文章 1 订阅

订阅专栏

本文通过9GAG项目详细解析Gradle的相关知识，包括`build.gradle`文件中的配置，如编译SDK版本、buildToolsVersion、应用包名、依赖管理等。此外，还介绍了其他相关文件的作用，如`settings.gradle`和`gradle-wrapper.properties`，以及模块间的依赖和Gradle插件版本的重要性。

摘要由CSDN通过智能技术生成

工程文件下的build.gradle:

apply plugin: 'com.android.application'//说明module的类型: com.android.application为主程序，com.android.library为库

android {

compileSdkVersion 22 //编译的SDK版本

buildToolsVersion "22.0.1" //编译的Tools版本

defaultConfig { //默认配置

applicationId "com.nd.famlink" //应用程序的包名

minSdkVersion 8 //支持的最低版本

targetSdkVersion 19 //支持的目标版本

versionCode 52 //版本号

versionName "3.0.1" //版本名

}

sourceSets { //目录指向配置

main {

manifest.srcFile 'AndroidManifest.xml'//指定AndroidManifest文件

java.srcDirs = ['src']//指定source目录

resources.srcDirs = ['src']//指定source目录

aidl.srcDirs = ['src']//指定source目录

renderscript.srcDirs = ['src']//指定source目录

res.srcDirs = ['res']//指定资源目录

assets.srcDirs = ['assets']//指定assets目录

jniLibs.srcDirs = ['libs']//指定lib库目录

}

debug.setRoot('build-types/debug')//指定debug模式的路径

release.setRoot('build-types/release')//指定release模式的路径

}

signingConfigs {//签名配置

release {//发布版签名配置

storeFile file("fk.keystore")//密钥文件路径

storePassword "123"//密钥文件密码

keyAlias "fk"//key别名

keyPassword "123"//key密码

}

debug {//debug版签名配置

storeFile file("fk.keystore")

storePassword "123"

keyAlias "fk"

keyPassword "123"

}

buildTypes {//build类型

release {//发布

minifyEnabled true//混淆开启

proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-project.txt'//指定混淆规则文件

signingConfig signingConfigs.release//设置签名信息

}

debug {//调试

signingConfig signingConfigs.release

}

packagingOptions {

exclude 'META-INF/ASL2.0'

exclude 'META-INF/LICENSE'

exclude 'META-INF/NOTICE'

exclude 'META-INF/MANIFEST.MF'

}

lintOptions {

abortOnError false //lint时候终止错误上报,防止编译的时候莫名的失败

}

configurations {

all*.exclude group: 'com.android.support', module: 'support-v4'

all*.exclude group: 'com.android.support', module: 'support-annotations'

}

当包有重复引用时，用这个导出。

dependencies {

complie fileTree(include: ['*.jar'], dir: 'libs') //编译主项目工程路径下libs文件下的所有jar包

complie files('libs/xxxx.jar'')//编译主项目工程路径下libs文件下的xxxx.jar包

compile project(':Easylink') //编译附加的依赖项目Easylink,表示这个依赖项目和主项目同一个路径

compile project(':lib:ImageLibrary')://编译附加的依赖项目ImageLibrary，在lib文件＋下，lib文件和主项目文件同一个路径。

compile 'com.nostra13.universalimageloader:universal-image-loader:1.9.3'//编译来自Jcenter的第三方开源库

provider 表示编译依赖项，jar时用，打包时不导入apk。

当导入的包重复时，比如引入的第三方包有V4包重复

compile('your bao'){

exclude group: 'com.android.support', module: 'support-v4'

}

compile
apk
provided
testCompile
androidTestCompile

compile是默认的那个，其含义是包含所有的依赖包，即在APK里，compile的依赖会存在。

apk的意思是apk中存在，但是不会加入编译中，这个貌似用的比较少。

provided的意思是提供编译支持，但是不会写入apk。

testCompile和androidTestCompile会添加额外的library支持针对测试。

Gradle 基本概念

下面就以我的开源项目 9GAG 来详细讲解下和Gradle相关的知识, 和Gradle相关的几个文件一般有如下几个：

红色标记部分从上到下咱们来一步步分析：

1. 9GAG/app/build.gradle

这个文件是app文件夹下这个Module的gradle配置文件，也可以算是整个项目最主要的gradle配置文件，我们来看下这个文件的内容：

// 声明是Android程序

apply plugin: 'com.android.application'

android {

// 编译SDK的版本

compileSdkVersion 21

// build tools的版本

buildToolsVersion "21.1.1"

defaultConfig {

// 应用的包名

applicationId "me.storm.ninegag"

minSdkVersion 14

targetSdkVersion 21

versionCode 1

versionName "1.0.0"

}

// java版本

compileOptions {

sourceCompatibility JavaVersion.VERSION_1_7

targetCompatibility JavaVersion.VERSION_1_7

}

buildTypes {

release {

// 是否进行混淆

minifyEnabled false

// 混淆文件的位置

proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.txt'

}

// 移除lint检查的error

lintOptions {

abortOnError false

}

dependencies {

// 编译libs目录下的所有jar包

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

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

compile 'com.etsy.android.grid:library:1.0.5'

compile 'com.alexvasilkov:foldable-layout:1.0.1'

// 编译extras目录下的ShimmerAndroid模块

compile project(':extras:ShimmerAndroid')

}

这里需要说明几点：

文件开头apply plugin是最新gradle版本的写法，以前的写法是apply plugin: 'android', 如果还是以前的写法，请改正过来。
buildToolsVersion这个需要你本地安装该版本才行，很多人导入新的第三方库，失败的原因之一是build version的版本不对，这个可以手动更改成你本地已有的版本或者打开 SDK Manager 去下载对应版本。
applicationId代表应用的包名，也是最新的写法，这里就不在多说了。
android 5.0开始默认安装jdk1.7才能编译，但是由于mac系统自带jdk的版本是1.6，所以需要手动下载jdk1.7并配置下，具体可以见我这篇博客Mac下安装和管理Java
minifyEnabled也是最新的语法，很早之前是runProguard,这个也需要更新下。
proguardFiles这部分有两段，前一部分代表系统默认的android程序的混淆文件，该文件已经包含了基本的混淆声明，免去了我们很多事，这个文件的目录在 <sdk目录>/tools/proguard/proguard-android.txt , 后一部分是我们项目里的自定义的混淆文件，目录就在 app/proguard-rules.txt , 如果你用Studio 1.0创建的新项目默认生成的文件名是 proguard-rules.pro , 这个名字没关系，在这个文件里你可以声明一些第三方依赖的一些混淆规则，由于是开源项目，9GAG里并未进行混淆，具体混淆的语法也不是本篇博客讨论的范围。最终混淆的结果是这两部分文件共同作用的。
compile project(':extras:ShimmerAndroid')这一行是因为9GAG中存在其他Module，不知道Module的概念可以看下这篇博客Android Studio系列教程二--基本设置与运行, 总之你可以理解成Android Library，由于Gradle的普及以及远程仓库的完善，这种依赖渐渐的会变得非常不常见，但是你需要知道有这种依赖的。
以上文件里的内容只是基本配置，其实还有很多自定义部分，如自动打包debug，release，beta等环境，签名，多渠道打包等，后续会单独拿出来讲解。