Gradle 成员介绍

一、功能

Gradle 和 Android 插件完成以下方面的构建配置

构建类型

build 类型定义 Gradle 在构建和打包应用时使用的某些属性,通常针对开发生命周期的不同阶段进行配置。例如,调试 build 类型支持调试选项,并会使用调试密钥为应用签名;而发布 build 类型则会缩减应用、对应用进行混淆处理,并使用发布密钥为应用签名以进行分发。如需构建应用,您必须至少定义一个 build 类型。Android Studio 默认会创建调试 build 类型和发布 build 类型。如需开始为应用自定义打包设置,请了解如何配置构建类型

产品变种

产品变种代表您可以向用户发布的不同应用版本,如免费版应用和付费版应用。您可以自定义产品变种以使用不同的代码和资源,同时共享并重用所有应用版本共用的部分。产品变种是可选的,您必须手动创建。如需开始创建应用的不同版本,请了解如何配置产品变种

构建变体

构建变体是构建类型与产品变种的交叉产物,也是 Gradle 用来构建应用的配置。利用构建变体,您可以在开发期间构建产品变种的调试版本,或者构建产品变种的已签名发布版本以供分发。虽然您无法直接配置构建变体,但可以配置组成它们的构建类型和产品变种。创建额外的构建类型或产品变种也会创建额外的构建变体。如需了解如何创建和管理构建变体,请参阅配置构建变体概览。

清单条目

您可以在构建变体配置中为清单文件中的某些属性指定值。这些 build 值会替换清单文件中的现有值。如果您要为应用生成多个变体,让每一个变体都具有不同的应用名称、最低 SDK 版本或目标 SDK 版本,便可运用这一技巧。当存在多个清单时,Gradle 会合并清单设置

依赖项

构建系统会管理来自本地文件系统以及来自远程代码库的项目依赖项。这样一来,您就不必手动搜索、下载依赖项的二进制文件包以及将它们复制到项目目录中。如需了解详情,请参阅添加 build 依赖项

签名

构建系统既允许您在 build 配置中指定签名设置,也可以在构建流程中自动为应用签名。构建系统通过已知凭据使用默认密钥和证书为调试版本签名,以避免在构建时提示输入密码。除非您为此构建明确定义签名配置,否则,构建系统不会为发布版本签名。如果您没有发布密钥,可以按为应用签名中所述生成一个。

代码和资源缩减

构建系统允许您为每个构建变体指定不同的 ProGuard 规则文件。在构建应用时,构建系统会应用一组适当的规则以使用其内置的缩减工具(如 R8)缩减您的代码和资源

APK 支持

通过构建系统可以自动构建不同的 APK,并让每个 APK 只包含特定屏幕密度或应用二进制接口 (ABI) 所需的代码和资源。如需了解详情,请参阅构建多个 APK。请注意,我们建议的方法是发布单个 AAB,因为它除了让您可以按屏幕密度和 ABI 进行拆分以外,还可以让您按语言进行拆分,同时还可以降低因必须上传多个工件到 Google Play 所造成的复杂性

Android Gradle 插件版本说明

https://developer.android.com/studio/releases/gradle-plugin?buildsystem=ndk-build#updating-gradle

二、成员

开始新项目时,Android Studio 会自动为您创建其中的部分文件(如图 2 所示),并为其填充合理的默认值

image.png

有一些 Gradle 构建配置文件是 Android 应用的标准项目结构的组成部分。您必须了解其中每个文件的范围和用途及其应定义的基础 DSL 元素,才能着手配置构建。

1、settings.gradle

Gradle - setting

2、local.properties

配置本地环境属性,其中包括:

  • ndk.dir - NDK 的路径。此属性已被弃用。NDK 的所有下载版本都将安装在 Android SDK 目录下的 ndk 目录中。

  • sdk.dir - SDK 的路径。

  • cmake.dir - CMake 的路径。

  • ndk.symlinkdir - 在 Android Studio 3.5 及更高版本中,创建指向 NDK 的符号链接,该符号链接的路径可比 NDK 安装路径短。

