gradle-android插件

Android Gradle插件可以分为三类，分别对应Android中的三类工程：

  • App应用工程，它可以生成一个可运行的apk应用，对应插件id：com.android.application
  • Library库工程，可以生成AAR包给其他工程使用，对用插件id:com.android.library
  • test测试工程，对App工程或者Library库工程进行单元测试，对应插件id：com.android.test

通过配置不同的插件，配合AS，就可以进行编译测试发布等操作

应用Android插件

Android Gradle插件属于第三方插件，托管在Jcenter上，所以在应用之前，我们需要先配置classpath，

1
2
3
4
5
6
7
8
buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.1.3'
    }
}

我们配置仓库为jcenter，这样当我们配置依赖的时候，Gradle就会去这个仓库里寻找我们的依赖，然后我们在dependencies{}中依赖Android插件。

buildscript{}这部分配置了可以写到根工程的build.gradle脚本文件中，这样所有的自工程就不用重复配置了，之后就可以应用Android Gradle插件了

1
2
3
4
5
6
7
8
9
10
11
apply plugin: 'com.android.application'

android {
    compileSdkVersion 28
    defaultConfig {
        minSdkVersion 19
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
    }
}

android{}是Android插件提供的一个扩展类型，可以让我们自定义Android Gradle工程。compileSdkVersion是编译所依赖的Android SDK的版本

Android Gradle 工程示例

Android Gradle插件继承于Java插件，具有所有的Java插件的特性。对于一个Android应用 ，常见的build.gradle文件内容如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
apply plugin: 'com.android.application'

android {
    compileSdkVersion 28
    buildToolsVersion "28.0.3"
    defaultConfig {
        applicationId "com.huangyuanlove.testandroid"
        minSdkVersion 19
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:28.0.0-rc01'
    implementation 'com.android.support.constraint:constraint-layout:1.1.2'
    implementation 'com.android.support:design:28.0.0-rc01'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'com.android.support.test:runner:1.0.2'
    androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.2'
}

Android Gradle工程的配置，都是在android{}中，这是唯一的一个入口。通过它，可以对Android Gradle工程进行自定义的配置，其具体实现是com.android.build.gradle.AppExtension，所以很多Android配置可以从这个类里去找，

compileSdkVersion

compileSdkVersion 28是配置我们编译Android工程的SDK，这里的23是Android SDK的API Level，该配置的原形是一个compileSdkVersion方法：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
/** @see #getCompileSdkVersion() */
    public void compileSdkVersion(String version) {
        checkWritability();
        this.target = version;
    }

    /** @see #getCompileSdkVersion() */
    public void compileSdkVersion(int apiLevel) {
        compileSdkVersion("android-" + apiLevel);
    }

    public void setCompileSdkVersion(int apiLevel) {
        compileSdkVersion(apiLevel);
    }

    public void setCompileSdkVersion(String target) {
        compileSdkVersion(target);
    }

在gradle中，方法的括号可以省略，同时我们也注意到了String类型的重载方法和两个setCompileSdkVersion方法，完全可以按照这四种方式来进行配置。

buildToolsVersion

buildToolsVersion "28.0.3"表示我们使用的Android构建工具的版本。它的原形也是一个方法：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
public void buildToolsVersion(String version) {
        checkWritability();
        //The underlying Revision class has the maven artifact semantic,
        // so 20 is not the same as 20.0. For the build tools revision this
        // is not the desired behavior, so normalize e.g. to 20.0.0.
        buildToolsRevision = Revision.parseRevision(version, Revision.Precision.MICRO);
    }

    /** {@inheritDoc} */
    @Override
    public String getBuildToolsVersion() {
        return buildToolsRevision.toString();
    }

    public void setBuildToolsVersion(String version) {
        buildToolsVersion(version);
    }

我们可以通过buildToolsVersion方法赋值，也可以通过android.buildToolsVersion这个属性读写它的值。

defaultConfig

defaultConfig是默认的配置，它是一个ProductFlavor。ProductFlavor允许我们根据不同的情况同时生成多个不同的APK包。如果不针对我们自定义的ProductFlavor单独配置的话，会为这个ProductFlavor使用默认的defaultConfig的配置。里面的属性就不再一一解释。

buildTypes

buildTypes是一个NamedDomainObjectContainer类型，是一个域对象。我们可以在buildTypes{}里面新增任意多个我们需要构建的类型，Gradle会帮我们自动创建一个对应的BuildType，名字就是我们定义的名字。

  • 上面的 release就是一个BuildType。

  • minifyEnabled是否为该构建类型启用混淆，false表示不启用，true表示启用

  • proguardFiles，当我们启用混淆时，所使用proguard的配置文件，我们可以通过它配置混淆规则。它对应BuildType的proguardFiles方法，接受一个可变参数，所以我们同时可以配置多个配置文件。
    getDefaultProguardFile是Android扩展的一个方法，它可以读取你的AndroidSDK目录下默认的proguard配置文件。

    Android Gradle任务

  • connectedCheck 在所有连接的设备或者模拟器上运行check检查。

  • devicesCheck 通过API连接远程设备运行checks。

  • lint在所有的ProductFlavor上运行lint检查。

  • install和uninstall类的任务可以直接在我们已连接的设备上安装或者卸载你的app。

  • signingReport可以打印App的签名

  • AndroidDependencies可以打印Android的依赖
    还有一些其他类似的任务，可以通过./gradlew tasks 来查看

以上

#Android #Gradle
gradle-android插件
https://blog.huangyuanlove.com/2018/12/22/gradle-android插件/
作者
HuangYuan_xuan
发布于
2018年12月22日
许可协议
BY HUANG兄