美文网首页
Android Gradle 新手入门

Android Gradle 新手入门

作者: tiger桂 | 来源:发表于2017-05-03 15:25 被阅读0次

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,分支

相关文章

网友评论

      本文标题:Android Gradle 新手入门

      本文链接:https://www.haomeiwen.com/subject/enwxvttx.html