Android Gradle 新手入门

1.  什么是Gradle?

Gradle 是一个基于Ant和Maven概念的项目自动化建构工具。

2.  Gradle 基本概念

下图是很基本的Android Gradle工程,目录结构也是正常的Gradle工程的样式。下载地址

2.1  StudyGradle/build.gradle(图标1)

这个文件是整个项目的gradle基础配置文件:

buildscript {// 脚步运行环境

repositories {// 用于项目依赖

// 中央远程仓库

jcenter()

}

dependencies {

// gradle版本

classpath'com.android.tools.build:gradle:1.2.3'

// NOTE: Do not place your application dependencies here; they belong

// in the individual module build.gradle files

}

}

allprojects {

repositories {

jcenter()

}

}

这里主要描述了两个方面:

1. gradle 版本

2. 仓库的源地址

2.2  StudyGradle/app/build.gradle(图标2)

这个文件是Module名称为app的gradle的配置文件,在此项目中是主要的gradle配置文件。

//声明插件类型,这里声明的是Android程序

apply plugin:'com.android.application'

android {

//编译SDK的版本

compileSdkVersion22

//build tools 的版本 对应Android SDK Build-tools

buildToolsVersion"21.1.2"

defaultConfig {

//应用包名

applicationId"com.example.dpt.studygradledemo"

minSdkVersion21

targetSdkVersion22

versionCode1

versionName"1.0"

}

buildTypes {//构建类型,常用的有release和debug两种,可以在这里面启用混淆,启用zipAlign以及配置签名信息等

release {

//是否进行混淆

minifyEnabled false

//混淆文件位置

proguardFiles getDefaultProguardFile('proguard-android.txt'),'proguard-rules.pro'

}

}

// 移除lint检查的error

lintOptions {

abortOnError false

}

}

dependencies {

// 编译依赖libs目录下的所有jar包

compile fileTree(dir:'libs', include: ['*.jar'])

// //应用格式: packageName:artifactId:version

// 依赖 support-v4

compile'com.android.support:support-v4:22.2.0'

// 依赖 card view

compile'com.android.support:cardview-v7:22.2.0'

// 依赖 library module

compile project(':demolibrary')

compile'com.android.support:palette-v7:22.2.0'

}

ps:

1. 开头第一行apply plugin: ‘com.android.application’,这表示该module是一个app module,应用了com.android.application插件,如果是一个android library,那么这里的是apply plugin: ‘com.android.library’。'com.android.application'是较新的写法,但不是最新的写法。

2. buildToolsVersion 对应Android SDK Build-tools的版本,如图


2.2.1  buildTypes{}

buildTypes是构建类型,常用的有release和debug两种,可以在这里面启用混淆,启用zipAlign以及配置签名信息等。


2.2.2  defaultConfig{}

这里描述的是一些项目基础默认配置

常用的属性有:versionCode,versionName,minSdkVersion,targetSdkVersion,applicationId等


2.2.3  dependencies{}

dependencies就不属于Android专有的配置了,它定义了该module需要依赖的jar,aar,jcenter库信息。

1. compile fileTree(dir: 'libs', include: ['*.jar']) 编译依赖libs目录下的所有jar包

2. compile 'com.android.support:support-v4:22.2.0' 依赖 support-v4

3. compile project(':demolibrary') 依赖其他module

ps:

其中依赖开源组件的格式为:packageName:artifactId:version 例如,compile 'com.android.support:support-v4:22.2.0'

StudyGradle/demolibrary/build.gradle(图标2)

这个是一个依赖库的module配置文件

//声明Android library

apply plugin:'com.android.library'

android {

//编译SDK版本

compileSdkVersion22

//build tools 的版本 对应Android SDK Build-tools

buildToolsVersion"21.1.2"

defaultConfig {

minSdkVersion21

targetSdkVersion22

versionCode1

versionName"1.0"

}

buildTypes {

release {

minifyEnabled false

proguardFiles getDefaultProguardFile('proguard-android.txt'),'proguard-rules.pro'

}

}

}

dependencies {

compile fileTree(dir:'libs', include: ['*.jar'])

}

