Android Gradle开发指南详解

Gradle简介

Gradle 是一个优秀的构建系统和构建工具,它允许通过插件创建自定义的构建逻辑。它具有如下一些特点:

  • 采用了 Domain Specific Language(DSL 语言) 来描述和控制构建逻辑。
  • 构建文件基于 Groovy,并且允许通过混合声明 DSL 元素和使用代码来控制 DSL 元素以控制自定义的构建逻辑。
  • 支持 Maven 或者 Ivy 的依赖管理。
  • 非常灵活。允许使用最好的实现,但是不会强制实现的方式。
  • 插件可以提供自己的 DSL 和 API 以供构建文件使用。
  • 良好的 API 工具供 IDE 集成。

使用Gradle方式来构建项目,主要是为了达到如下的一些目的:

  • 让重用代码和资源变得更加容易
  • 让创建同一应用程序的不同版本变得更加容易,无论是多个 apk 发布版本还是同一个应用的不同定制版本
  • 让构建过程变得更加容易配置,扩展和定制。
  • 整合优秀的 IDE。

构建项目基础

文件构建

一个Gradle项目的构建过程定义在build.gradle文件中,位于项目的根目录下。一个最简单的Gradle纯Java项目的build.gradle文件包含以下内容。

apply plugin: 'java'

上面的代码是引入了Gradle的Java插件,这个插件提供了所有构建和测试Java应用程序所需要的东西。例如,下面是一个最简单的Android项目的build.gradle文件的源代码。

buildscript {
  repositories {
    google()
    jcenter()

  }
  dependencies {
    classpath 'com.android.tools.build:gradle:3.4.1'
  }
}

allprojects {
  repositories {
    google()
    jcenter()

  }
}

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

build.gradle文件

在一个Android项目中一般会出现至少2个build.gradle文件,一个是project的gradle文件,一个是app module的gradle文件。

gradle文件中会涉及很多的常用命令和代码,它们的具体含义如下:

1.jcenter()

代码托管库,设置后可以在项目中引用jcenter上的开源项目,声明在build.gradle文件的repositories闭包中。

2.gradle插件及版本号

经常会看到如下一段代码:

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

3.Android 闭包配置

在build.gradle的Android闭包中会看到一些常用的配置,如下所示:

  • compileSdkVersion: 用于指定项目的编译版本。
  • buildToolsVersion: 用于指定项目的构建工具的版本。
  • applicationId: 用于指定项目的包名,在创建项目的时候已经指定了包名,当要修改整个项目的包名时可以在此更改。
  • minSdkVersion: 项目最低的兼容版本。
  • targetSdkVersion:表示你在该目标版本上已经做过了充分的测试,系统将为你的应用开启一些最新的功能和特性。假如targetSdkVersion 为23或者更高,那么在Android6.0中运行这个应用时会开启新的功能和特性;若设置成了22,只能说明你的应用程序在Android5.1系统上做过了充分的测试,Android6.0的新功能就不会启用。
  • versionCode: 项目的版本号。
  • versionName: 项目版本号的版本名。

4.buildTypes闭包

此配置包一般会包含两个闭包配置,一个是debug,一个release;当然也可以有其他闭包。debug闭包用于生成测试版安装文件的配置,release闭包用于生成正式版安装文件的配置。此文件的配置如下:

  • minifyEnabled:用于设置是否对项目的代码进行混淆。true代表开启,false代表关闭。
  • proguardFiles:指定混淆时使用的文件。
  • proguard-android.txt:在Android SDK 目录下的,里面是所有项目通用的混淆规则。
  • proguard-rules.pro:是在当前项目根目录下的,里面编写当前项目特有的混淆规则。

5.dependencies闭包

Android Studio 项目开发中一共有三种依赖方式:本地依赖、库依赖和远程依赖。

  • 本地依赖:可以对本地的Jar包或目录添加依赖关系。
  • 库依赖:可以对项目中的库模块添加依赖关系。
  • 远程依赖:=可以对jcenter库上的开源项目添加依赖关系。

项目结构

Gradle遵循约定优先于配置的概念,在可能的情况尽可能提供合理的默认配置参数。Android基本的项目开始于两个名为“source sets”的组件,即main source code和test code。它们分别位于:src/main/和src/androidTest/文件中。
对于Java plugin和Android plugin来说,它们的Java源代码和资源文件路径如下:java/和resources/文件目录中。

