Gradle for Android学习笔记（一）

ゞ浴缸里的玫瑰 2022-07-13 23:50 166阅读 0赞

## Gradle for Android学习笔记（一） ##

**每一个build.gradle文件代表一个project，一个project会有多个tasks**

如Android工程：包含Android tasks,build tasks,build setup tasks,help tasks,install tasks,other tasks.

--------------------

#### gradlew命令 ####

*  gradlew -help—->查看命令
 *  gradlew tasks—->查看root project有多少个task
 *  gradlew tasks –all—->查看详细的tasks
 *  gradlew -v/gradlew.bat -v—->查看Gradle版本及其他信息
 *  gradlew assembleDebug—->创建一个debug版本的app，在app/build/outputs/apk目录下,也可以执行简称：gradlew assDeb或gradlew aD
 *  gradlew :app:assembleDebug—->指定module名称执行assemble任务创建debug版本apk文件。

--------------------

#### Android Tasks简述 ####

Base tasks:定义了tasks，但没有实现

*  assemble
 *  clean
 *  check
 *  build

Android tasks：实现了base tasks的行为  
\- assemble：对每一个build type创建一个apk

assemble tasks默认依赖assembleDebug和assembleRelease

*  clean：移除所有的编译产生的文件
 *  check：执行Lint检查，如果Lint检测到问题，可以中断编译
 *  build：在assemble和check都运行

--------------------

#### Project中build.gradle文件，对多个Module统一管理 ####

如果你的工程有多个Android项目，可以把共同的设置写在allprojects中，如

allprojects{
        apply plugin:'com.android.application'
    
        android{
            compileSdkVersion 24
            buildToolsVersion "24.0.0"
        }
    }

这样要求你的module都是Android app，当然有更好的一个写法,可以在project中的build文件中定义一个ext\{\}，如：

ext{
        compileSdkVersion = 24
        buildToolsVersion = "24.0.0"
    }

在Module中的build文件中的android\{\}中使用，如：

android{
        compileSdkVersion rootProject.ext.compileSdkVersion
        buildToolsVersion rootProject.ext.buildToolsVersion
    
    }

--------------------

#### 自定义task ####

在build.gradle中自定义tasks任务,如:

ext{
        local="hello local"
    }
    
    task print<<{
        println local
        println ok  //task可以执行gradle.properties文件中的配置
    }

在gradle.properties文件中

ok='hello property'

--------------------

#### Native Library： ####

android默认支持native library，当然你需要 在Module中创建一个jniLib目录，如：

![image][]

android{
        ...
    
        sourceSets.main{
            jniLibs.srcDir 'src/main/libs'
        }
    }

使用.aar文件

repositories{
        flatDir{
            dirs 'aars'
        }
    }
    
    dependencies{
        compile(name:'libraryname',ext:'aar')
    }

#### Dependency的概念： ####

*  compile：默认，大多数应用都全部依赖于它
 *  apk：仅仅添加包，不参与编译。仅仅作为Jar依赖，添加代lib库中可能导致error
 *  provided：这个依赖不会被打包。仅仅作为Jar依赖，添加代lib库中可能导致error
 *  testCompile:添加测试的依赖
 *  androidTestCompile:添加测试的依赖。
 *  debugCompile：debug版本的依赖。
 *  releaseProvided：release版本不打包。

--------------------

#### 自定义buildTypes\{\} ####

在module项目中会自动生成一个release版本的build type，同时也有一个默认的debug版本（只不过隐藏了，可以对它的属性值进行重写，当然也可以自定义，如：

android{
        ...
        buildTypes{
    
            release{
                ...
            }
    
            debug{
                ...
            }
    
            my.initWith(buildTypes.debug)   //复制debug的所有属性
            my{
                applicationIdSuffix ".my"   //applicationId的变体
                versionNameSuffix "-my"
                buildConfigFiled "boolean" "LOG_DEBUG" "true"
                ...
            }
        }
    }

*  my.initWith(buildTypes.debug) —-表示my类型复制debug所有属性
 *  applicationIdSuffix “.my” —-表示应用id后面接上一个.my,如：

debug类型的applicationId:com.example
    
    my类型的applicationId:com.example.my
    
    应为applicationId不同，所以可以在同一个设备同时安装这2个apk。一般用于区分free版，price版。

*  buildConfigFiled—-设置编译配置

buildConfigFiled "boolean" "LOG_DEBUG" "true"
    意思是：给这个类型设置设置一个boolean类型的变量LOG_DEBUG，默认为true。
    
    同样还可以这样设置：
    buildConfigField "String", "API_URL", "http://staging.example.com/api" 
    意思是：配置文件从网络请求。

在项目中的使用：

