Android Gradle 详解

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

一、什么是Gradle


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

image.png


二、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 进行签名。构建系统使用已知凭据使用默认密钥和证书对调试版本进行签名,以避免在构建时出现密码提示。除非你明确定义此构建的签名配置,否则构建系统不会对发布版本进行签名。

image.png


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


image.png


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


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


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

image.pngimage.png



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


 image.pngimage.png


五、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

相关文章
|
2月前
|
Android开发
Android基于gradle task检查各个module之间资源文件冲突情况
Android基于gradle task检查各个module之间资源文件冲突情况
Android基于gradle task检查各个module之间资源文件冲突情况
|
2月前
|
Android开发
Android gradle task任务检查各个module之间资源文件冲突.md
Android gradle task任务检查各个module之间资源文件冲突.md
Android gradle task任务检查各个module之间资源文件冲突.md
|
2月前
|
Java Android开发 Windows
玩转安卓之配置gradle-8.2.1
为安卓开发配置Gradle 8.2.1,包括下载和解压Gradle、配置环境变量、修改配置文件以增加国内镜像,以及在Android Studio中配置Gradle和JDK的过程。
114 0
玩转安卓之配置gradle-8.2.1
|
4月前
|
Android开发
Android Studio: 解决Gradle sync failed 错误
本文介绍了解决Android Studio中出现的Gradle同步失败错误的步骤,包括从`gradle-wrapper.properties`文件中获取Gradle的下载链接,手动下载Gradle压缩包,并替换默认下载路径中的临时文件,然后重新触发Android Studio的"Try Again"来完成同步。
1818 0
Android Studio: 解决Gradle sync failed 错误
|
4月前
|
Java 开发工具 Maven
Flutter和Android中覆盖gradle中的repositories仓库地址
Flutter和Android中覆盖gradle中的repositories仓库地址
226 4
|
4月前
|
Android开发 Kotlin
The Android Gradle plugin supports only Kotlin Gradle plugin version 1.3.10 and higher
The Android Gradle plugin supports only Kotlin Gradle plugin version 1.3.10 and higher
121 3
|
4月前
|
Java 开发工具 Android开发
Android Studio利用Build.gradle导入Git commit ID、Git Branch、User等版本信息
本文介绍了在Android Studio项目中通过修改`build.gradle`脚本来自动获取并添加Git的commit ID、branch名称和用户信息到BuildConfig类中,从而实现在编译时将这些版本信息加入到APK中的方法。
102 0
|
4月前
|
IDE API 开发工具
与Android Gradle Plugin对应的Gradle版本和Android Studio版本
与Android Gradle Plugin对应的Gradle版本和Android Studio版本
521 0
|
4月前
|
Android开发
解决Android、Flutter编译时Gradle报错:javax.net.ssl.SSLException: Connection reset
解决Android、Flutter编译时Gradle报错:javax.net.ssl.SSLException: Connection reset
503 0
|
6月前
|
C# Android开发 开发者
Android gradle编译时字节码处理
Android gradle编译时字节码处理
100 1