Android-Gradle详解

Posted 帅次

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Android-Gradle详解相关的知识,希望对你有一定的参考价值。

        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

以上是关于Android-Gradle详解的主要内容,如果未能解决你的问题,请参考以下文章

Flutter Android-Gradle任务bundleRelease失败,退出代码为1

Android-Gradle

Android-Gradle-概念及基础

Android-Gradle插件版本对应的Gradle版本

(转) Java中的负数及基本类型的转型详解

详解Android WebView加载html片段