android gradle 设置,android gradle配置指南

Gradle简介

Gradle 是一个基于Ant和Maven概念的项目自动化建构工具。它使用一种基于Groovy的特定领域语言(DSL)来声明项目设置,这比我们的ANT使用XML构建配置要灵活的多。在编写配置时,你可以像编程一样灵活,Gradle是基于Groovy的DSL语言,完全兼容JAVA。

Android Studio中使用Gradle

Android Studio是使用Gradle进行自动化构建的IDE,当我们在Android Studio新建项目的时候,项目的目录大抵如下:

├── app #Android App目录

│ ├── app.iml

│ ├── build #构建输出目录

│ ├── build.gradle #构建脚本

│ ├── libs #so相关库

│ ├── proguard-rules.pro #proguard混淆配置

│ └── src #源代码,资源等

├── build

│ └── intermediates

├── build.gradle #工程构建文件

├── gradle

│ └── wrapper

├── gradle.properties #gradle的配置

├── gradlew #gradle wrapper linux shell脚本

├── gradlew.bat

├── LibSqlite.iml

├── local.properties #配置Androod SDK位置文件

└── settings.gradle #工程配置复制代码

其中,settings.gradle用于配置project,标明其下有几个module,比如这里包含一个:app module(当我们使用Android Studio添加一个在当前项目中添加一个module的时候,会自动的在这个文件中将新的module的名字include进来)

include ':app'复制代码

和settings.gradle在同一目录下的build.gradle是一个顶级的build配置文件,在这里可以为所有project以及module配置一些常用的配置。

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {

repositories {

jcenter()//使用jcenter库

}

dependencies {

// 依赖android提供的2.1.2的gradle build

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

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

// in the individual module build.gradle files

}

}

//为所有的工程的repositories配置为jcenters

allprojects {

repositories {

jcenter()

}

}复制代码

Android Gradle基本配置

配置应用的签名信息

在android.signingConfigs{}下定义一个或者多个签名信息,然后在buildTypes{}配置使用即可。例如:

android {

signingConfigs {

release {

//指定签名用的文件,file对应的根目录是gradle文件所在的根目录

storeFile file("release.keystore")

//别名

keyAlias "release"

//key的密码

keyPassword "123456"

//证书的密码

storePassword "123456"

}

debug {

...

}

}

buildTypes {

release {

signingConfig signingConfigs.release

}

debug {

signingConfig signingConfigs.debug

}

}

}复制代码

启用proguard混淆息

我们可以为不同的buildTypes选择是否启用混淆,一般release发布版本是需要启用混淆的,这样别人反编译之后就很难分析你的代码,而我们自己开发调试的时候是不需要混淆的,所以debug不启用混淆。对release启用混淆的配置如下:

android{

buildTypes {

release {

//是否启用混淆

minifyEnabled true

//是否去除无效的资源文件,这个设置依赖于minifyEnabled的设置,因此要两者同时设置为true才会生效

shrinkResources true

//getDefaultProguardFile('proguard-android.txt')表示获取SDK下'proguard-android.txt‘文件中的默认混淆规则

//'proguard-rules.pro'表示使用项目根目录下的 'proguard-rules.pro'文件中的混淆规则

//proguard-rules.pro文件名可以任意,只要在配置文件中指明即可

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

}

}

}复制代码

此处查看更多关于proguard的信息

启用zipAlign

zipalign是一款重要的优化apk应用程序的工具。

apk包的本质是一个zip压缩文档,优化的目的是使包内未压缩的数据能够有序的排列,从而减少应用程序运行时的内存消耗.

android{

buildTypes {

release {

zipAlignEnabled true

}

}

}复制代码

多渠道打包

通过设置productFlavors的值,我们可以指定不同的渠道包,并且每个渠道包可以自定义其applicationId、versionCode以及versionName等信息

android {

productFlavors {

dev{

applicationId "com.gdut.demo.dev"

}

qa{

applicationId "com.gdut.demo.qa"

}

pro{

applicationId "com.gdut.demo.pro"

}

}

}复制代码

AndroidManifest里的占位符

manifestPlaceholders,它允许我们动态替换我们在AndroidManifest文件里定义的占位符。例如:

android:name="UMENG_APPKEY"

android:value="${umeng_app_key}"/>