sdk.dir=/home/duchao/Android/Sdk
sdk.dir=/home/duchao/Android/ndk

也可以定义一些参数,可以通过getProperty获取

// local.properties
name=nameWord
pwd=pwdWord

// build.gradle
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
def name = properties.getProperty('name')
def pwd = properties.getProperty('pwd')

3、gradle.properties

配置项目全局 Gradle 设置

// 编译内存
org.gradle.jvmargs=-Xmx1600M
// aapt2 
android.enableAapt2=false

4、根目录build.gradle

文件位于项目的根目录下,用于定义适用于项目中所有模块的依赖项

plugins {
    id 'com.android.application' version '7.0.0' apply false
    id 'com.android.library' version '7.0.0' apply false
    id 'org.jetbrains.kotlin.android' version '1.6.10' apply false
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

配置项目全局属性

对于包含多个模块的 Android 项目,可能有必要在项目级别定义某些属性并在所有模块之间共享这些属性

ext {
    sdkVersion = 28
    supportLibVersion = "28.0.0"
    ...
}

android {
    compileSdkVersion rootProject.ext.compileSdkVersion
}
dependencies {
    implementation "com.android.support:appcompat-v7:${rootProject.ext.supportLibVersion}"
}

5、module下build.gradle

配置构建设置提供自定义打包选项

  • defaultConfig{} 默认配置,是ProductFlavor类型。它共享给其他ProductFlavor使用
  • sourceSets{ } 源文件目录设置,是AndroidSourceSet类型。
  • buildTypes{ } BuildType类型
  • signingConfigs{ } 签名配置,SigningConfig类型
  • productFlavors{ } 产品风格配置,ProductFlavor类型
  • testOptions{ } 测试配置,TestOptions类型
  • aaptOptions{ } aapt配置,AaptOptions类型
  • lintOptions{ } lint配置,LintOptions类型
  • dexOptions{ } dex配置,DexOptions类型
  • compileOptions{ } 编译配置,CompileOptions类型
  • packagingOptions{ } PackagingOptions类型
  • jacoco{ } JacocoExtension类型。 用于设定 jacoco版本
  • splits{ } Splits类型

build.gradle内成员

compileSdkVersion

指定Gradle编译使用的Android API级别, 项目可以使用此级别及其更低版本API功能

buildToolsVersion

指定SDK构建工具的命令行版本 (Gradle应该用来构建应用程序的实用程序和编译器)

此属性是可选的,默认使用推荐版本的构建工具

compileOptions

编译使用的jdk版本

compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
}

sourceSets

sourceSets {
    main {
        manifest.srcFile "AndroidManifest.xml"
        java.srcDirs = ["src"]
        res.srcDirs = ["res"]
        assets.srcDirs = ["assets"]
        jniLibs.srcDirs = ["jni"]
        aidl.srcDirs = ["aidl"]
    }

    debug.setRoot('')
}

debug.setRoot('')作用:当资源位于同一个根目录下时,可以使用setRoot区分指定

如下例子:res区分为免费和付费,debug环境使用免费,release使用付费,可以使用setRoot

image.png
image.png

多变种

Gradle Flavor

splits 针对多个 APK 配置 build (分辨率分apk , ABI分apk)

https://developer.android.com/studio/build/configure-apk-splits

dependencies

Gradle 依赖方式与差异

multiDexEnabled方法数超过 64K

https://developer.android.com/studio/build/multidex

proguardFiles、minifyEnabled、shrinkResources (混淆代码优化缩减R8)

https://developer.android.com/studio/build/shrink-code

signingConfigs 签名与秘钥

https://developer.android.com/studio/publish/app-signing

cpp/c编译

externalNativeBuild {
    cmake {
        path file('src/main/cpp/CMakeLists.txt')
        version '3.18.1'
        cppFlags ''
        abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
    }
}

使用 Maven Publish 插件 (如上传sdk)

https://developer.android.com/studio/build/maven-publish-plugin

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容