Android中gradle使用教程

在我们编写Android代码的时候,引入第三方库,配置Android插件,打包apk命名,配置仓库地址,都需要在build.gradle中编写相应代码,我们可能对dependencies中做第三方依赖,发版本更改versionCode与versionName知道如何处理,但是具体详细使用该如何呢?那就让我们一起来探究吧。

背景

gradle语法是基于Groovy语言,Groovy是一种敏捷的动态语言,既可以面向对象编程,又可以用作纯粹的脚本语言,其运行在JVM上,能够与java代码很好的结合,也能扩展现有代码。

Gradle wrapper

当我们打开gradle-wrapper.properties文件,查看配置信息:

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-4.6-all.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

通过配置项我们可以发现,当前项目使用的gradle版本,配置目录,它会根据以上配置目录下载到user/.gradle/wrapper/dists目录下,
Gradle Wrapper作用是允许你在没有安装 Gradle 的机器上执行 Gradle 构建,对客户端计算机零配置,减少兼容性问题。

build.gradle

build.gradle文件分别在项目目录下和对应module目录都存在,它们的存在承担不同的功能。

buildscript {
    
    repositories {
        google()
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.2.0'
    }
}

allprojects {
    repositories {
        google()
        jcenter()
    }
}

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

在project目录下的文件主要是配置仓库地址,配置插件,当我们新建项目时,可能我们会疑惑为什么会有两个repositories配置项,它们有什么区别吗?下面我们来解惑。

首先,buildscript 声明是gradle脚本自身需要使用的资源,包含插件所在的仓库地址,插件依赖。例如:

classpath 'com.android.tools.build:gradle:3.2.0

这是我们Android执行task任务所必需的插件地址。

  • 打开现有应用模块的 build.gradle 文件

    apply plugin: 'com.android.application
    

    以上代码作为Android应用程序入口,我们需要plugin提供的编译、测试、打包所有tasks。

  • 打开libray中的build.gradle文件

    apply plugin: 'com.android.library'
    

    这个是将当前module打包成aar文件的任务,不是打包成一个apk文件,当我们打开Android studio右侧面板的gradle,可以清晰的看见,每个module的task任务,作为入口module和library,在执行gradle assembleRelaese 时,入口modlue会打包成apk文件,而library会打包成aar文件。

  • allprojects

    在这个节点下定义的属性会被运用到所有的module中,包含依赖的仓库,依赖地址。

    当我们出现重复的support包,我们可以在此强制依赖,例如:

    allprojects {
    repositories {
        google()
        jcenter()
    }
    configurations.all {
        resolutionStrategy.eachDependency { DependencyResolveDetails details ->
            def requested = details.requested
            if (requested.group == 'com.android.support') {
                if (!requested.name.startsWith("multidex")) {
                    details.useVersion rootProject.ext.supportVersion
                }
            }
        }
        resolutionStrategy{
            force 'com.google.code.gson:gson:2.8.5'
        }
    }
    }
    

当我们看完project下的build.gradle文件,那我们再来看看项目入口module下的build.gradle文件。

apply plugin: 'com.android.application'

android {

     compileSdkVersion 28
     defaultConfig{
        applicationId "com.bestpay.android.myapplication"
        minSdkVersion 15
        targetSdkVersion 28
        versionCode 1
        versionName "1.0"
     }

     buildTypes {
        release {
            minifyEnabled true
            zipAlignEnabled true
            shrinkResources true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        debug{
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
    signingConfigs {
        keyAlias '******'
        keyPassword '******'
        storeFile file('Key.jks')
        keyPassword '******'
    }
    productFlavors{
        
    }

}

dependencies{
    implementation fileTree(dir: 'libs', include: ['*.jar'])
    implementation 'com.android.support:appcompat-v7:28.0.0'
}

通过以上代码,我们查看Android主要设置。

  • defaultConfig 默认配置
  • signingConfig 签名相关
  • buildTypes 构建变体
  • productFlavors 产品风格
  • sourceSets 源集配置

接下来我们来查看这些属性使用方式:

sourceSets

Android studio默认创建(app/src/main)作为代码,资源配置目录,也可以制定给其他目录为配置项


图1
    sourceSets{
        main{
            res.srcDirs = ['src/custom/res','src/main/res']
            java.srcDirs = ['src/main/java']
            manifest.srcFile 'src/main/AndroidManifest.xml'
            assets.srcDirs=['src/custom/assets']
        }
    }

gradle.properties

这个是一个本地文件,存储一些个人配置,例如gradle运行是否并行,gradle的jvmargs大小、是否开启daemon

local.properties

本地文件,存储个人信息,sdk,ndk路径等。

setting.gradle

通过include相应module名称。

Android自带Task命令

打开Android studio右侧面板,查看gradle命令,让我们来查看具体命令使用场景。


图2
  • AndroidDependencies 查看app module下所依赖得第三方库,以及库中依赖得子库
图3
  • siningReport 显示渠道包得签名信息

  • sourceSets 查看项目java ,res ,jni所在得资源位置

  • assembleDebug 打包所有应用程序debug包

  • assembleRelease 打包所有应用程序release包

  • build 打包所有,包括测试项内容

  • clean 删除构建build目录

  • cleanBuildCache 删除构建的缓存目录

  • buildEnvironment app module中声明的所有buildscript依赖项。

  • installDebug 安装Debug版本

  • uninstallDebug - 卸载Debug版本

Android gradle插件与gradle版本关系

当我们在根build.gradle引入gradle任务执行得插件时,插件对应gradle最低版本,以下是具体对应关系:

图4

参考文献:http://tools.android.com/tech-docs/new-build-system/user-guide#TOC-Why-Gradle-

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容

  • 版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/zhaoyanj...
    勤奋的pangdunhu阅读 2,011评论 0 1
  • 1.介绍 如果你正在查阅build.gradle文件的所有可选项,请点击这里进行查阅:DSL参考 1.1新构建系统...
    Chuckiefan阅读 12,115评论 8 72
  • 在 Android Studio 构建的项目中,基于 Gradle 进行项目的构建,同时使用 Android DS...
    Ant_way阅读 7,322评论 0 16
  • 什么是gradle Gradle 是新一代的自动化构建工具,它是一个独立的项目,跟 AS、Android 无关,官...
    Boreas_su阅读 3,965评论 0 4
  • 天下没有不散的筵席 田方清病了。低烧,卧床不起,嘴里还时不时的在嘟囔着什么。这可急坏了田灵儿和肖遥。两个对医术一窍...
    luozi阅读 379评论 0 0