对于gradle的属性，大家可以自行查看文档，我主要从文档中总结一些常用的。
文档：http://google.github.io/android-gradle-dsl/
现在的Android Studio 3.0版本以上已经使用了3.0以上的gradle插件，所以直接看最新的文档。注意：本文的属性不管是application还是library都是android{｝下的。只有极少数的属性是只在library有效的。
一 aaptOptions
| property | Description |
|---|---|
| additionalParameters | 指定aapt的参数，具体可通过aapt –help查看 |
| cruncherEnabled | 3.1已经遗弃，由 BuildType.isCrunchPngs() 代替 |
| cruncherProcesses | 指定压缩图片的进程数 |
| failOnMissingConfigEntry | 不明觉厉，应该是找apk的config的入口如果报错会返回，知道大神麻烦评论告知一下 |
| ignoreAssets/ignoreAssets | 这两个调用的是同一个方法，没有区别，忽略assets的文件，可以用通配符 |
| noCompress | 指定不压缩的文件，指定为”“将会尝试关闭所有文件压缩 |
二、adbExecutable
一个返回File的方法，具体是adb.exe的路径，感觉没什么卵用。
三、adbOptions
| property | Description |
|---|---|
| installOptions | 安装apk时的参数，可通过adb –help查看 |
| timeOutInMs | adb操作的超时时间 |
四、applicationVariants
项目的所有构建变体，简单查看
applicationVariants.all{
println it.name
}五、buildToolsVersion
SDK构建工具的版本，3.1可以不用指定，默认使用的是27.0.3，不知道是不是我的电脑的最新版本是27.0.3.
六、buildTypes
关于构建变体，官网上的文档写的十分详细，我就不解释了，直接上车https://developer.android.com/studio/build/build-variants.html#build-types，只说一下其他属性。
| property | Description |
|---|---|
| applicationIdSuffix | applicationId添加的后缀 |
| consumerProguardFiles | 添加混淆文件 |
| crunchPngs | 是否压缩图片 |
| debuggable | 是否允许调试 |
| jniDebuggable | 是否允许调试jni代码 |
| manifestPlaceholders | 清单文件占位符 |
| matchingFallbacks | 这是3.0.0之后才有的属性，指定对应的buildType。例如：app模块有一个stage的buildType，然后library没有stage的buildType，就会报错。Unable to resolve dependency for ‘:app@stage/compileClasspath’: Could not resolve project :library.这时候可以通过这个属性来指定。 |
| minifyEnabled | 开启混淆优化 |
| multiDexEnabled/multiDexKeepFile/multiDexKeepProguard | 多dex的属性指定，参考官网： https://developer.android.com/studio/build/multidex |
| postprocessing | 文档没说，直说以后可能会改变，不管 |
| proguardFiles | 指定混淆文件，默认这两个proguard-android.txt proguard-android-optimize.txt |
| postprocessing | 文档没说，直说以后可能会改变，不管 |
| pseudoLocalesEnabled | 可以为本地化的语言文字对应调整UI，比如文字左对齐或者右对齐 |
| renderscriptDebuggable/renderscriptOptimLevel | 渲染脚本相关，反正没用过 |
| shrinkResources | 压缩资源，必须开启minifyEnabled才有用 |
| signingConfig | 签名配置 |
| testCoverageEnabled | 测试覆盖率 |
| useProguard | 使用instant run的时候可以用此变量关闭混淆 |
| versionNameSuffix | 版本名后缀 |
| zipAlignEnabled | 优化对齐，可以减少apk内存使用 |
| method | usage |
|---|---|
| void buildConfigField(String type, String name, String value) | 为生成的BuildConfig类添加属性，一般来说一个module都会生成一个BuildConfig类，可以参考https://blog.csdn.net/a568478312/article/details/74989722 |
| BuildType consumerProguardFiles(Object… proguardFiles) | 往application project传递proguard文件，该属性只在library project有效 |
| ExternalNativeBuildOptions externalNativeBuild(Action action) | native参数配置，后面说 |
| DefaultBuildType initWith(BuildType that) | 复制传递的buildType所有属性 |
| BuildType proguardFiles(Object… files) | 添加新的proguard文件 |
| void resValue(String type, String name, String value) | 添加新的生成资源 |
| BuildType setProguardFiles(Iterable proguardFileIterable) | 设置混淆文件 |
1、externalNativeBuild
注意这里是buildType下面的属性，通过文档看这个和android{}下的有区别。
| property | Description |
|---|---|
| cmake | cmake配置参数 |
| ndkBuild | ndk-build配置参数 |
这两个的属性都是下面几个
- abiFilters 指定cpu架构
- arguments 指定对应的参数
- cFlags c编译的flags
- cppFlags c++编译的flags
- targets 指定需要编译的可执行文件
七、 compileOptions
| property | usage |
|---|---|
| encoding | java的编码 |
| incremental | java编译是否使用gradle的增量模型 |
| sourceCompatibility | java原文件的语言版本 |
| targetCompatibility | java字节码的语言版本 |
八、compileSdkVersion
指定编译的api 版本
九、dataBinding
一个xml绑定数据的库，参考https://developer.android.com/topic/libraries/data-binding/
(十) defaultConfig
这里有部分和buildType想同，所以只列出特有的部分。
| property | Description |
|---|---|
| applicationId | 应用的id |
| dimension | 风味维度，这个参考上面的构建变体结合使用 |
| javaCompileOptions | 这里只能配置annotationProcessorOptions 注解处理器的参数，然而文档里直接什么都没有写，不明所以 |
| ndk | 只能指定abifilter |
| testApplicationId/testApplicationId/testApplicationId/testApplicationId/testInstrumentationRunnerArguments | 几个测试的，没有怎么用过，不了解 |
| vectorDrawables | 构建vectorDrawalbe的支持，有两个属性。generatedDensities：指定生成PNG的屏幕密度；useSupportLibrary：使用运行时的库对vectorDrawable的支持。 |
| versionCode | 版本号 |
| versionName | 版本名 |
| versionNameSuffix | 版本名后缀 |
| method | usage |
|---|---|
| versionCode | 版本号 |
| versionName | 版本名 |
| versionNameSuffix | 版本名后缀 |
| void maxSdkVersion(int maxSdkVersion) | 最大支持的api版本 |
| void minSdkVersion(int minSdkVersion) | 最小支持的api版本 |
| void missingDimensionStrategy(String dimension, String requestedValue) | gradle3.0.0以上版本才有，指定维度缺失策略，也就是说app有的Dimension而library里没有找到对应的时候，就靠这个来指定策略，可以在productFlavors设置来单独覆盖 |
| void resConfig(String config) | 指定可选的资源来进行保留，用来排除某些不需要的语言资源等 |
| void targetSdkVersion(int targetSdkVersion) | 指定target的api版本，比如如果设置小于23，那么动态申请权限将不会应用 |
十一、defaultPublishConfig
指定发布到远程仓库的版本名，不指定默认发布release,如果设置了productFlavors，则需要明确指出。本地模块不需要指定此属性。
十二、dexOptions
| property | Description |
|---|---|
| additionalParameters | dx命令的参数 |
| javaMaxHeapSize | 指定虚拟机的-Xmx参数，例如 2048m |
| jumboMode | 该模式会将字符串数量由2^16增大到2^32 |
| keepRuntimeAnnotatedClasses | 保留运行时的注解 |
| maxProcessCount | dex的最大进程数，默认4 |
| preDexLibraries | 预编译库 |
| threadCount | dx的线程数，默认4 |
十三、externalNativeBuild
注意这个快是在android{}下面的，属性如下：
1.cmake
- buildStagingDirectory 指定native编译输出目录
- path 指定cmakeLists.txt的相对路径
- version 指定使用CMake的版本呢
2.ndkBuild
- buildStagingDirectory 指定native编译输出目录
- path 指定Android.mk的相对路径
十四、flavorDimensionList
通过使用flavorDimensions指定维度列表，参考buildType的变体构建，结合使用。
十五、lintOptions
| property | Description |
|---|---|
| abortOnError | 发现错误是否停止 |
| absolutePaths | 错误输出是否显示完整路径 |
| check | 指定需要检查的id，可以通过lint –list查看所有支持的id |
| checkAllWarnings | 是否检查所有警告 |
| checkReleaseBuilds | 是否检查releast的构建 |
| disable | 禁止对应id的检查 |
| enable | 使能对应id的检查 |
| explainIssues | 是否需要错误解释，注意html和xml报告是无条件有解释的，忽略这个设置的。 |
| htmlOutput | html报告的输出路径 |
| htmlReport | 是否需要html报告 |
| ignoreWarnings | 是否忽略警告 |
| lintConfig | 配置默认lint配置文件，可以参考https://developer.android.com/studio/write/lint#pref |
| noLines | 是否包含资源行号 |
| quiet | 是否使用安静模式，例如不输出路径或者报告文件等 |
| severityOverrides | 覆盖默写id的等级，比如原本资源id为error的覆盖成fatal |
| showAll | 是否需要包含所有输出 |
| textOutput | text报告输出路径 |
| textReport | 是否需要text报告 |
| warningsAsErrors | 是否将警告置为错误来处理 |
| xmlOutput | xml报告路径 |
| xmlReport | 是否需要xml报告 |
| Methods | Description |
|---|---|
| check | 添加需要检查的id |
| disable | 添加禁用的id |
| enable | 添加使能id |
| error | 将指定id的等级改为error |
| fatal | 将指定id的等级改为fatal |
| ignore | 将指定id的等级改为ignore |
| warning | 将指定id的等级改为warning |
十六、ndkDirectory
配置gradle使用的ndk目录
十七、packagingOptions
这个主要是处理打包时候的一些文件冲突。
| property | Description |
|---|---|
| excludes | 排除文件 |
| merges | 合并发现的冲突文件 |
| pickFirsts | 发现冲突首选第一次找到的文件 |
十八、productFlavors
同样参考构建变体。
十九、resourcePrefix
指定资源前缀，主要是用来防止library的资源和其他module产生冲突的时候使用。
二十、sdkDirectory
配置Gradle使用的SDK目录。
二十一、signingConfigs
配置签名，这个就不展开说了，搜一下一堆。
二十二、sourceSets
配置各种文件的目录，平时用到都是默认目录，可以使用gradlew sourceSet查看默认目录。这个看需求来定是否需要配置，也不展开说了，直接百度一堆。
二十三、splits
配置apk拆分选项，可以通过区分api,density，language等来减少apk大小。具体使用可以参考
https://developer.android.com/studio/build/configure-apk-splits
https://developer.android.com/topic/instant-apps/guides/config-splits
二十四、variantFilter
配置Android插件需要保留或者排除的变体。其实就是过滤变体罢了。
android {
...
variantFilter { variant ->
def buildTypeName = variant.buildType*.name
def flavorName = variant.flavors*.name
if (flavorName.contains("dev") && buildTypeName.contains("release")) {
// Tells Gradle to ignore each variant that satisfies the conditions above.
setIgnore(true)
}
}
}二十五、useLibrary
在classpath指定library，基本上没什么卵用。
android {
// Adds a platform library that ships with the Android SDK.
useLibrary 'org.apache.http.legacy'
}