转自:http://blog.csdn.net/changemyself/article/details/39927381
一、前言
Gradle 是以 Groovy 语言为基础,面向Java应用为主。基于DSL(领域特定语言)语法的自动化构建工具。
上面这句话我觉得写得很官方,大家只需知道Gradle可以用来android开发中进行多个项目依赖的自动化编译脚本,知道这点也就知道我们使用它的目的;
为什么不使用Ant做自动化编译脚本,因为ant上手快,但是维护起来太不方便了,有了Gradle你可以跟项目组的同事说,用Ant的孩子们别苦逼的维护了,赶紧换成gradle吧。
本文面向gradle新手或者以前使用过gradle低版本的朋友,因为我感觉每次gradle升级那个脚本也有些坑爹,有些api就废弃掉了,不过总体感觉每次升级都让这个工具更加严谨话,易用话了。
二、Demo描述
下面我就简单写一个demo,通过这个demo程序让大家如何快速上手,比较实用的一个实例:
demo程序分为2个工程,你可以直接实用eclipse新建一个android工程,其实我也是这么干的,这样一来大家仔细看下图
这里顺便强调一下demo工程的环境配置:(很重要,否则下面被我坑了别怪我提起没跟你说)
jdk:C:\Program Files\Java\jdk1.8.0_20(注意:不要使用jre,gradle会提示你使用jdk的)
否则脚本会提示以下错误:
* What went wrong:Execution failed for task ':appcompat_v7:compileReleaseJava'.> Cannot find System Java Compiler. Ensure that you have installed a JDK (not just a JRE) and configured your JAVA_HOMEsystem variable to point to the according directory.
android-sdk:D:\dev\adt-bundle-windows-x86-20140702
android-api: 20, android4.4W(注意:做android开发你每次都是用最新的api编译是一个好习惯)
gradle:2.1,(使用最新的版本,no zuo no die,被坑不断,欢乐不断)
gradle的下载地址:http://www.gradle.org/documentation ,大家可以看看文档,当然你的E文好的话,会容易上手,不过没关系,看了我写的文章你gradle的文档你可以不看了,因为很多东西你用不上,除非你项目中使用了特别复杂的功能
gradle2.1的api文档:http://www.gradle.org/docs/current/javadoc/org/gradle/api/Project.html ,这个需要你偶尔翻翻,因为简单功能会用上的
环境变量配置:
JAVA_HOME,GRADLE_HOME都要添加到环境变量里
当然了path变量里你也要加上 JAVA_HOME/bin,和GRADLE_HOME/bin,这样下面你开一个CMD命令行,才可以方面使用gradle build命令
好了准备工作完成后,我们就开始正式讲讲这个demo工程了
TestDemo工程就写了一个activity,显示hello world!
Appcompatv7工程大家懂得一个library,很有代表性,我们实际项目中会用到多个library,你可以举一反三了。
下面看看目录文件:
你想运行编译脚本,需要2个配置文件,local.properties和settings.gradle
settings.gradle里的代码内容:
include ':appcompat_v7', ':TestDemo'
这里面可以看到是project的描述,如果你有多个工程如论主工程还是引用的库工程,都需要在这里面声明,否则gradle找不到
local.properties里的代码内容:
sdk.dir=D:\\dev\\adt-bundle-windows-x86-20140702\\sdk
这里面可以看到是android sdk的目录,自己填好,否则也会报错。
好了下面讲讲每个工程里面都需要配置一个build.gradle 文件
appcompat_v7工程的build.gradle:
buildscript{ repositories{ mavenCentral(); } dependencies{ classpath 'com.android.tools.build:gradle:0.13.+' } tasks.withType(JavaCompile) { options.encoding = "UTF-8" }}apply plugin:'android-library'dependencies{ compile fileTree(dir:'libs',include:"*.jar")}android{ compileSdkVersion 20 buildToolsVersion "20" enforceUniquePackageName=false lintOptions{ abortOnError false } sourceSets{ main{ manifest.srcFile 'AndroidManifest.xml' java.srcDirs = ['src'] resources.srcDirs = ['src'] aidl.srcDirs = ['src'] renderscript.srcDirs = ['src'] res.srcDirs = ['res'] assets.srcDirs = ['assets'] } } lintOptions{ abortOnError false }}
对于这个文件我需要强调几点:
1、classpath 'com.android.tools.build:gradle:0.13.+' ,很多人用了低版本出了问题写什么0.11+,我不管,你要使用gradle2.1版本,这里就写成1.13+包你没错。
2、apply plugin:'android-library',说明这个一个库工程,详细自己找资料脑补
3、tasks.withType(JavaCompile) { options.encoding = "UTF-8" } ,task是个啥自己查去,这里编译encoding配成UTF-8,还有一点在低版本脚本有的人写成tasks.withType(Compile) ,这样子报错了,改成JavaCompile吧,我是一点一点排错的
4、android{
compileSdkVersion 20 buildToolsVersion "20"这里面version写20,为啥?上面你看看我的android-sdk api的版本就知道了,写成别的也可以,你要保证你本地androidsdk都有。
TestDemo工程里的几个文件:
build目录:是gradle执行编译时候生成的,里面好多内容,有兴趣自己翻翻看
output目录:我写得脚本,最后把build里的apk自动copy到这个目录,这个可以具体看脚本
blue_key:apk签名文件
build.gradle:你懂得
TestDemo工程里面的build.gradle
import java.util.regex.Pattern//import com.android.builder.DefaultManifestParserimport com.android.builder.core.DefaultManifestParserbuildscript{ repositories{ mavenCentral() } dependencies{ classpath 'com.android.tools.build:gradle:0.13.+' } /*** tasks.withType(Compile){ options.encoding = "UTF-8" } **/ tasks.withType(JavaCompile) { options.encoding = "UTF-8" }}apply plugin:'android'dependencies{ compile fileTree(dir:"libs",include:'*.jar') compile project(':appcompat_v7')}android{ compileSdkVersion 20 buildToolsVersion "20" enforceUniquePackageName=false defaultConfig{ targetSdkVersion 17; } lintOptions{ abortOnError false } dexOptions { preDexLibraries = false } packagingOptions { exclude 'META-INF/DEPENDENCIES.txt' exclude 'META-INF/LICENSE.txt' exclude 'META-INF/NOTICE.txt' exclude 'META-INF/NOTICE' exclude 'META-INF/LICENSE' exclude 'META-INF/DEPENDENCIES' exclude 'META-INF/notice.txt' exclude 'META-INF/license.txt' exclude 'META-INF/dependencies.txt' exclude 'META-INF/LGPL2.1' exclude 'META-INF/ASL2.0' } signingConfigs{ myConfig{ storeFile file("bluekey") storePassword "blue" keyAlias "blue" keyPassword "blue" } } buildTypes{ release{ runProguard true //打开混淆开关 proguardFile 'proguard.txt.txt' //配置单个文件这样 signingConfigs.myConfig } } sourceSets{ main{ manifest.srcFile 'AndroidManifest.xml' java.srcDirs = ['src'] resources.srcDirs = ['src'] aidl.srcDirs = ['src'] //rendersrcDirs = ['src'] res.srcDirs = ['res'] assets.srcDirs = ['assets'] } } task copyNativeLibs(type: Copy) { from(new File(project(':appcompat_v7').getProjectDir(), 'libs')) { include '**/*.so' } into new File(buildDir, 'native-libs') } tasks.withType(JavaCompile){ compileTask -> compileTask.dependsOn copyNativeLibs } clean.dependsOn 'cleanCopyNativeLibs' tasks.withType( com.android.build.gradle.tasks.PackageApplication){ pkgTask -> pkgTask.jniFolders = new HashSet() pkgTask.jniFolders.add(new File(buildDir,'native-libs')) } }build.doLast { def today = new Date().format('yyMMdd'); copy{ //from('build/apk') from('build/outputs/apk') into('output') include('TestDemo-debug.apk') rename('TestDemo-debug.apk','blue-'+today+'-'+readVersion()+'-demo.apk') }} /** *从Manifest.xml中读取版本号 **/ def readVersion(){ def manifestParser = new DefaultManifestParser() return manifestParser.getVersionName(android.sourceSets.main.manifest.srcFile); }
对于这个文件我需要强调几点(很重要):
1、//import com.android.builder.DefaultManifestParser
import com.android.builder.core.DefaultManifestParser//注释掉的代码是低版本的写法,目前使用最新api
2、 /***
tasks.withType(Compile){ options.encoding = "UTF-8" } **/ tasks.withType(JavaCompile) { options.encoding = "UTF-8" }//注释掉的代码是低版本的写法,目前使用最新api
3、
dependencies{
compile fileTree(dir:"libs",include:'*.jar') compile project(':appcompat_v7')}编译依赖,我们可以看到依赖的库 appcompat_v7要写在这里,注意":"(冒号一定要写)
4、
signingConfigs{ myConfig{ storeFile file("bluekey") storePassword "blue" keyAlias "blue" keyPassword "blue" } } buildTypes{ release{ signingConfigs.myConfig } }编译时候签名文件配置,当然你也可以编译出debug和没有签名的apk,自行查资料去
5、
task copyNativeLibs(type: Copy) {
from(new File(project(':appcompat_v7').getProjectDir(), 'libs')) { include '**/*.so' } into new File(buildDir, 'native-libs') } tasks.withType(JavaCompile){ compileTask -> compileTask.dependsOn copyNativeLibs }关于依赖的so文件和jar文件,在编译之前copy依赖到主工程的native-libs目录
6、build.doLast {
def today = new Date().format('yyMMdd'); copy{ //from('build/apk') from('build/outputs/apk') into('output') include('TestDemo-debug.apk') rename('TestDemo-debug.apk','blue-'+today+'-'+readVersion()+'-demo.apk') }}/** *从Manifest.xml中读取版本号 **/ def readVersion(){ def manifestParser = new DefaultManifestParser() return manifestParser.getVersionName(android.sourceSets.main.manifest.srcFile); }build.doLast,就是最后执行的意思,关于gradle task大家需要简单查资料掌握即可。
这里面需要注意的:
def today = new Date().format('yyMMdd');
def manifestParser = new DefaultManifestParser()
都需要def声明变量,低版本不用写的,但是目前不写就要报错了。
这个代码的功能:就是从Manifest文件里读出versioncode然后结合当前日期重新命名output里的apk文件。
方便吧,很实用的一点。
7、apply plugin:'android'
这说明这个脚本需要编译的是一个 android工程,跟上面的library是不是有所不同呢? gradle还支持java project的编译,大家自行查资料。
三、编译执行:
下面我们打开cmd命令窗口进行编译操作
在TestDemo目录执行gradle build,因为这里是local.properties和settings.gradle 所在的根目录。
第一次执行时候,gradle根据依赖去下载所需要的jar包,会在你每个工程里创建一个.gradle目录
dependencies{
classpath 'com.android.tools.build:gradle:0.13.+' }下载成功后
ok,那我们开始执行编译操作了,gradle build
编译正常的话会提示 BUILD SUCCESSFUL,然后自己去output目录找apk去。
这里提醒大家一个jar冲突会引起编译中断的问题:
因为很多朋友的project的libs目录有多个android-support-v4.jar导致的。
最后啰嗦
四、参考资料:
After upgrading to Gradle 2.0: Could not find property 'Compile' on root project
Unable to resolve class in build.gradle using Android Studio 0.60/Gradle 0.11 How to configure build.gradle files of an existing project with actionbarsherlock lib?Multiple settings gradle files for multiple projects building
Android Tools Project Site
demo下载地址:
gradle2.1demo教程(多评论哈)