
为什么要用Gradle?
Gradle是比较先进的构建系统,也是一个很好的构建工具,允许通过插件自定义构建逻辑
以下是为什么Android Studio选择Gradle的主要原因:
使用领域专用语言(Domain Specific Language)来描述和处理构建逻辑。(以下简称DSL)
基于Groovy。DSL可以混合各种声明元素,用代码 *** 控这些DSL元素达到逻辑自定义。
支持已有的Maven或者Ivy仓库基础建设
非常灵活,允许使用best practices,并不强制让你遵照它的原则来。
其它插件时可以暴露自己的DSL和API来让Gradle构建文件使用。
允许IDE集成,是很好的API工具
需要准备:
Gradle 1.6 or 1.7
SDK with Build Tools 17.0.0 (released 5/16/2013)
Basic Project
在Gradle项目的根目录下,有个叫build.gradle的文件,它描述了这个项目的整体构建基础。
build文件
最基本的java程序,它的build.gradle文件就一句话:
apply plugin: 'java'
最基本的Android项目,它的build.gradle如下:
buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:0.5.6'
}
}
apply plugin: 'android'
android {
compileSdkVersion 17
}
我们一步步来分析一下上面三部分的内容。
buildscript{...} 配置了驱动build的代码,它声明将在Maven中央仓库,取一个classpath dependency,也就是Android plugin for Gradle v0.5.6
apply plugin 指明了用到的plugin是android,就像前面java程序中,用的plugin是java一样
android{...} 中配置了所有android构建的参数,这里也就是Android DSL的入口点。
默认的,只有目标编译环境是必要的,也就是compileSdkVersion这个属性。这和以前在project.properties中的target属性类似。
值得注意的是,如果你在Android项目中写 apply plugin:java 而不是apply plugin:android的话,将会build失败。
usercenter包含两个工程,app是web工程,common是公共模块,但是app的main目录下除了java、resources、webapp之外又多了一个native2ascii的资源目录,严格来说这不符合maven约定,不过没关系,gradle除了支持maven的约定外还允许自定义java或者resources目录下面是gradle主配置文件(删除了大部分无关紧要的依赖,能说明问题即可)
<!-- lang: groovy -->
// gradle插件
buildscript {
repositories {
jcenter { url "/" }
}
dependencies {
// 远程布署插件
classpath 'org.hidetake:gradle-ssh-plugin:1.0.1'
// web容器,支持jetty和tomcat
classpath 'org.akhikhl.gretty:gretty:1.2.0'
}
}
// 全局配置,对所有工程有效
allprojects {
apply plugin: "java"
apply plugin: "idea"
apply plugin: "eclipse"
apply plugin: "maven"
group = "com.test"
version = "1.0"
// 全局属性设置
ext {
junitVersion = "4.11"
springVersion = "3.0.5.RELEASE"
// java文件编码方式设置为utf-8
compileJava.options.encoding = 'UTF-8'
compileTestJava.options.encoding = 'UTF-8'
}
}
// 所有子工程共有的配置
subprojects {
// 配置多个maven源
repositories {
mavenLocal()
mavenCentral()
maven { url "/pub/mirrors/maven2" }
}
// 默认情况下gradle会选用版本最高的那个依赖,有时候会带来问题
configurations.all {
// 有版本冲突的时候强制使用指定的版本,对于相关依赖也同样有效
resolutionStrategy.force(
"org.springframework:spring-core:${springVersion}",
)
}
// 公共依赖配置
dependencies {
compile(
"org.springframework:spring-core:${springVersion}",
)
testCompile(
"junit:junit:${junitVersion}",
)
}
}
// app工程配置
project(':app'){
apply plugin: 'war'
apply from: 'gretty'
// 使用gretty插件运行web工程
gretty {
httpPort = 8080
debugPort = httpPort + 1
servicePort = httpPort + 2
statusPort = httpPort + 3
httpsPort = httpPort + 4
httpsEnabled = true
contextPath = '/'
jvmArgs = ['-Xmx1024M', '-XX:PermSize=128M', '-XX:MaxPermSize=256M']
servletContainer = 'jetty7'
scanInterval = 0
inplaceMode = 'hard'
debugSuspend = false
}
// 自定义resource文件夹
sourceSets {
main {
resources.srcDirs = ['src/main/resources', 'src/main/native2ascii']
}
}
dependencies {
compile(
// 依赖common工程
project(":common"),
"javax.servlet.jsp:jsp-api:2.1",
"javax.servlet:servlet-api:2.5",
)
}
}
// common工程配置
project(':common'){
// 设置resource文件目录,引入java文件夹下的xml文件
sourceSets {
main {
resources.srcDirs = ['src/main/resources', 'src/main/java']
resources.includes = ['src/main/java/**.xml']
}
}
dependencies {
compile(
"org.mongodb:mongo-java-driver:2.10.1",
fileTree(dir: 'lib' , include: '*.jar' )
)
}
}
settings.gradle中记录子工程,内容只有一行
include 'app','common'
可以把gradle配置写到多个文件夹下,每个子工程都下都新建一个build.gradle,如果工程比较简单,也可以像上面样,所有子工程的配置都写到主工程的build.gradle中
运行的时候只需要在主工程的目录下执行一个命令即可
Gradle是可以用于Android开发的新一代的 Build System, 也是 Android Studio默认的build工具。Gradle脚本是基于一种JVM语言 -- Groovy,再加上DSL(领域特定语言)组成的。
因为Groovy是JVM语言,所以可以使用大部分的Java语言库。所谓DSL就是专门针对Android开发的插件,比如标准Gradle之外的一些新的方法(Method)、闭包(Closure)等。
由于Gradle的语法足够简洁,而且可以使用大部分的java包,当之无愧地成为新一代 Build System。
使用Android Studio新建一个工程后,默认会生成两个build.gralde文件,一个位于工程根目录,一个位于app目录下。还有另外一个文件 --settings.gradle。
根目录下的脚本文件是针对module的全局配置,它的作用阈所包含的所有 module 是通过settings.gradle来配置。
app文件夹就是一个module,如果在当前工程中添加了一个新的module -- lib,就需要在settings.gralde文件中包含这个新的module。
gradle脚本的基本结构
用我现在的工程举例来说,根目录的build.gradle的内容如下所示:
// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:1.0.0-rc4'
// NOTE: Do not place your application dependencies herethey belong
// in the individual module build.gradle files
}
}
allprojects {
repositories {
jcenter()
maven {
url 'http://mvnrepo.xxx.com/mvn/repository'
}
}
}
classpath 'com.android.tools.build:gradle:1.0.0-rc4'就是Android特有的插件,maven仓库位于通过方法jCenter() 获取,这也是默认的maven仓库。当然也可以添加额外的maven仓库地址,例如以上文件中的
maven {
url 'http://mvnrepo.xxx.com/mvn/repository'
}
然后是 settings.gradle 文件:
include ':app'
app就是项目包含的一个module,如果有多个module,可以在为 include 方法添加多个参数。
最后是app/build.gradle
apply plugin: 'com.android.application'
android {
compileSdkVersion 21
buildToolsVersion "21.1.1"
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_7
targetCompatibility JavaVersion.VERSION_1_7
}
defaultConfig {
applicationId "your.application.id"
minSdkVersion 14
targetSdkVersion 21
versionCode 2
versionName "2.0.0"
}
signingConfigs {
release {
storeFile file('release.keystore')
storePassword "yourstorepassword"
keyAlias "yourkeyalias"
keyPassword "yourkeypassword"
}
debug {
storeFile file('debug.keystore')
}
}
buildTypes {
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
signingConfig signingConfigs.release
}
debug {
signingConfig signingConfigs.debug
}
}
productFlavors {
inner {
applicationId "your.application.inner.id"
versionName "2.0.0"
}
market {
}
}
}
repositories {
flatDir {
dirs 'libs'
}
}
dependencies {
// 通用
compile name: 'volley', ext: 'aar'
compile 'com.nostra13.universalimageloader:universal-image-loader:1.9.3'
compile 'com.alibaba:fastjson:latest.integration'
// 项目相关(已删除)
}
Groovy 的基本语法
方法调用
apply plugin: 'com.android.application'
以上语句中的apply是一个方法,给它传递了一个参数plugin,plugin 的值是'com.android.application'。
如果有多个参数,则以逗号隔开,例如
compile name: 'volley', ext: 'aar'
闭包
Groovy中花括号包含的部分成为一个闭包(Closure)。例如下面的代码
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_7
targetCompatibility JavaVersion.VERSION_1_7
}
compileOptions 是一个 Method, 它的参数是一个闭包,这个闭包内依次执行了两个方法 -- sourceCompatibility 和targetCompatibility, 参数都是JavaVersion.VERSION17。
闭包也可以嵌套包含
repositories {
flatDir {
dirs 'libs'
}
}
常见使用方法
包依赖(aar)
使用aar时可以分为两种情况
① aar位于本地目录
首先在 android 的参数闭包中添加调用方法 repositories
repositories {
flatDir {
dirs 'libs'
}
}
然后在 dependencies 的参数闭包中添加
compile name: 'volley', ext: 'aar'
② aar位于远程仓库
这里以maven为例,当然也可以使用其他类型的仓库,例如 Ivy。
只需要在jar包引用方式后面添加一个@aar就可以了
compile 'com.alibaba:fastjson:latest.integration@aar'
包依赖(jar)
compile group: 'com.alibaba', module: 'fastjson', version: 'latest.integration'
可以简写成
compile 'com.alibaba:fastjson:latest.integration'
latest.integration可以替换成具体的版本号,这里是获取服务器上的最新版本。
去掉重复依赖
compile 'com.alibaba.fastjson.latest.integration' {
exclude module: 'annotations', group: 'com.google.android'
}
使用 Java7
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_7
targetCompatibility JavaVersion.VERSION_1_7
}
productFlavors
针对不同的APP分发渠道,我们可以定义不同的 product flavor。也可以定义内部版本和外部版本,内部版本中包含了一些调试代码,这些代码在发布时并不会被编译进最后的APP中。而且可以分别为内部版本和外部版本指定不同的ApplicationId,这样在同一个设备上可以同时安装两个版本以方便调试。
命令行执行Gradle脚本
在Android工程根目录下会自动生成一个shell脚本 - gradlew,执行之前记得加上x属性 - chomod +x gradlew
gradle脚本中包含了很多 task,可以通过task名来指定需要执行的task。
./gradlew build./gradlew assemble./gradlew assembleInnderDebug
总结
不得不说,Gradle实在太好用了!虽然 Gradle 可以与 Ant 或 maven 配合使用,但是其简洁和功能性远远超过其他两个。我现在开发的项目普遍使用的是 maven,不知道什么原因,使用Gradle时经常会遇到一些无法获取远程依赖包的问题,最简单的解决办法就是把依赖包下载的本地。
欢迎分享,转载请注明来源:内存溢出
微信扫一扫
支付宝扫一扫
评论列表(0条)