android gradle初探

上次提到gradle很神奇，它可以直接下载远程依赖库，然后就先放一边了，最近由于一直在写界面，比较枯燥，而且有些自定义控件让我十分头疼，就去看了一下gradle的教程，了解一下gradle的作用。

网上说：gradle是一个基于Apache Ant和Apache Maven概念的项目自动化建构工具。它使用一种基于Groovy的特定领域语言来声明项目设置，而不是传统的XML。 
gradle能够完成构建、测试、发布和其他诸如软件打包、生成注释文档等等功能。

那我们就来看看花果山项目中是怎样使用gradle的。

一. FruitAndroid\gradle\wrapper\gradle-wrapper.properties，这是gradle的配置文件

#Wed Apr 10 15:27:10 PDT 2013
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-2.2.1-all.zip

里面声明了gradle的目录与下载路径以及当前项目使用的gradle版本，有了这个配置文件，我们就能在项目根目录执行gradlew命令，仅针对该项目执行的gradle命令，而不必使用全局的gradle命令

二. FruitAndroid\settings.gradle，整个project的配置文件，声明一些需要加入gradle的module

include ':app'
include ':umeng_social_sdk'

因为整个project中总共有两个module，一个是app本身，还有一个是友盟的sdk，所以有两个

三.FruitAndroid\build.gradle，整个project的build.gradle文件

<pre name="code" class="java">// Top-level build file where you can add configuration options common to all sub-projects/modules.
//上面那句意思是在此处添加的是整个project的配置，此project下所有的子modules和子project都将受影响
buildscript { //buildscript中的声明是gradle脚本自身需要使用的资源
    repositories {
        jcenter() //声明中央远程仓库为jcenter
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.2.3' //声明android gradle plugin版本
    }
}
allprojects { //针对项目自身所有project的配置
    repositories { //添加依赖，在加入Maven仓库时，Gradle提供了三种“别名”，jcenter,mavenCentral和mavenLocal
        maven { url "http://dl.bintray.com/populov/maven" } //这两个是maven远程仓库的url地址
        maven { url "https://oss.sonatype.org/content/repositories/snapshots/" }
        jcenter() //jcenter()别名，表示依赖是从Bintary’s JCenter Maven 仓库中获取的
        mavenCentral() //mavenCentral()别名，表示依赖是从Central Maven 2 仓库中获取的
        mavenLocal(); //mavenLocal()别名，表示依赖是从本地的Maven仓库中获取的
    }
}

四.FruitAndroid\app\build.gradle，最重要的部分，独立module的build.gradle文件，即项目的build.gradle文件

</pre><pre>

apply plugin: 'com.android.application' //声明是android程序

