Android-Gradle详解

Posted 2021-07-08 帅次

        android 构建系统非常灵活，可让你在不修改应用核心源代码文件的情况下执行自定义构建配置。本部分将介绍 Android 构建系统的工作原理，以及它如何帮助你对多个构建配置进行自定义和自动化处理。

        构建过程涉及许多将你的项目转换为 Android 应用程序包 (APK) 的工具和过程。构建过程非常灵活，因此了解一些幕后发生的事情很有用。下图为Android 应用模块的构建过程。

Android 应用模块的构建过程（如上图所示）遵循以下一般步骤：

        1、编译器将你的源代码转换为 DEX（Dalvik 可执行文件）文件，其中包括在 Android 设备上运行的字节码，以及其他所有内容到编译资源中。

        2、APKPackager将DEX文件和编译后的资源组合成一个APK。但是，在将你的应用安装并部署到Android设备之前，必须对APK进行签名。

        3、APKPackager使用调试或发布密钥库对你的 APK 进行签名：

        3.1如果你正在构建应用程序的调试版本，即你打算仅用于测试和分析的应用程序，则打包程序会使用调试密钥库对你的应用程序进行签名。Android Studio 使用调试密钥库自动配置新项目。

        3.2如果你正在构建你打算在外部发布的应用程序的发布版本，则打包程序会使用发布密钥库对你的应用程序进行签名。要创建发布密钥库，请看下面解答。

        4、在生成最终的 APK 之前，打包程序使用zipalign工具来优化你的应用程序，以便在设备上运行时使用更少的内存。

        在构建过程结束时，你将拥有应用的调试 APK 或发布 APK，可用于部署、测试或发布给外部用户。

一、什么是Gradle

        Gradle，它是一个基于JVM的新一代构建工具，关于Gradle完全可以写一本书。这个小节就讲讲Android项目中Gradle的使用。目前Android应用大多都是采用Android Studio来开发的，Android Studio默认是采用Gradle作为构建工具的。通常开发者可以不需要理解任何Gradle的脚本配置，就可以开发出一个APP。但是，当你想做一些更智能的操作时，比如修改打包后的输出目录、提高打包速度、构建系统、插件化、热修复和组件化等等，就必须对Gradle有比较深入的了解

二、project/build.gradle(project)

        从上面来说整个项目有两个build.gradle文件，咱们先重点查看project中的build.gradle即

//顶级生成文件，您可以在其中添加所有子项目/模块通用的配置选项。
buildscript {
    //构建过程依赖的仓库
    repositories {
        google()
        //代码托管仓库
        mavenCentral()
    }
    dependencies {
        //Gradle 插件及使用版本
        classpath "com.android.tools.build:gradle:4.2.0"
        //注意：不要将应用程序依赖项放在这里；他们属于
        //app(单个模块)/build.gradle文件中
    }
}
//这里面配置整个项目依赖的仓库,这样每个module就不用配置仓库了
allprojects {
    repositories {
        //代码托管仓库，可以引用 jcenter() 上任何的开源项目
        google()
        mavenCentral()
        jcenter() // 警告：此存储库即将关闭
    }
}
// 运行gradle clean时，执行此处定义的task。
// 该任务继承自Delete，删除根目录中的build目录。
// 相当于执行Delete.delete(rootProject.buildDir)
task clean(type: Delete) {
    delete rootProject.buildDir
}

三、app/build.gradle

        上面讲到了project中的build.gradle，下面咱们看看app/build.gradle

