Android中使用Gradle来构建App项目的入门指南
gradle是Android开发中引入的全新的构建系统,因为全新的构建系统主要是出于下面的目的:
1.方便复用代码和资源
2.构建多种版本的apk更见简单,不论是为多渠道构建不同的apk还是构建不同环境的apk(debug,release)
3.方便配置,扩展,自定义构建过程
4.良好的IDE集成
为什么选择Gradle?
Gradle主要有以下几个有点:
1.使用领域驱动语言(DSL)来描述构建逻辑
2.构建脚本使用Groovy,可以方便的定制构建逻辑
3.内建的依赖管理系统,使用Maven或者Ivy
4.非常灵活。可以使用最佳实践但并不强制
5.良好的IDE支持
Gradle项目使用项目根目录下的build.gradle文件来配置
一个最简单的Java项目的build.gradle如下
applyplugin:'java'
这表示改项目会使用Gradle的java插件,该插件是Gradle默认提供的,java插件提供了构建java应用和运行测试的功能。
最简单的Android项目build.gralde
buildscript{ repositories{ mavenCentral() } dependencies{ classpath'com.android.tools.build:gradle:0.11.1' } } applyplugin:'android' android{ compileSdkVersion19 buildToolsVersion"19.0.0" }
该Android构建文件包含3个部分:
1.buildscript{...}配置驱动构建过程的代码,意思就是buildscript中的配置仅仅在构建过程中起作用,也就是构建程序所使用的配置。
上面的代码中就声明了我们的构建程序会使用Maven中央仓库,并且有一个classpath依赖是指向一个Maven库的。这个Maven库就是AndroidGradle插件,版本号是0.11.1。
2.随后就是使用这个Android插件,和之前使用Java插件一样。
3.最后,android{...}配置了Android项目构建时需要的所有参数。
默认情况下,只需要指定compileSdkVersion和buildtoolsVersion,compileSdkVersion指定使用哪个版本的sdk编译,buildToolsVersion指定使用哪个版本的构建工具。
注意点:
1.只需要使用android插件,再使用Java插件会报错.
2.在local.properties中使用sdk.dir属性指定SDK路径,或者你可以使用ANDROID_HOME环境变量。
项目结构
Gradle采用约定优于配置的原则,最简单方式是使用一个默认的目录结构。当然目录结构是可以自己修改的。
默认情况下,androidgradle项目的代码都在src目录下,src下会有两个目录main和androidTest,其中main目录下是项目代码,androidTest目录下是测试代码。
src/main/ src/androidTest/
在main和androidTest目录下面,针对不同类型的code,又不会不同的目录。
对于Java和Android的Gradle插件,Java代码和Java资源分别对应了java目录和resources目录。Android插件还需要一些其他的目录和文件,比如
AndroidManifest.xml res/ assets/ aidl/ rs/ jni/
下面我们来看一下如何更改这些默认的配置。
Android工程,默认情况下,java文件和resource文件分别在src/main/java和src/main/res目录下,在build.gradle文件,andorid{}里面添加下面的代码,便可以将java文件和resource文件放到src/java和src/resources目录下。(注意,如果你在gradle文件中修改了,只需要重新sync一下,gradle会自动创建新的目录,并将对应的文件移动到新的目录下)
sourceSets{ main{ java{ srcDir'src/java' } resources{ srcDir'src/resources' } } }
更简便的写法是
sourceSets{ main.java.srcDirs=['src/java'] main.resources.srcDirs=['src/resources'] }
数组里其实是可以指定多个目录,这样就可以将代码和资源放置到多个目录下。
在看一个Android项目的例子:
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') } }
这里的maincode其实使用的就是AndroidGradle的默认值,而androidTest不再使用默认的androidTest目录,而是使用tests目录。