if(BuildConfig.LOG_DEBUG){
        log.e("","")
    }
    
    封装成一个工具类，可以根据debug版本和release版本的不同进行log的统一开闭管理。

--------------------

#### SourceSets ####

当你创建一个名称为staging的build类型时，你需要使用自定义的source code和resource时，需要手动创建一个名称和build type名称相同的目录。如图：

![image][image 1]

我们在staging目录下可以创建自己的resource，可以覆盖和main目录中的resource。

如：

你的main中string.xml文件中

<resources>
        <string name="app_name">Application</string>
        <string name="hello">hello</string>
        ...
    </resources>

你的staging目录中string.xml文件

<resources>
        <string name="app_name">Application Staging</string>
    </resources>

那么在合并的时候，string.xml是这样的

<resources>
        <string name="app_name">Application Staging</string>
        <string name="hello">hello</string>
        ...
    </resources>

如果你的staging目录没有，或没有资源时，直接使用的main中的。

--------------------

#### Multiflavtor variants(多渠道打包) ####

比如我们的app需要打包到多个应用市场，如xiaomi，360等。

android{
        productFlavors{
            xiaomi{
                applicationId "com.example.application"
                ...
            }
    
            360{
                applicationId "com.example.application"
                ...
            }
        }
    }

这样打包的时候就可以打出2个应用市场的release-apk。

如果现在需求变更，需要一个free版本，一个price版本，如何打包呢？

我们可以这样打包，如下:

android{
        ...
    
        flavorDimensions 'price','store'
        productFlavors{
            xiaomi{
                flavorDimension "store"
            }
    
            360{
                flavorDimension "store"
            }
    
            free{
                flavorDimension "price"
            }
    
            price{
                flavorDimension "price"
            }
        }
    }

flavorDimensions—-是一个数组，store和price代表的2个维度，每个flavor分配到指定的维度中。

上面的例子中将 Product Flavor 分为两组（即两个维度），分别为price维度 \[free, paid\]和store维度\[xiaomi,360\] ，再加上默认的 BuildType 有 \[debug, release\] ，这将会组合生成以下的 Build Variant：

*  xiaomi-free-debug和xiaomi-free-release
 *  360-free-debug和360-free-release
 *  xiaomi-price-debug和xiaomi-price-release
 *  360-price-debug和360-price-release

--------------------

#### Variant filters(过滤变体) ####

这段代码可放在android\{…\}中，也可以放在android\{\}外。

android.variantFilter { variant -> if (!variant.buildType.name.equals('debug')) {
                variant.getFlavors().each() {
                    flavor -> if (!flavor.name.equals('xiaomi')) {
                            variant.setIgnore(true);
                        }
                }
            }
        }

代码用来过滤一些Variant。结果可以查看这里

![image][image 2]

--------------------

#### Signing configurations(签名配置) ####

默认情况下大概是这样：一般只需要设置一个release的就好。

android{
        signingConfigs{
            release{
                storeFile file("release.keystore")
                storePassword "storepassword"
                keyAilas "keyAlias"
                keyPassword "keyPassword"
            }
        }
    }
    
    在buildTypes{}中使用
    
    android{
        buildTypes{
            release{
                signingConfig  signingConfig.release
            }
        }
    }

这样release版本的在打包的时候，就会带上签名文件。

如果所有的都需要带上签名文件，可以在defaultConfigs\{\}中使用：

defaultConfigs{ signingConfig signingConfig.release }

如果针对某个store平台加上签名文件。可以：

android{
        productFlavors{
            xiaomi{
       //以小米为例
                signingConfig  signingConfig.release
            }
        }
    }

如果我们需要对每一个平台使用不同的签名打包，我们可以：

android{
        signingConfigs{
            release{
                ...//签名配置，参考上面
            }
    
            xiaomi{
                ...
            }
    
            baidu{
                ...
            }
        }
    }

对release版本打包签名处理：

android{
        buildTypes{
            release{
                productFlavors.xiaomi.signingConfig signConfigs.xiaomi  //针对小米release版本进行签名处理（使用小米特用的签名文件）
    
                 productFlavors.baidu.signingConfig signConfigs.baidu   //针对百度elease版本进行签名处理（使用百度特用的签名文件）
            }
        }
    }

[Gradle for Android 下载链接][Gradle for Android]

[image]: http://oe9ggtbcb.bkt.clouddn.com/10DRXC7IS1V~W%7DGTI4%604GWB.png
[image 1]: http://oe9ggtbcb.bkt.clouddn.com/QQ%E6%88%AA%E5%9B%BE20161119175016.png
[image 2]: http://oe9ggtbcb.bkt.clouddn.com/QQ%E6%88%AA%E5%9B%BE20161119213407.png
[Gradle for Android]: http://download.csdn.net/detail/qq_33689414/9683892