//都表示是一个应用程序的模块，可独立运行
//（两种方式因Android Studio版本不同产生的）
//apply plugin: 'com.android.application'
plugins {
    id 'com.android.application'
}
都表示是一个依赖库，不能独立运行可生成jar或者aar
//apply plugin: 'com.android.library'
//plugins {
//    id 'com.android.library'
//}
android {
    compileSdkVersion 30//项目的编译版本
    defaultConfig {
        applicationId "com.scc.demo"//包名
        minSdkVersion 23//最低的兼容的Android系统版本
        targetSdkVersion 30//目标版本，表示你在该Android系统版本已经做过充分的测试
        versionCode 1//版本号
        versionName "1.0.0"//版本名称
        ndk {
            abiFilters 'armeabi-v7a', 'arm64-v8a'
            //运行环境，要上传Google Play必须兼容64位，这里仅兼容ARM架构
            //对于ARM架构，32 位库位于armeabi-v7a 中。64 位等效项是arm64-v8a。
            //对于x86体系结构，查找x86（用于 32 位）和 x86_64（用于 64 位）。
        }
    }

    buildTypes {//配置了多个版本(设置自动打包环境)
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        //正常情况上面这个够用了，下面的用来了解

        //指定生成安装文件的配置，常有两个子包:release,debug，
        // 咱这边多一个子包，多一种配置方式
        // 注：直接运行的都是debug安装文件
        getByName("release") {
            minifyEnabled true//是否开启收缩、混淆、优化，true开启
            shrinkResources = true // 是否开启资源收缩 ，true开启
            //applicationIdSuffix 未设置默认包名 applicationId "com.scc.demo"
            proguardFiles(getDefaultProguardFile("proguard-android.txt"), "proguard-rules.pro")
        }

        getByName("debug") {
            applicationIdSuffix = ".debug"//打包后会变成com.scc.demo.debug
            minifyEnabled false
        }
        /**
         * initWith 属性允许您从其他生成类型复制配置，
         */
        create("staging") {
            initWith(getByName("debug"))
            applicationIdSuffix = ".staging"
        }
    }
    //flavorDimensions多维度配置
    flavorDimensions "scc"
    productFlavors {
        create("demo") {
            // Assigns this product flavor to the "version" flavor dimension.
            // If you are using only one dimension, this property is optional,
            // and the plugin automatically assigns all the module's flavors to
            // that dimension.
            dimension = "scc"
            applicationIdSuffix = ".demo"
            versionNameSuffix = "-demo"
        }
        create("full") {
            dimension = "scc"
            applicationIdSuffix = ".full"
            versionNameSuffix = "-full"
        }
    }
    //指定jdk版本
    //设置代码编译的版本，一般是在使用JDK1.8时，配置这个，使编译出来的jar包让别人使用时更通用
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

dependencies {//指定当前项目的所有依赖关系：本地依赖、库依赖、远程依赖
    //本地测试，声明测试用列库
    testImplementation 'junit:junit:4.+'
    //androidTestImplementation仅为测试APK添加远程依赖项。
    androidTestImplementation 'androidx.test.ext:junit:1.1.2'
    //库依赖：（跟app同级文件的项目）
    implementation(project(":mylibrary"))
    //本地依赖：Gradle在项目app/libs/目录中声明对jar文件的依赖
    //（因为 Gradle读取相对于build.gradle文件的路径）。
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    //或者，你可以按如下方式指定单个文件
    implementation(name: 'app-release11', ext: 'aar')
    implementation files('libs/scc.jar', 'libs/stt.jar')
    //注意：像这样的远程依赖项要求你声明适当的远程存储库，Gradle 应在其中查找库。
    // 远程依赖：如果该库在本地尚不存在，则 Gradle 会在构建需要时（例如，当你单击将项目与 Gradle 文件同步 或运行构建时）
    // 从远程站点拉取它。
    //全称应为implementation group: 'com.android.billingclient',
    // name: 'billing', version: '3.0.0'
    implementation 'com.android.billingclient:billing:3.0.0'

}
//声明是要使用谷歌服务框架（这个一般放在gradle最下面）
apply plugin: 'com.google.gms.google-services'

compileSdkVersion 和 targetSdkVersion 区别

        compileSdkVersion 告诉 Gradle 用哪个 Android SDK 版本编译你的应用。使用任何新添加的 API 就需要使用对应等级的 Android SDK。需要强调的是修改 compileSdkVersion 不会改变运行时的行为。

        targetSdkVersion 是 Android 提供向前兼容的主要依据，在应用的 targetSdkVersion 没有更新之前系统不会应用最新的行为变化。这允许你在适应新的行为变化之前就可以使用新的 API。compileSdkVersion 不能小于 targetSdkVersion 。

四、signing应用签名

        构建系统使你能够在构建配置中指定签名设置，并且可以在构建过程中自动对你的 APK 进行签名。构建系统使用已知凭据使用默认密钥和证书对调试版本进行签名，以避免在构建时出现密码提示。除非你明确定义此构建的签名配置，否则构建系统不会对发布版本进行签名。

1、按照图上步骤进行操作，操作栏中选择Build>Generate signed Bundle or apk>...

 2、根据步骤3生成的是aab文件，需要上传到谷歌，谷歌会生成相应的apk文件供用户下载

        选中内容在上传aab到谷歌时需要用到下面省的内容。

        已有jks文件就如下图显示，没有jks的>点击Create new...按要求填写即可

3、直接生成apk文件,已有jks文件就如上图显示，没有点击Create new...按要求填写即可

  

五、app/builde.gradle拓展

        dependencies

        构建系统管理来自本地文件系统和远程存储库的项目依赖项。这可以防止你必须手动搜索、下载和复制依赖项的二进制包到你的项目目录中。

        指定依赖项时，不应使用动态版本号，例如'com.android.tools.build:gradle:3.+'. 使用此功能可能会导致意外的版本更新和难以解决版本差异。

        代码和资源缩减

        当你使用Android Gradle插件3.4.0或更高版本构建项目时 ，该插件不再使用 ProGuard 来执行编译时代码优化。相反，该插件与R8 编译器一起处理以下编译时任务：

        代码收缩：检测并安全地从你的应用程序及其库依赖项中删除未使用的类、字段、方法和属性（使其成为解决64K引用限制的宝贵工具 ）。例如，如果你只使用库依赖项的几个 API，收缩可以识别你的应用程序未使用的库代码，并仅从你的应用程序中删除该代码。

        资源收缩：从打包的应用程序中删除未使用的资源，包括应用程序库依赖项中未使用的资源。它与代码收缩一起工作，这样一旦删除了未使用的代码，也可以安全地删除不再引用的任何资源。

        混淆：缩短类和成员的名称，从而减少 DEX 文件大小。

        优化：检查并重写你的代码以进一步减小应用 DEX 文件的大小。例如，如果 R8 检测到else {} 给定 if/else 语句的分支从未被采用，R8 将删除该else {}分支的代码。

        压缩你的代码

        当你将该minifyEnabled 属性设置为true。代码收缩（也称为摇树）是删除 R8 确定在运行时不需要的代码的过程。例如，如果你的应用程序包含许多库依赖项但仅使用其功能的一小部分，则此过程可以大大减少你的应用程序的大小。

下一节：UI组件之View