一、什么是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 确定在运行时不需要的代码的过程。例如,如果你的应用程序包含许多库依赖项但仅使用其功能的一小部分,则此过程可以大大减少你的应用程序的大小。