美文网首页
gradle在Android中的使用

gradle在Android中的使用

作者: 卓码 | 来源:发表于2018-06-13 16:59 被阅读0次

    参考https://www.jianshu.com/p/8b8a550246bd,整理为自己需要的方便查看

    App

    settings.gradle

    配置Project和module

    include ':app' , ':module1',':module2'

    build.gradle

    buildscript

    gradle自身所使用的资源。可以声明的资源包括依赖项、第三方插件、仓库地址等

    repositories

    仓库 jcenter()、maven()和google()等

    dependencies

    配置依赖 classpath:'group:name:version'

    ext

    自定义属性

    • 只在当前配置文件使用的,在当前文件定义 ext.xxx_name='xxx',使用的时候$xxx_name获取值
    • 通用自定义配置,单独定义文件ext{xxx_1='xxx'} 在需要使用的文件中 apply from: '文件名',使用${xxx_1}获取值

    allprojects

    为所有项目提供共同所需依赖包

    task

    task clean(type: Delete) {
        delete rootProject.buildDir
    }
    

    运行gradle clean时,执行此处定义的task,删除根目录中的build目录

    Module

    每个module都有一个build.gradle文件

    build.gradle

    这里主要就是dependencies,和一些plugin。主要介绍下plugin,以'com.android.application'插件为例

    plugin

    apply plugin:'×××': 二进制插件,一般都是被打包在一个jar里独立发布的

    apply from:'×××':应用脚本插件,其实就是把这个脚本加载进来

    插件的作用

    • 添加一些task,帮助完成一些工作
    • 添加一些依赖
    • 给现有对象添加一些扩展,android{}这个配置块就是Android Gradle插件为Project对象添加的一个扩展
    • 对项目进行一些约定,比如应用Java插 件之后,约定src/main/java目录下是我们的源代码存放位置

    com.android.application插件

    android{} 是Android插件提供的一个扩展类型,可以让我们自定义Android Gradle工程,是Android Gradle工程配置的唯一入口。下面列举一下主要的配置项。

    1. compileSdkVersion 是编译所依赖的Android SDK的版本,这里是API Level。
    2. buildToolsVersion 是构建该Android工程所用构建工具的版本。
    3. defaultConfig{} 它是一个ProductFlavor的默认的配置,后面会介绍ProductFlavor
          1. applicationId 包名,app的唯一标识。跟AndroidManifest里面的package是可以不同的。package指的是代码目录下路径;applicationId指的是app对外发布的唯一标识,会在签名、申请第三方库、发布时候用到。
          
          2. minSdkVersion 是支持的Android系统的api level
          
          3. targetSdkVersion 基于哪个Android版本开发的
          
          4. versionCode app应用内部版本号,一般用于控制app升级
          
          5. versionName app应用的版本名称,一般是发布的时候写在app上告诉用户的
          
          6. multiDexEnabled 是否启用自动拆分多个Dex的功能
          
          7. ndk{} 多平台编译,生成有so包的时候使用,包括四个平台'armeabi', 'x86', 'armeabi-v7a', 'mips'
          
          8. flavorDimensions 定义需要定制化的字段,然后在productFlavors中使用
    
    1. sourceSets 源代码集合,是Java插件用来描述和管理源代码及资源的一个抽象概念,是一个Java源代码文件和资源文件的集合,我们可以通过sourceSets更改源集的Java目录或者资源目录等。
    2. buildTypes 构建类型,内置了debug和release两个构建类型,一般用在代码混淆
           name:build type的名字
           applicationIdSuffix:应用id后缀
           versionNameSuffix:版本名称后缀
           debuggable:是否生成一个debug的apk
           minifyEnabled:是否混淆
           proguardFiles:混淆文件
           signingConfig:签名配置
           manifestPlaceholders:清单占位符
           shrinkResources:是否去除未利用的资源,默认false,表示不去除。
           zipAlignEnable:是否使用zipalign工具压缩。
           multiDexEnabled:是否拆成多个Dex
           multiDexKeepFile:指定文本文件编译进主Dex文件中
           multiDexKeepProguard:指定混淆文件编译进主Dex文件中
    
    1. signingConfigs 签名配置。一个app只有在签名之后才能被发布、安装、使用,签名是保护app的方式,标记该app的唯一性。
           storeFile: 签名文件
           storePassword: 签名证书文件的密码
           storeType: 签名证书类型
           keyAlias: 签名证书中秘钥别名
           keyPassword: 签名证书中改密钥的密码
    
    1. productFlavors Gradle的多渠道打包,你可以在不同的包定义不同的变量,实现自己的定制化版本的需求。
           defaultConfig 中定义的 flavorDimensions
           manifestPlaceholders 占位符,我们可以通过它动态配置AndroidManifest文件一些内容,譬如app的名字
           buildConfigField 是BuildConfig文件的一个函数,而BuildConfig这个类是Android Gradle构建脚本在编译后生成的,而buildConfigField就是其中的自定义函数变量
           定义常量 buildConfigField "boolean","isTest","true" 
           就会在BuildConfig类中添加一个变量 public static final boolean isTest = true
           然后我们就可以在代码中使用   BuildConfig.isTest
    
    1. dexOptions{} dx命令只是一个脚本,它调用的还是Java编写的dx.jar库,是Java程序处理的,所以当内存不足的时候,就会内存溢出。给dx分配的内存是一个G,给它增加内存分配来解决这个问题。

      dexOptions {
          javaMaxHeapSize "2g"
          incremental = true
      }
      

    dependencies{}

    • compile fileTree(include: ['.jar'], dir: 'libs')* 依赖本地libs文件夹下的扩展名为jar
    • compile project('×××') 引入某个本地module
    • compile group:name:version

    gradle 3.0中依赖implementation、api的区别

    • api跟以前的compile没什么区别,指令依赖会传递,只需要引入一次,其它module不用再次引入
    • implementation指令依赖是不会传递的,也就是说当前引用的第三方库仅限于本module内使用

    相关文章

      网友评论

          本文标题:gradle在Android中的使用

          本文链接:https://www.haomeiwen.com/subject/qftseftx.html