时间:2022-11-13 10:14:24 | 栏目:Android代码 | 点击:次
Gradle简介
Gradle 是一个优秀的构建系统和构建工具,它允许通过插件创建自定义的构建逻辑。它具有如下一些特点:
使用Gradle方式来构建项目,主要是为了达到如下的一些目的:
构建项目基础
文件构建
一个Gradle项目的构建过程定义在build.gradle文件中,位于项目的根目录下。一个最简单的Gradle纯Java项目的build.gradle文件包含以下内容。
apply plugin: 'java'
上面的代码是引入了Gradle的Java插件,这个插件提供了所有构建和测试Java应用程序所需要的东西。例如,下面是一个最简单的Android项目的build.gradle文件的源代码。
buildscript { repositories { google() jcenter() } dependencies { classpath 'com.android.tools.build:gradle:3.4.1' } } allprojects { repositories { google() jcenter() } } task clean(type: Delete) { delete rootProject.buildDir }
build.gradle文件
在一个Android项目中一般会出现至少2个build.gradle文件,一个是project的gradle文件,一个是app module的gradle文件。
gradle文件中会涉及很多的常用命令和代码,它们的具体含义如下:
1.jcenter()
代码托管库,设置后可以在项目中引用jcenter上的开源项目,声明在build.gradle文件的repositories闭包中。
2.gradle插件及版本号
经常会看到如下一段代码:
classpath 'com.android.tools.build:gradle:3.4.1'
3.Android 闭包配置
在build.gradle的Android闭包中会看到一些常用的配置,如下所示:
4.buildTypes闭包
此配置包一般会包含两个闭包配置,一个是debug,一个release;当然也可以有其他闭包。debug闭包用于生成测试版安装文件的配置,release闭包用于生成正式版安装文件的配置。此文件的配置如下:
5.dependencies闭包
Android Studio 项目开发中一共有三种依赖方式:本地依赖、库依赖和远程依赖。
项目结构
Gradle遵循约定优先于配置的概念,在可能的情况尽可能提供合理的默认配置参数。Android基本的项目开始于两个名为“source sets”的组件,即main source code和test code。它们分别位于:src/main/和src/androidTest/文件中。
对于Java plugin和Android plugin来说,它们的Java源代码和资源文件路径如下:java/和resources/文件目录中。
对于Android plugin来说,它还拥有以下特有的文件和文件夹结构:
配置结构
当默认的项目结构不适用的时候,你可能需要去自定义配置它。根据Gradle文档,重新为Java项目配置sourceSets可以使用以下方法:
sourceSets { main { java { srcDir 'src/java' } resources { srcDir 'src/resources' } } }
当然,也可以使用如下的配置方式:
sourceSets { main.java.srcDirs = ['src/java'] main.resources.srcDirs = ['src/resources'] }
Android Plugin使用的是类似的语法。但是由于它使用的是自己的sourceSets,这些配置将会被添加在android对象中。
以下是一个示例,它使用了旧项目结构中的main源码,并且将androidTestsourceSet组件重新映射到tests文件夹。
android { sourceSets { main { manifest.srcFile 'AndroidManifest.xml' java.srcDirs = ['src'] resources.srcDirs = ['src'] aidl.srcDirs = ['src'] renderscript.srcDirs = ['src'] res.srcDirs = ['res'] assets.srcDirs = ['assets'] } androidTest.setRoot('tests') } }