接触Android开发还是有些日子了,工作了也没时间写博客。最近静下心来总结下一些基础知识。
1.什么是build.gradle
1.AS是通过Gradle来构建项目的,Google推荐使用的Android Studio是采用Gradle来构建项目的。Gradle是一个非常先进的项目构建工具。
2.Gradle是用了一种基于Groovy的领域特定语言(DSL,Domain Specific Language)来声明项目设置,摒弃了XML(如ANT和Maven)的各种繁琐配置。
3.项目中一般会出现2个或者多个build.gradle文件,一个在根目录下,一个在app目录下。
如果切换到Android模式下则全部在Gradle Scripts。
而project模式下则略有不同。
2.根目录下的build.gradle
buildscript { repositories { //repositories闭包 google() jcenter() //代码托管库:设置之后可以在项目中轻松引用jcenter上的开源项目 } dependencies { classpath "com.android.tools.build:gradle:4.0.1" //gradle是一个强大的项目构建工具,不仅可以构建Android,还可以构建java,C++等 } } allprojects { repositories { google() jcenter() } } task clean(type: Delete) { delete rootProject.buildDir }
1 > 两处的repositories闭包,声明了jcenter()和google()的配置,google()一般都是Google自家的依赖库,而Jcenter大多数是第三方的开源库。
2 > dependencies闭包,声明了一个Gradle插件
3.app 目录下的build.gradle
apply plugin: 'com.android.application' android { compileSdkVersion 30 buildToolsVersion "30.0.1" defaultConfig { applicationId "com.example.myapplication" minSdkVersion 16 targetSdkVersion 30 versionCode 1 versionName "1.0" testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner" } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } } } dependencies { implementation fileTree(dir: "libs", include: ["*.jar"]) implementation 'androidx.appcompat:appcompat:1.1.0' implementation 'androidx.constraintlayout:constraintlayout:1.1.3' testImplementation 'junit:junit:4.12' androidTestImplementation 'androidx.test.ext:junit:1.1.1' androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0' }
1.apply plugin,声明是Android应用程序还是库模块 'com.android.application'为应用程序 'com.android.library'为库模块,只能作为代码库依附于其他的应用程序上面。
apply plugin: 'com.android.application' 作为app运行
apply plugin: 'kotlin-android' 可使用kotlin语言开发Android
apply plugin: 'kotlin-android-extensions' 插件 kotlin扩展功能
2.android 闭包,配置项目构建的各种属性,compileSdkVersion用于指定项目的编译SDK版本,buildToolsVersion用于指定项目构建工具的版本。
defaultConfig闭包:默认配置,应用程序包名,最小 sdk 版本,目标 sdk 版本,版本号,版本名
buildTypes闭包:指定生成安装文件的配置,是否对代码进行混淆
signingConfigs 闭包:签名信息配置 (指定生成安装文件的配置,常有两个子包:release,debug,注:直接运行的都是debug安装文件)
sourceSets 闭包:源文件路径配置
lintOptions 闭包:lint 配置...(* ̄0 ̄)ノ
3.dependencies 闭包,指定当前项目的所有依赖关系,本地依赖,库依赖以及远程依赖
2020.09.29 更新
gradle文件实例详解
1 // 声明是Android程序, 2 // com.android.application 表示这是一个应用程序模块,可直接运行 3 // com.android.library 标识这是一个库模块,是依附别的应用程序运行 4 apply plugin: 'com.android.application' 5 6 android { 7 // 程序在编译的时候会检查lint,有任何错误提示会停止build,我们可以关闭这个开关 8 lintOptions { 9 // 即使报错也不会停止打包 10 abortOnError false 11 // 打包release版本的时候是否进行检测 12 checkReleaseBuilds false 13 } 14 15 // 编译sdk的版本,也就是API Level,例如API-19、API-20、API-21等等。 16 compileSdkVersion 27 17 // build tools的版本,其中包括了打包工具aapt、dx等等。 18 // 这个工具的目录位于你的sdk目录/build-tools/下 19 buildToolsVersion '27.0.3' 20 21 //关闭Android Studio的PNG合法性检查 22 aaptOptions.cruncherEnabled = false 23 aaptOptions.useNewCruncher = false 24 25 defaultConfig { // 默认配置 26 applicationId "com.demo.test" // 应用程序的包名 27 minSdkVersion 22 / 最小sdk版本,如果设备小于这个版本或者大于maxSdkVersion将无法安装这个应用 28 targetSdkVersion 27 // 目标sdk版本,充分测试过的版本(建议版本) 29 versionCode 1 // 版本号,第一版是1,之后每更新一次加1 30 versionName "1.0" // 版本名,显示给用户看到的版本号 31 32 archivesBaseName = "demo-$versionName" // 指定打包成Jar文件时候的文件名称 33 ndk { 34 moduleName "testwifisafe" // 设置库(so)文件名称 35 ldLibs "log", "z", "m", "jnigraphics", "android" 36 // 引入库,比如要用到的__android_log_print 37 abiFilters "armeabi", "x86", "armeabi-v7a" // "x86" 显示指定支持的ABIs 38 cFlags "-std=c++11 -fexceptions" // C++11 39 stl "gnustl_static" 40 } 41 42 // 当方法数超过65535(方法的索引使用的是一个short值, 43 // 而short最大值是65535)的时候允许打包成多个dex文件,动态加载dex。这里面坑很深啊 44 multiDexEnabled true 45 46 // Instrumentation单元测试 47 testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner" 48 } 49 50 // 默认的一些文件路径的配置 51 sourceSets { 52 main { 53 manifest.srcFile 'AndroidManifest.xml' // 指定清单文件 54 res.srcDirs = ['res'] // 指定res资源目录 55 assets.srcDirs = ['assets'] // asset资源目录 56 jni.srcDirs 'src/main/jni' // jni代码目录 57 jniLibs.srcDir 'src/main/jniLibs' // jni库目录 58 java.srcDirs = ['src'] // 指定java源代码目录 59 resources.srcDirs = ['src'] // 指定resource目录 60 aidl.srcDirs = ['src'] // 指定aidl目录 61 renderscript.srcDirs = ['src'] // 指定source目录 62 } 63 debug.setRoot('build-types/debug') // 指定debug模式的路径 64 release.setRoot('build-types/release') // 指定release模式的路径 65 } 66 67 // multiDex的一些相关配置,这样配置可以让你的编译速度更快 68 dexOptions { 69 // 让它不要对Lib做preDexing 70 preDexLibraries = false 71 // 开启incremental dexing,优化编译效率,这个功能android studio默认是关闭的。 72 incremental true 73 javaMaxHeapSize "4g" // 增加java堆内存大小 74 } 75 76 signingConfigs {// 签名配置 77 release {// 发布版签名配置 78 storeFile file("fk.keystore") // 密钥文件路径 79 storePassword "123456" // 密钥文件密码 80 keyAlias "fk" // key别名 81 keyPassword "123456" // key密码 82 } 83 debug {// debug版签名配置 84 storeFile file("fk.keystore") 85 storePassword "123456" 86 keyAlias "fk" 87 keyPassword "123456" 88 } 89 } 90 91 // 指定生成安装文件的配置,常有两个子包:release,debug,注:直接运行的都是debug安装文件 92 buildTypes { 93 // release版本的配置,即生成正式版安装文件的配置 94 release { 95 zipAlignEnabled true // 是否支持zip 96 shrinkResources true // 移除无用的resource文件 97 minifyEnabled false // 是否对代码进行混淆,true表示混淆 98 // 指定混淆时使用的规则文件; 99 // proguard-android.txt指所有项目通用的混淆规则,proguard-rules.pro当前项目特有的混淆规则 100 // release的Proguard默认为Module下的proguard-rules.pro文件 101 proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' 102 debuggable false //是否支持调试 103 //ndk的一些配置 104 ndk { 105 // cFlags "-std=c++11 -fexceptions -O3 -D__RELEASE__" // C++11 106 // platformVersion = "19" 107 moduleName "hebbewifisafe" // 设置库(so)文件名称 108 ldLibs "log", "z", "m", "jnigraphics", "android" 109 // 引入库,比如要用到的__android_log_print 110 abiFilters "armeabi", "x86", "armeabi-v7a"// "x86" 111 cFlags "-std=c++11 -fexceptions" // C++11 112 stl "gnustl_static" 113 } 114 // 采用动态替换字符串的方式生成不同的 release.apk (3.0之后版本的修改方式) 115 applicationVariants.all { variant -> 116 variant.outputs.all { output -> 117 if (!variant.buildType.isDebuggable()) {118 // 获取签名的名字 variant.signingConfig.name119 // 要被替换的源字符串120 def sourceFile = "app-release"; 121 // 替换的字符串122 def replaceFile = "Demo-V${variant.versionName}.${releaseTime()}"123 outputFileName = output.outputFile.name.replace(sourceFile, replaceFile) 124 } 125 } 126 } 127 jniDebuggable false // 关闭jni调试 128 } 129 debug { // debug版本的配置 130 minifyEnabled false 131 zipAlignEnabled true 132 shrinkResources true // 移除无用的resource文件 133 proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' 134 debuggable true 135 // jniDebuggable true 136 ndk { 137 cFlags "-std=c++11 -fexceptions -g -D __DEBUG__" // C++11 138 } 139 jniDebuggable true 140 } 141 } 142 143 packagingOptions { 144 exclude 'META-INF/ASL2.0' 145 exclude 'META-INF/LICENSE' 146 exclude 'META-INF/NOTICE' 147 exclude 'META-INF/MANIFEST.MF' 148 } 149 150 compileOptions { 151 // 在这里你可以进行 Java 的版本配置, 152 // 以便使用对应版本的一些新特性 153 } 154 productFlavors { 155 // 在这里你可以设置你的产品发布的一些东西, 156 // 比如你现在一共软件需要发布到不同渠道, 157 // 且不同渠道中的包名不同,那么可以在此进行配置; 158 // 甚至可以设置不同的 AndroidManifest.xml 文件。 159 hebbe { 160 } 161 googlePlay { 162 } 163 solo { 164 } 165 } 166 productFlavors.all { 167 flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name] 168 } 169 // 所谓ProductFlavors其实就是可定义的产品特性, 170 // 配合 manifest merger 使用的时候就可以达成在一次编译 171 // 过程中产生多个具有自己特性配置的版本。 172 // 上面这个配置的作用就是,为每个渠道包产生不同的 UMENG_CHANNEL_VALUE 的值。 173 } 174 175 // 指定当前项目的所有依赖关系:本地依赖、库依赖、远程依赖 176 // 本地依赖:可以对本地 Jar 包或目录添加依赖关系 177 // 库依赖:可以对项目中的库模块添加依赖关系 178 // 远程依赖:可以对 jcenter 库上的开源项目添加依赖 179 // 标准的远程依赖格式是 域名:组织名:版本号 180 dependencies { 181 implementation fileTree(dir: 'libs', include: ['*.jar']) // 本地依赖 182 // 远程依赖,com.android.support是域名部分,appcompat-v7是组名称,26.1.0是版本号 183 implementation 'com.android.support:appcompat-v7:26.1.0' 184 implementation 'com.android.support.constraint:constraint-layout:1.0.2' 185 implementation project(':hello') // 库依赖 186 testImplementation 'junit:junit:4.12' // 声明测试用列库 187 androidTestImplementation 'com.android.support.test:runner:1.0.1' 188 androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.1' 189 } 190 191 // 声明是要使用谷歌服务框架 192 apply plugin: 'com.google.gms.google-services' 193 194 // 第三方依赖库的本地缓存路径 195 task showMeCache << { 196 configurations.compile.each { println it } 197 } 198 // 使用maven仓库。android有两个标准的library文件服务器,一个jcenter一个maven。两者毫无关系。 199 // jcenter有的maven可能没有,反之亦然。 200 // 如果要使用jcenter的话就把mavenCentral()替换成jcenter() 201 repositories { 202 mavenCentral() 203 }204205 // 获取日期方法206 def releaseTime() {207 return new Date().format("MMdd.HHmm")208 }