android:name="UMENG_SECRET"

android:value="${umeng_app_secret}"/>

然后我们可以针对不同的flavors或者buildTypes动态的指定相应的值,例如:

buildTypes {

debug {

manifestPlaceholders = [umeng_app_key: "替代的内容",umeng_app_secret:"替换的内容"]

}

...

}复制代码

自定义Android BuildConfig

BuildConfig.java是Android Gradle自动生成的一个java类文件,无法手动编译,但是可以通过Gradle控制,也就是说他是动态可配置的。在 gradle 文件 buildTypes 或者 productFlavors 下面,如:

buildTypes {

release{

//release的包中BuildConfig.ENDPOINT 就会被赋值为 http://example.com 就可以供 Java 代码调用了。

buildConfigField "String", "ENDPOINT", "\"http://example.com\""

}

}复制代码

动态设置 Android resValue

修改 res value 的方式,比如修改 strings.xml 文件中的 AppName 的值。在gradle文件 buildTypes 或者 productFlavors 下面,如:

buildTypes{

release{

//将release的包中名为 AppName 的 string value 值改为 app1

resValue "string", "AppName", "app1"

}

}复制代码

splits的使用

我们除了可以通过设置buildtypes来进行分类打包之外,还可以根据屏幕大小、cpu架构适配类型来进行分类打包,通过使用splits我们可以达成这个目的,例如

splits {

density {

enable true

reset()

include "mdpi", "hdpi"

}

abi {

enable true

reset()

include "x86", "mips"

}

}复制代码

更多的使用情况以及使用说明请参考android的官方文档:Configure APK Splits

解决方法数限制

Android设定的方法数是65536个(DEX 64K problem),超过这个方法数,导致dex无法生成,就无法生成APK.处理这个问题,除了尽可能的进行apk瘦身,减少整个apk的方法数之外,可以进行两种设置进行解决。

1. 使用multiDex。开启分包模式

defaultConfig {

multiDexEnabled=true

}

2. 忽略方法数的检查。2.3版本及以下的手机无法正常安装

android {

dexOptions {

jumboMode = true

}复制代码

dependencies依赖配置

dependencies {

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

compile project(':pullrefresh')

prodCompile files('src/prod/libs/bankcard-encrypt.jar')

debugCompile files('src/qa/libs/bugrpt.jar')

}复制代码

compile配置将被用于编译main application。它里面的所有东西都被会被添加到编译的classpath中,同时也会被打包进最终的APK。 以下是添加依赖时可能用到的其它一些配置选项:

compile main application(主module)。

androidTestCompile test application(测试module)

debugCompile debug Build Type(debug类型的编译)

prodCompile prod productFlavors(prod渠道的编译)复制代码

因为没有可能去构建一个没有关联任何BuildType(构建类型)的APK,APK默认配置了两个或两个以上的编译配置:compile和< buildTypes >Compile. 创建一个新的buildTypes或者productFlavors将会自动创建一个基于它名字的新配置

使用FindBugs

FindBugs是一个Java静态分析工具,用来检查类或者jar文件,用来发现可能的问题。检测完成之后会生成一份详细的报告,借助这份报告可以找到潜在的bug,比如NullPointException,特定的资源没有关闭,查询数据库没有调用Cursor.close()等;

Java的静态分析工具当然可以无难度的在Android上面运行,通过这种FindBugs的检查可以让App的运行更加的稳定。

apply plugin: "findbugs"

//定义一个task任务,这个任务的类型是FindBugs

task findbugs(type: FindBugs) {

//有警告错误的时候也是允许构建

ignoreFailures= true

effort= "default"

//报告的级别,Low,Medium,High

reportLevel= "high"

println( "$project.buildDir")

//classes和source分别是对应的.classe文件夹地址,和源代码文件地址。

classes = files("$project.buildDir/intermediates/classes")

source= fileTree("src/main/java/")

classpath= files()

//指定报告类型,有两种方式xml和html,只允许一种输出格式

reports{

xml.enabled=false

html.enabled=true

xml {

destination "$project.buildDir/findbugs.xml"

}

html{

destination "$project.buildDir/findbugs.html"

}

}

}复制代码

参考文献

Android Plugin DSL Reference

你可能感兴趣的:(android,gradle,设置)