对于Android plugin来说,它还拥有以下特有的文件和文件夹结构:

  • AndroidManifest.xml
  • res/
  • assets/
  • aidl/
  • rs/
  • jni/

配置结构

当默认的项目结构不适用的时候,你可能需要去自定义配置它。根据Gradle文档,重新为Java项目配置sourceSets可以使用以下方法:

sourceSets {
  main {
    java {
      srcDir 'src/java'
    }
    resources {
      srcDir 'src/resources'
    }
  }
}

当然,也可以使用如下的配置方式:

sourceSets {
  main.java.srcDirs = ['src/java']
  main.resources.srcDirs = ['src/resources']
}

Android Plugin使用的是类似的语法。但是由于它使用的是自己的sourceSets,这些配置将会被添加在android对象中。

以下是一个示例,它使用了旧项目结构中的main源码,并且将androidTestsourceSet组件重新映射到tests文件夹。

android {
  sourceSets {
    main {
      manifest.srcFile 'AndroidManifest.xml'
      java.srcDirs = ['src']
      resources.srcDirs = ['src']
      aidl.srcDirs = ['src']
      renderscript.srcDirs = ['src']
      res.srcDirs = ['res']
      assets.srcDirs = ['assets']
    }

    androidTest.setRoot('tests')
  }
}

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持我们。

(0)

