专栏首页Android学习之路Android Gradle 插件

Android Gradle 插件

Android Gradle 简介

从 Gradle 角度看,Android 插件是由 Google 的 Android 团队开发的一个第三方插件。

从 Android 的角度看,Android 插件是基于 Gradle 构建的,是和 Android studio 完美搭配的新一代构建系统。

使用它可以很轻松的执行以下操作: 自定义,配置和扩展编译流程。 使用相同的项目和模块为你的应用创建多个具有不同功能的 APK。 在不同源集之间重复使用代码和资源。

利用 Gradle 的灵活性,可以在不修改应用核心源文件的情况下完成以上所有操作。

Android 插件能做的还有很多,更多的可以参阅 配置构建

插件分类

Android 插件的分类其实是根据 Android 工程的属性分类的。

在 Android 中有很多种工程类型,常见的有

  • App 应用工程,用于生成可运行的 APK 。
  • Library 库工程,用于生成 AAR 包给其他 APK 应用工程公用。

分别对应的插件 ID 是

  • App 插件 :com.android.application
  • Library 插件:com.android.library

在创建 Module 时就可以看到很多类型

通过应用以上不同的插件就可以配置不同的 Android 工程,然后配合 Android studio 就可以分别对它们进行编译,测试,发布等操作。

应用插件

在 Android studio 里创建 Module 的时候选择不同的工程会自动应用对应的插件。

如果不配合 Android studio 应用,可以在配置脚本 build.gradle 里设置对应的插件ID 。 因为 Android 插件是托管在 jcenter 仓库上的,所以必须在 repositories{} 添加 jcenter 仓库。

这样就能找到 Android 插件了,具体为什么这么做,看这里。 然后是把构件依赖添加到 classpath 。

这一步一般是在根项目的配置文件里配置的,这样就不用每一个子项目都配置了。

buildscript {
    
    repositories {
        jcenter()
        
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.6.3'
    }
}

最后就是在子项目里应用插件了。

apply plugin: 'com.android.application'

apply plugin: 'com.android.library'

任务

Android 插件是继承自 Java 插件的,自然把 Java 的任务也继承来了,例如

  • assemble
  • build
  • clean
  • check

除了继承 Java 插件的,Android 插件本身也添加了自己的任务,例如

  • connectCheck 在所有连接设备或者模拟器上运行 check 检查。
  • deviceCheck 通过 API 链接远程设备运行 checks 。它被用于 CI 服务器上。
  • lint 在所有的 ProductFlabor 上运行 lint 检查。
  • install 在已连接的设备上安装 应用。
  • uninstall 在已连接的设备上卸载应用。

除此之外还有些不太常用的任务:

  • signingReport 可以打印应用的签名
  • androidDependencies 可以打印 Android 的依赖。

一般我们常用的任务是 build、assemble、clean、check、lint等,通过这些任务可以对应用进行打包生成 APK,对现有的 Android 工程进行 lint 检查等。

还有一些其他的任务,可以通过命令查看

gradle tasks

在 Android studio 的 Gradle 窗口也可以看到所有的任务

关于 Java 插件的介绍,移步 Java 插件

Android 工程详细示例

Android 插件继承自 Java 插件,具备 Java 插件所有的特性,其目录结构也和 Java 差不多。

使用 Android studio 创建一个工程,可以得到以下目录:

我们的重点放在项目的配置脚本文件上,大部分的配置是在这里的。

这是一个标准的多项目的 Gradle 目录。

  • settings.gradle 配置参与构建的项目,会在初始化阶段被执行。
  • local.properties 是本地配置,配置 sdk和ndk 的位置。
  • gradlew.bat Gradle 在 windows 系统下的执行脚本
  • gradlew Gradle 在 unix 系统下的执行脚本
  • gradle.properties Gradle属性配置文件
  • build.gradle Gradle 配置文件 这里是根项目的配置文件。
  • *.iml Android studio 自动生成的文件,每个项目都会生成一个。
  • .gitignore Git 的忽略配置
  • gradle/wrapper 目录是 Gradle Wrapper 使用的目录
  • gradle-wrapper.jar 是执行 Gradle Wrapper 使用的
  • gradle-wrapper.properties 是配置 Gradle Wrapper 属性的
  • app 目录是默认创建的一个 App 应用工程。在 settings.gradle 里会默认导入此子项目。

关于更多 Gradle 介绍,移步 Gradle 系列,在持续更新中。

settings.gradle

//项目名称,默认是目录名字
rootProject.name='AndroidGradleExample'
//导入子项目 app 
include ':app'

local.properties

# 配置 SDK 在本机的目录,创建项目时,Android studio 会自动配置,如果需要自己单独设置,可以更改
sdk.dir=/Users/skymxc/Library/Android/sdk
# ndk 在本机的目录 需要时配置
##ndk.dir=/Users/skymxc/Library/Android/sdk/ndk-bundle

gradle.properties

# 使用 AndroidX 更多详细可查看 https://developer.android.com/topic/libraries/support-library/androidx-rn
android.useAndroidX=true
# 自动转换第三方库使用 androidx ;Automatically convert third-party libraries to use AndroidX
android.enableJetifier=true
# 为 JVM 守护进程指定参数;Specifies the JVM arguments used for the daemon process.
# 调整内存设置的参数;The setting is particularly useful for tweaking memory settings.
org.gradle.jvmargs=-Xmx1536m

.gitignore

*.iml
.gradle
.idea
/local.properties
/.idea/caches
/.idea/libraries
/.idea/modules.xml
/.idea/workspace.xml
/.idea/navEditor.xml
/.idea/assetWizardSettings.xml
.DS_Store
/build
/captures
.externalNativeBuild
.cxx