android {
	compileSdkVersion Integer.parseInt(project.COMPILE_SDK_VERSION) //编译sdk版本
	buildToolsVersion project.BUILD_TOOLS_VERSION //buildTools版本

	defaultConfig { //默认配置
		applicationId "com.huaguoshan.app" //应用包名
		minSdkVersion Integer.parseInt(project.MIN_SDK_VERSION) //兼容最小sdk版本
		targetSdkVersion Integer.parseInt(project.TARGET_SDK_VERSION) //目标sdk版本
		versionCode 10 //版本号，对消费者不可见，仅用于应用市场、程序内部识别版本，判断新旧等用途
		versionName "1.0.10" //版本号，展示给消费者，消费者会通过它认知自己安装的版本
	}
	signingConfigs { //应用程序签名配置
		release { //release版本
			storeFile file("huaguoshan_release.jks")  //签名文件存放路径
			storePassword "uaUMG7ZTmnn6"
			keyAlias "huaguoshan"
			keyPassword "uaUMG7ZTmnn6"
		}
// debug {
// storeFile file("release.jks")
// storePassword "PKZ6cez8mGsLLW"
// keyAlias "KFUN"
// keyPassword "PKZ6cez8mGsLLW"
// }
	}
	buildTypes {
		release {
			minifyEnabled false //是否进行混淆
			proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' //混淆文件位置
			signingConfig signingConfigs.release //指定签名配置
// applicationVariants.all { variant ->
// variant.outputs.each { output ->
// def outputFile = output.outputFile
// if (outputFile != null && outputFile.name.endsWith('.apk')) {
// def date = new Date()
// def formattedDate = date.format('yyyyMMdd')
// def fileName = outputFile.name.replace('.apk', "-${formattedDate}-v${versionName}.apk")
// output.outputFile = new File(outputFile.parent, fileName)
// }
// }
// }
		}
	}
	packagingOptions { //打包配置
		exclude 'META-INF/DEPENDENCIES.txt' //排除一些文件
		exclude 'META-INF/dependencies.txt'
		exclude 'META-INF/DEPENDENCIES'
		exclude 'META-INF/LICENSE.txt'
		exclude 'META-INF/license.txt'
		exclude 'META-INF/LICENSE'
		exclude 'META-INF/NOTICE.txt'
		exclude 'META-INF/notice.txt'
		exclude 'META-INF/NOTICE'
		exclude 'META-INF/LGPL2.1'
		exclude 'META-INF/ASL2.0'
		exclude 'AndroidManifest.xml'
	}
	productFlavors { //多渠道打包，此处的channel来自AndroidManifest里的友盟配置信息
FIRIM { manifestPlaceholders = [channel: "FIRIM"] }
// GooglePlay { manifestPlaceholders = [channel: "GooglePlay"] }
// App360 { manifestPlaceholders = [channel: "App360"] }
// QQ { manifestPlaceholders = [channel: "QQ"] }
// Xiaomi { manifestPlaceholders = [channel: "Xiaomi"] }
// Wandoujia { manifestPlaceholders = [channel: "Wandoujia"] }
// Baidu { manifestPlaceholders = [channel: "Baidu"] }
// Meizu { manifestPlaceholders = [channel: "Meizu"] }
// PGYER { manifestPlaceholders = [channel: "PGYER"] }
	}
	compileOptions { //java版本
		sourceCompatibility JavaVersion.VERSION_1_7
		targetCompatibility JavaVersion.VERSION_1_7
	}
	lintOptions { // 移除lint检查的error，打包时不因为出错中断
		abortOnError false
	}
}

dependencies { //项目依赖配置
compile fileTree(dir: 'libs', include: ['*.jar']) //引入所有libs文件夹中的jar包
	compile 'com.android.support:support-v4:22.0.0'
	compile 'com.android.support:appcompat-v7:22.0.0'
	compile 'cn.blankapp:library:1.0@aar' //以下均为远程maven项目
	compile 'com.alibaba:fastjson:1.1.45.android'
	compile 'com.orhanobut:logger:1.4'
	compile 'in.srain.cube:ultra-ptr:1.0.8.4-SNAPSHOT@aar'
	compile 'com.michaelpardo:activeandroid:3.1.0-SNAPSHOT'
	compile 'de.greenrobot:eventbus:2.4.0'
	compile 'com.squareup.retrofit:retrofit:1.9.0'
	compile 'com.squareup.okhttp:okhttp:2.2.0'
	compile 'com.squareup.okhttp:okhttp-urlconnection:2.2.0'
	compile 'com.viewpagerindicator:library:2.4.1@aar'
	compile 'com.nostra13.universalimageloader:universal-image-loader:1.9.3'
	compile 'com.makeramen:roundedimageview:2.0.0'
	compile 'com.nineoldandroids:library:2.4.0'
	compile 'com.tonicartos:stickygridheaders:1.0.1'
	compile project(':umeng_social_sdk') //友盟sdk
}

流程走了一遍，但是很明显，以后自己写这些估计一时半会儿也写不出来，哪些配置是必须的，哪些配置是额外添加的，似乎还不够清晰。