相关推荐

  • Android App开发中Gradle构建过程的配置方法

    在build文件中使用了Android或者Java插件之后就会自动创建一系列可以运行的任务. Gradle中有如下一下默认约定的任务: 1. assemble 该任务包含了项目中的所有打包相关的任务,比如java项目中打的jar包,Android项目中打的apk 2. check 该任务包含了项目中所有验证相关的任务,比如运行测试的任务 3. build 该任务包含了assemble和check 4. clean 该任务会清空项目的所有的输出,删除所有在assemble任务中打的包 assemb

  • 详解如何使用Android Studio开发Gradle插件

    缘由 首先说明一下为什么会有这篇文章.前段时间,插件化以及热修复的技术很热,Nuwa热修复的工具NuwaGradle,携程动态加载技术DynamicAPK,还有希望做最轻巧的插件化框架的Small.这三个App有一个共同的地方就是大量的使用了Gradle这个强大的构建工具,除了携程的框架外,另外两个都发布了独立的Gradle插件提供自动化构建插件,或者生成热修复的补丁.所以学习一下Gradle插件的编写还是一件十分有意义的事. 插件类型 Gradle的插件一般有这么几种: 一种是直接在项目中的g

  • Android Gradle开发指南详解

    Gradle简介 Gradle 是一个优秀的构建系统和构建工具,它允许通过插件创建自定义的构建逻辑.它具有如下一些特点: 采用了 Domain Specific Language(DSL 语言) 来描述和控制构建逻辑. 构建文件基于 Groovy,并且允许通过混合声明 DSL 元素和使用代码来控制 DSL 元素以控制自定义的构建逻辑. 支持 Maven 或者 Ivy 的依赖管理. 非常灵活.允许使用最好的实现,但是不会强制实现的方式. 插件可以提供自己的 DSL 和 API 以供构建文件使用.

  • Android Gradle同步优化详解

    目录 动态修改gradle配置 hook agp ProjectsServices 方法签名检查是否存在support包 年初开始我们就开始了关于Gradle Sync阶段的优化.之前和大家都简单的介绍过工程相关的背景情况了,我们大概有400+的Module,然后一次的同步时间就非常的慢,我们迫切的需要对这个问题进行优化.大部分工作都是和团队内的同学一起完成的,我也只出了一点点力而已. 这次写文章真的很倒霉,之前忘了保存导致要重新开始写了.如果不是白嫖了掘金的端午礼盒,拿人手短啊,我已经打算鸽了

  • 微信小程序 开发指南详解

    编写代码 创建小程序实例 点击开发者工具左侧导航的"编辑",我们可以看到这个项目,已经初始化并包含了一些简单的代码文件.最关键也是必不可少的,是 app.js.app.json.app.wxss 这三个.其中,.js后缀的是脚本文件,.json后缀的文件是配置文件,.wxss后缀的是样式表文件.微信小程序会读取这些文件,并生成小程序实例. 下面我们简单了解这三个文件的功能,方便修改以及从头开发自己的微信小程序. ​ app.js是小程序的脚本代码.我们可以在这个文件中监听并处理小程序的

  • Android USB转串口通信开发实例详解

     Android USB转串口通信开发实例详解 好久没有写文章了,年前公司新开了一个项目,是和usb转串口通信相关的,需求是用安卓平板通过usb转接后与好几个外设进行通信,一直忙到最近,才慢慢闲下来,趁着这个周末不忙,记录下usb转串口通信开发的基本流程. 我们开发使用的是usb主机模式,即:安卓平板作为主机,usb外设作为从机进行数据通信.整个开发流程可以总结为以下几点: 1.发现设备 UsbManager usbManager = (UsbManager) context.getSystem

  • Android分包MultiDex策略详解

    1.分包背景 这里首先介绍下MultiDex的产生背景. 当Android系统安装一个应用的时候,有一步是对Dex进行优化,这个过程有一个专门的工具来处理,叫DexOpt.DexOpt的执行过程是在第一次加载Dex文件的时候执行的.这个过程会生成一个ODEX文件,即Optimised Dex.执行ODex的效率会比直接执行Dex文件的效率要高很多. 但是在早期的Android系统中,DexOpt有一个问题,DexOpt会把每一个类的方法id检索起来,存在一个链表结构里面.但是这个链表的长度是用一

  • 初学者Android studio安装图文详解

    学习过java基础,最近趁着大量课余时间想学习Android开发.百度很多资料Android studio,由Google开发的开发工具,那就不需要再多说.对于初学者的我来说,一定足够用了.此文主要介绍自己下载.安装.第一次使用遇到的问题. 开发环境 物理机:Windows8.1专业版 Android Studio 2.3.3.0 下载来源:Android Studio中文社区http://www.android-studio.org/(建议安装带有Android sdk的安装包) 下载好后按照

  • 基于Android RxCache使用方法详解

    前言 我为什么使用这个库? 事实上Android开发中缓存功能的实现选择有很多种,File缓存,SP缓存,或者数据库缓存,当然还有一些简单的库/工具类,比如github上的这个: [ASimpleCache]:a simple cache for android and java 但是都不是很好用(虽然可能学习成本比较低,因为它使用起来相对简单),我可能需要很多的静态常量来作为key存储缓存数据value,并设置缓存的有效期,这可能需要很多Java代码去实现,并且过程繁琐. 如果您使用的网络请求

  • Android LitePal的使用详解

    前言 数据库操作一直都是比较繁琐而且单一的东西,平时开发中数据库也很常见.有学过mysql的读者可能会觉得sql语句确实让人很难受.同样android中,虽然有内置数据库SQLite,但是操作起来还是非常的不方便.跟网络请求类似,当我们用原生的HttpURLConnection请求数据再用json解析,过程很繁琐,所以我们一般是封装成一个工具类,但是retrofit出现了,他帮我们解决了网络请求和解析数据的封装,同时还支持RxJava的异步,十分强大.不了解retrofit的读者也建议你们去学习

  • Android系统对话框使用详解(最详细)

    在实际应用开发中,用到系统对话框中的情况几乎是没有的.按开发流程来说,UI工程师都会给出每一个弹窗的样式,故而在实际开发中都是自定义弹窗的. 即使用到的地方不多,但是我们也是需要了解并且能熟练的运用它,下面为大家奉上各种系统对话框的实现. 目录 一.系统对话框的几种类型与实现 在项目的实际开发中,用到的系统对话框几乎是没有的.原因大概包含以下几点: 样式过于单一,不能满足大部分实际项目中的需求. 对话框的样式会根据手机系统版本的不同而变化.不能达到统一的样式. 能实现的功能过于简单. 在这里先附

  • Android AOP注解Annotation详解(一)

    Android 注解Annotation 相关文章: Android AOP注解Annotation详解(一) Android AOP之注解处理解释器详解(二) Android AOP 注解详解及简单使用实例(三) Android AOP 等在Android上应用越来越广泛,例如框架ButterKnife,Dagger2,EventBus3等等,这里我自己总结了一个学习路程. - Java的注解Annotation - 注解处理解析器APT(Annotation Processing Tool)

随机推荐