ps:

1. 这里需要注意的是apply plugin 这里声明为Android library

2.3  StudyGradle/build.gradle(图标3)

这个文件是全局的项目配置文件,里面主要声明一些需要加入gradle的module

include':app',':demolibrary'

2.4  Gradle Wrapper(图标4)

android studio希望你能在电脑上不安装gradle的情况下,依然使用gradle管理android项目,因此通过AS创建的每个项目都会内嵌一个gradle wrapper,作用是检查你当前的共工作环境是否安装了创建本项目时所用的gradle版本。

如果没有,它会自动下载相应的gradle放在~/.gradle/wrapper.目录下。这样当你在你的项目里使用gradle时,可以通过gradlw命令使用当前项目环境的gradle版本,而不受环境变量的影响。

很多人会遇到一个项目build很久,很大一部分原因就是因为这个,他会去下载自带的gradle wrapper,50多M,大部分情况下需要翻墙

如果不能翻墙,也可以更改**gradle-wrapper.properties**的配置

1

2

3

4

5distributionBase=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

3. 打包

3.1 Gradle Flavor

写项目的时候经常会遇到以下的情况:

1. 需要生成测试版本和正式版本的apk

2. 测试版本和正式版本的URL是不一样的

3. 测试版本和正式版本的包名需要不一致,这样才能安装到同一部手机上面。

4. 不同apk需要应用名不同,图标不同,某些常量不同....

>通过Productflavor你可以配置此flavor对应的包名,签名信息,版本名, 版本号等,具体可配置项可以到这里[查看](http://apdr.qiniudn.com/com.android.build.gradle.internal.dsl.ProductFlavor.html)。

productFlavors{

max1 {

applicationId"com.example.dpt.gradle.max1"

}

x1 {

applicationId"com.example.dpt.gradle.x1"

}

}

输出所有apk

1

./gradlewassemble

输出任意flavor

1

./gradlewassembleX1

> 生成的apk在StudyGradle/app/build/outputs/apk/目录下

3.2 简单使用场景

3.2.1 使用不同包名

国内应用市场、渠道众多,更换包名是最简单的需求了

productFlavors{

max1 {

applicationId"com.example.dpt.gradle.max1"

}

x1 {

applicationId"com.example.dpt.gradle.x1"

}

}

3.2.2 buildConfig(控制变量)

Gradle会在产生源码阶段为flavor生成一个BuildConfig.java文件。BuildConfig类默认提供了一些常量字段,比如应用的版本名(VERSION_NAME),应用的包名(PACKAGE_NAME)等。更强大的是,开发者还可以添加自定义的一些字段。

android {

defaultConfig {

//自定义boolean型常量

buildConfigField ('boolean','AUTO_UPLOAD','false')

//自定义String型常量

buildConfigField('String','SERVER_URI','"默认 uri"')

}

productFlavors{

max1 {

applicationId"com.example.dpt.gradle.max1"

//自定义boolean型常量

buildConfigField ('boolean','AUTO_UPLOAD','true')

//自定义String型常量

buildConfigField('String','SERVER_URI','"Max uri"')

//自定义res常量

resValue('string','app_name','MAX')

}

x1 {

applicationId"com.example.dpt.gradle.x1"

//自定义String型常量

buildConfigField('String','SERVER_URI','"X1 uri"')

//自定义res常量

resValue('string','app_name','X1')

}

}

}

3.2.3 这还远远不够

>如果我们想更换大量文案,图标,布局,甚至是不同版本使用有差异的控件怎么办?

可在**src**文件夹下创建同**Flavor**,在里面可以对各种不同的Flavor,编写不同的需求。

在Demo中,两个不同的Flavor在详情页,使用了不同的布局和控件。

![enter image description here](http://7d9pic.com1.z0.glb.clouddn.com/gradle_flavor.png)

具体代码在Demo中的part2,分支

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,294评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,493评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,790评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,595评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,718评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,906评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,053评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,797评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,250评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,570评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,711评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,388评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,018评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,796评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,023评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,461评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,595评论 2 350

推荐阅读更多精彩内容