Android 基础知识总结(一) build.gradle文件

简介: Android 基础知识总结(一) build.gradle文件

接触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。


f92e7dae2cbd9847840bdd1c3176606.png


而project模式下则略有不同。


8cf18a5563ec6032cf2363a8bac6704.png


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 }


相关文章
|
2月前
|
Android开发
Android基于gradle task检查各个module之间资源文件冲突情况
Android基于gradle task检查各个module之间资源文件冲突情况
Android基于gradle task检查各个module之间资源文件冲突情况
|
2月前
|
ARouter Android开发
Android不同module布局文件重名被覆盖
Android不同module布局文件重名被覆盖
|
4月前
|
Java Android开发 C++
Android Studio JNI 使用模板:c/cpp源文件的集成编译,快速上手
本文提供了一个Android Studio中JNI使用的模板,包括创建C/C++源文件、编辑CMakeLists.txt、编写JNI接口代码、配置build.gradle以及编译生成.so库的详细步骤,以帮助开发者快速上手Android平台的JNI开发和编译过程。
326 1
|
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的过程。
103 0
玩转安卓之配置gradle-8.2.1
|
2月前
|
ARouter Android开发
Android不同module布局文件重名被覆盖
Android不同module布局文件重名被覆盖
152 0
|
4月前
|
Android开发
Android Studio: 解决Gradle sync failed 错误
本文介绍了解决Android Studio中出现的Gradle同步失败错误的步骤,包括从`gradle-wrapper.properties`文件中获取Gradle的下载链接,手动下载Gradle压缩包,并替换默认下载路径中的临时文件,然后重新触发Android Studio的"Try Again"来完成同步。
1690 0
Android Studio: 解决Gradle sync failed 错误
|
4月前
|
存储 监控 数据库
Android经典实战之OkDownload的文件分段下载及合成原理
本文介绍了 OkDownload,一个高效的 Android 下载引擎,支持多线程下载、断点续传等功能。文章详细描述了文件分段下载及合成原理,包括任务创建、断点续传、并行下载等步骤,并展示了如何通过多种机制保证下载的稳定性和完整性。
136 0
|
Java 开发工具 Android开发
Cocos Creator 2.4.6 Android Gradle 版本升级为 6.5.1(插件4.1.0)
Cocos Creator 2.4.6 Android Gradle 版本升级为 6.5.1(插件4.1.0)
329 1
|
Android开发
Android Studio中修改gradle插件版本和Gradle版本
Android项目中,我们一般要设置gradle插件版本和gradle版本。 项目根目录下的build.gradle文件中,通过classpath可以指定gradle插件的版本。