build.gradle 根项目的配置脚本,可以在这里配置所有项目都会用到的共性配置,例如配置所有子项目都会使用的仓库。

// Top-level build file where you can add configuration options common to all sub-projects/modules.
//顶层配置文件,这里添加的配置可选择配置到所有子项目

//配置脚本,主要是配置 Gradle 脚本执行使用的依赖。
buildscript {

    //使用的插件所在的仓库,例如 Android 插件就放在了 jcenter 上
    repositories {
        google()
        jcenter()
        
    }

    //使用的插件依赖
    dependencies {
        // Android 构建工具
        classpath 'com.android.tools.build:gradle:3.6.3'
        

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
        //注意:不要子项目的依赖放在这里,各自项目的依赖应该放在各自项目的 build.gralde 配置脚本里。
        //这里的配置会应用到所有项目。
    }
}

//会遍历所有子项目,这里相当于给所有项目都配置了仓库了。
allprojects {

    //给所有项目配置仓库
    repositories {
        google()
        jcenter()
        
    }
}

// 配置 clean 任务,删除根目录的 build 目录。
task clean(type: Delete) {
    delete rootProject.buildDir
}

应用工程目录

  • libs 放置第三方的 jar ,也可以放置 so 库。
  • src 源文件
  • src/androidTest Android测试目录,这里可以写测试代码,执行测试
  • src/main main源集,其中 java 目录是 java 源代码,res 目录是资源目录
  • src/test 测试目录,其中 java 目录可以写单元测试等测试代码,执行测试
  • .gitignore git 忽略文件
  • build.gradle Gradle 配置脚本
  • proguard-rules.pro 配置Proguard 混淆规则;
  • AndroidManifest.xml Android 清单文件;常见的配置有四大组件,使用的权限;

app/.gitignore

/build

app/build.gradle

//使用 Android 应用插件
apply plugin: 'com.android.application'
// android 是 Android插件提供的扩展类型。 Android 工程的配置都可以在这里配置。
android {

    //编译的SDK 版本
    compileSdkVersion 29
    //构建工具版本
    buildToolsVersion "29.0.2"

    //默认配置,它是一个 ProductFlavor
    defaultConfig {
        //应用程序ID,创建时的包名,可以更改。
        applicationId "cn.sintoon.androidgradleexample"
        //最小支持的SDK 版本
        minSdkVersion 19
        //目标 SDK 版本
        targetSdkVersion 29
        //应用版本代码,一般用于控制APP的升级。
        versionCode 1
        //应用版本名称,用户可以看到。
        versionName "1.0"

        //配置单元测试使用的 runner
        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    //构建类型
    buildTypes {
        //发布类型
        release {
            //是否启用混淆
            minifyEnabled false
            //proguard 规则文件;
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }

}
//使用的依赖
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])

    implementation 'androidx.appcompat:appcompat:1.1.0'
    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
    testImplementation 'junit:junit:4.12'
    androidTestImplementation 'androidx.test.ext:junit:1.1.1'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
}

Android 工程的配置都在 android{} 中。通过它,可以对 Android Gradle 工程进行自定义配置。

defaultConfig{} 里是默认的配置,它是一个 ProductFlavor 。

getDefaultProguardFile 是 Android 扩展的一个方法,它可以获取你的 Android SDK 目录下默认的 proguard 配置文件。 在 android-sdk/tools/proguard/ 目录下,文件名就是传入的参数 proguard-android-optimize.txt 。


我在 github 建了一个仓库,是 Android 插件的配置示例,会持续把所有的配置和注释都记录在这里以供查阅,AndroidGradleExample

End

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • Gradle 插件

    Gradle 本身只提供基本框架和核心概念,几乎所有的功能都是以插件的方式提供的。

    佛系编码
  • Gradle 自定义插件

    插件被用来封装构建逻辑和一些通用配置。将可重复使用的构建逻辑和默认约定封装到插件里,以便于其他项目使用。

    佛系编码
  • Gradle—创建简单的项目

    构建由一个或多个项目组成。项目的概念很抽象,它取决于你要用Gradle 做什么 。项目可以是 一个 Jar 库或者一个 web 程序。也可以是一个 zip 压缩...

    佛系编码
  • 读书笔记--Android Gradle权威指南(下)前言笔记后记

    请叫我大苏
  • Android-Gradle(二) Gradle相关配置详解

    Gradle是一个项目自动化建构工具,它使用一种基于Groovy的特定领域语言来声明项目设置,而不是传统的XML。Gradle主要帮我们做了依赖,打包,部署,发...

    android_薛之涛
  • Android Gradle实用技巧(一) | 隐藏Android签名文件和密钥信息

    Gradle是一款非常优秀的构建系统工具,它使用可以配置的DSL语言描述构建流程,同时允许我们使用原生的Java和Groovy编码的方式进行构建,所以相比Ant...

    飞雪无情
  • 给Android初学者的Gradle知识普及

    Android Tools 主页 ,大概是2016年2月份发布 adt21.1 的时候,忽然在主页发现了New Build System 原来是可以用gradl...

    砸漏
  • 最新发布!webpack 4.0.0-alpha.0 特性

    html-webpack-plugin: 插件系统升级 (jantimon/html-webpack-plugin#816)请提交意见

    疯狂的技术宅
  • Jenkins 2.173 发布通知

    本次更新移除了一些不太推荐的功能,请管理员及时关注,如果希望能恢复的旧的形态,可以按照下面的提示操作。

    LinuxSuRen
  • C#常用的集合类型(ArrayList类、Stack类、Queue类、Hashtable类、SortedList类)

    跟着阿笨一起玩NET

扫码关注云+社区

领取腾讯云代金券