本文译自Android官方技术文档《Gradle Plugin User Guide》,原文地址:http://tools.android.com/tech-docs/new-build-system/user-guide。

翻译不易,转载请注明CSDN博客上的出处:

http://blog.csdn.net/maosidiaoxian/article/details/42417779

前三章见《Android官方技术文档翻译——Gradle 插件用户指南(1-3)》。

第四章见《Android官方技术文档翻译——Gradle 插件用户指南(4)》。

第五章见《Android官方技术文档翻译——Gradle 插件用户指南(5)》。

第六章见《Android官方技术文档翻译——Gradle 插件用户指南(6)》。

翻译工作耗时费神,如果你觉得本文翻译得还OK,请点击文末的“顶”,谢谢。翻译如有错讹,敬请指正。

高级构建定制

构建选项

Java 编译选项

android {
    compileOptions {
        sourceCompatibility = "1.6"
        targetCompatibility = "1.6"
    }
}
默认值为“1.6”。这个配置会影响所有编译 Java 源代码的任务。

aapt 选项

android {
    aaptOptions {
        noCompress 'foo', 'bar'
        ignoreAssetsPattern "!.svn:!.git:!.ds_store:!*.scc:.*:<dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"
    }
}

这个配置会影响所有使用aapt的任务。

dex 选项

android {
    dexOptions {
        incremental false

preDexLibraries = false

jumboMode = false

    }
}
这个配置会影响所有使用dex 的任务。

操作任务

基本的 Java 项目有一组有限的任务能够共同协作来创建一个输出。

其中classes 任务是将 Java 源代码进行编译的那个任务。

build.gradle通过简单地在脚本中使用classes就能很容易地访问它。这是project.tasks.classes的简洁写法。



在 Android 项目中,它会比较复杂一点,因为可能有大量的相同的任务并且他们的名字都是基于Build TypesProduct Flavors生成。 



android对象中有两个(译者注:我怎么感觉是三个。难道是原文笔误?)属性就是为解决这个问题的:

  • applicationVariants(仅适用于应用程序插件)
  • libraryVariants(仅适用于库插件)
  • testVariants (对两个插件都适用)

这三个会分别返回ApplicationVariant、LibraryVariant和TestVariant的DomainObjectCollection对象。



注意,访问这些集合的任何一个都将触发所有任务的生成。这意味着在访问这些集合之后不应该再进行(重新)配置。



DomainObjectCollection可以对所有对象进行直接访问,或通过过滤器(这将会很方便)过滤。 


android.applicationVariants.each { variant ->
    ....
}

这三个variant 类都有以下属性:

 属性名称  属性类型  描述
 name  String  variant的名称。必须保证是唯一的。
 description  String  人类可读的对variant的描述。
 dirName  String  variant的子文件夹名称。必须保证是唯一的。可能会是多个文件夹,即"debug/flavor1"
 baseName  String  variant的输出的基础名称必须保证是唯一的。
 outputFile  File  variant的输出。这是一个可读可写的属性
 processManifest  ProcessManifest  处理manifest的任务。
 aidlCompile  AidlCompile  编译AIDL文件的任务。
 renderscriptCompile  RenderscriptCompile  编译Renderscript文件的任务。
 mergeResources  MergeResources  合并资源的任务。
 mergeAssets  MergeAssets  合并assets的任务。
 processResources  ProcessAndroidResources  处理和编译资源的任务。
 generateBuildConfig  GenerateBuildConfig  生成 BuildConfig 类的任务。
 javaCompile  JavaCompile  编译 Java 代码的任务。
 processJavaResources  Copy  处理 Java 资源的任务。
 assemble  DefaultTask  variant 的assemble锚任务。

ApplicationVariant 类增加了以下属性:

 属性名称  属性类型  描述
 buildType  BuildType  variant 的 BuildType。
 productFlavors  List<ProductFlavor>  variant 的 ProductFlavors。总是不为null,但可以是空集合。
 mergedFlavor  ProductFlavor  对android.defaultConfig 和 variant.productFlavors的合并
 signingConfig  SigningConfig  用于 variant 的 SigningConfig 对象
 isSigningReady  boolean  如果该 variant 有签名所需的所有信息则为true。
 testVariant  BuildVariant  将会测试该variant的TestVariant
 dex  Dex  将代码生成dex的任务。如果variant是一个库,这个值可以为 null。
 packageApplication  PackageApplication  打包最终的APK的任务。如果variant是一个库,这个值可以为 null。
 zipAlign  ZipAlign  对apk进行zipaligns(优化对齐)的任务。如果variant是一个库或者APK不能被签名,这个值可以为 null。
 install  DefaultTask  安装任务。可以为 null。
 uninstall  DefaultTask  卸载任务。

LibraryVariant 类增加了以下属性:

 属性名称  属性类型  描述
 buildType  BuildType  variant 的 BuildType。
 mergedFlavor  ProductFlavor  DefaultConfig 的值
 testVariant  BuildVariant  将会测试该variant 的 Build Variant
 packageLibrary  Zip  打包成Library AAR 归档文件的任务。如果不是库项目可以为null。

TestVariant 类增加了以下属性:

 属性名称  属性类型  描述
 buildType  BuildType  variant 的 BuildType。
 productFlavors  List<ProductFlavor>  variant 的 ProductFlavors。总是不为null,但可以是空集合。
 mergedFlavor  ProductFlavor  对android.defaultConfig 和 variant.productFlavors的合并
 signingConfig  SigningConfig  用于 variant 的 SigningConfig 对象
 isSigningReady  boolean  如果该 variant 有签名所需的所有信息则为true。
 testedVariant  BaseVariant  经过TestVariant测试过的BaseVariant。
 dex  Dex  将代码生成dex的任务。如果variant是一个库,这个值可以为 null。
 packageApplication  PackageApplication  打包最终的APK的任务。如果variant是一个库,这个值可以为 null。
 zipAlign  ZipAlign  对apk进行zipaligns(优化对齐)的任务。如果variant是一个库或者APK不能被签名,这个值可以为 null。
 install  DefaultTask  安装任务。可以为 null。
 uninstall  DefaultTask  卸载任务。
 connectedAndroidTest  DefaultTask  在已连接的设备上运行 android 测试的任务。
 providerAndroidTest  DefaultTask  使用扩展 API 运行android 测试的任务。

Android 的特定任务类型的 API。

  • ProcessManifest

    • File manifestOutputFile
  • AidlCompile
    • File sourceOutputDir
  • RenderscriptCompile
    • File sourceOutputDir
    • File resOutputDir
  • MergeResources
    • File outputDir
  • MergeAssets
    • File outputDir
  • ProcessAndroidResources
    • File manifestFile
    • File resDir
    • File assetsDir
    • File sourceOutputDir
    • File textSymbolOutputDir
    • File packageOutputFile
    • File proguardOutputFile
  • GenerateBuildConfig
    • File sourceOutputDir
  • Dex
    • File outputFolder
  • PackageApplication
    • File resourceFile
    • File dexFile
    • File javaResourceDir
    • File jniDir
    • File outputFile
      • 要修改最终输出的文件,可以在 variant 对象上直接使用“outputFile”(译者注:1.0 版本通过variant获取到的是outputs,是一个List,需要通过对其遍历或取第一个元素variant.outputs[0].outputFile才能获得outputFile对象)。
  • ZipAlign
    • File inputFile
    • File outputFile
      • 要修改最终输出的文件,可以在 variant 对象上直接使用“outputFile”(译者注:1.0 版本通过variant获取到的是outputs,是一个List,需要通过对其遍历或取第一个元素variant.outputs[0].outputFile才能获得outputFile对象)。


由于Gradle的工作原理以及Android 插件的配置方式,用于每个任务类型的API会有所限制。
首先,Gradle 想要让任务只能配置输入或输出的位置和可能使用的可选标志。所以在这里,这些任务只能定义一些输入或输出。

其次,这些任务的绝大多数的输入都是有实际意义的,它们往往来自sourceSetsBuild TypesPruduct Flavor的混合值。为了保持构建文件易于阅读和理解,目的是要让开发人员通过DSL进行稍微调整就可以修改构建,而不是要深入任务的选项和输入并且去修改它们。

此外注意到,除了 ZipAlign 任务类型,所有其他类型都需要设立私有数据来让它们正常运行。这意味着不可能手动创建这些类型的新任务。



这个 API 也可能会被更改。一般情况下,当前 API 是围绕着任务给定的输出或输入(如果可能)的入口来添加额外的处理的(如果需要)。欢迎反馈意见,特别是那些未预知的需求。



关于 Gradle 任务 (DefaultTask,JavaCompile,Copy,Zip),请参阅 Gradle 文档。

BuildType 和 Product Flavor 的属性参考

即将推出。
关于 Gradle 任务 (DefaultTask,JavaCompile,Copy,Zip),请参阅 Gradle 文档。 <br4>

使用 sourceCompatibility 1.7

通过 Android KitKat (buildToolsVersion 19),你可以使用钻石运算符(即<>),multi-catch,在switch语句中使用string, try with resources等等。要做到这一点,请将以下配置添加到您的构建文件中:

android {
    compileSdkVersion 19
    buildToolsVersion "19.0.0"

    defaultConfig {
        minSdkVersion 7
        targetSdkVersion 19
    }

    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_7
        targetCompatibility JavaVersion.VERSION_1_7
    }
}

注意,你可以把 minSdkVersion 的值设为19之前的版本,只是你只能使用除了try with resources之外的其他新语言特性。如果你想要使用 try with resources,你就需要把minSdkVersion 也设为 19。

你还需要确认 Gradle 使用JDK 1.7或更高的版本。(并且Android Gradle 插件也需要0.6.1或更高的版本。)

Android官方技术文档翻译——Gradle 插件用户指南(7)的更多相关文章

  1. Android官方技术文档翻译——Gradle 插件用户指南(5)

    昨晚把第五章未译完的几句话攻克了.只是第六章没怎么译,明后天又是周末,假设周一前第六章翻译完的话,周一再发第六章. 本文译自Android官方技术文档<Gradle Plugin User Gu ...

  2. Android官方技术文档翻译——Gradle 插件用户指南(4)

    最近赶项目,白天基本没时间,只有晚上在家的时候才能看一看.昨天晚上只翻译完了第四章,今天就只发第四章吧. 本文译自Android官方技术文档<Gradle Plugin User Guide&g ...

  3. Android官方技术文档翻译——Gradle 插件用户指南(6)

    没想到翻译这篇<Gradle 插件用户指南>拖了差不多一个月,还跨年了.不过还好,在2号时终于一口气把剩下的给翻译完了(其实那天剩下的也就不到一章). 今天先发一下第六章,明天再发第七章. ...

  4. Android官方技术文档翻译——Gradle 插件用户指南(1-3)

    不知道是什么网络问题,上午一直发不了博客,其它页面基本正常,就是在写博客这里,每次打开都是响应超时.刚才用了VPN,顺便试了一下,竟然能够编辑.想是CDN之类的问题吧. 这次翻译的是Gradle 插件 ...

  5. Android官方技术文档翻译——新构建系统概述

    本文译自Android官方技术文档<New Build System>,原文地址:http://tools.android.com/tech-docs/new-build-system. ...

  6. Android官方技术文档翻译——迁移 Gradle 项目到1.0.0 版本

    本文译自Android官方技术文档<Migrating Gradle Projects to version 1.0.0>,原文地址:http://tools.android.com/te ...

  7. Android官方技术文档翻译——IntelliJ 项目迁移

    本文译自Android官方技术文档<Migrating from IntelliJ Projects>,原文地址:http://tools.android.com/tech-docs/ne ...

  8. Android官方技术文档翻译——Eclilpse项目迁移

    本文译自Android官方技术文档<Migrating From Eclipse Projects>,原文地址:http://tools.android.com/tech-docs/new ...

  9. Android官方技术文档翻译——清单合并

    本文译自Android官方技术文档<Manifest Merger>,原文地址:http://tools.android.com/tech-docs/new-build-system/us ...

随机推荐

  1. Kafka学习笔记2: 快速入门

    在开始Kafka环境搭建之前,首先要安装Linux系统,并在Linux系统上安装JDK1.8版本,关于linux虚拟机的安装和linux系统下jdk的安装可以参考我的博文: http://blog.c ...

  2. 重载Cocos2D生存期的方法

    大熊猫猪·侯佩原创或翻译作品.欢迎转载,转载请注明出处. 如果觉得写的不好请多提意见,如果觉得不错请多多支持点赞.谢谢! hopy ;) 免责申明:本博客提供的所有翻译文章原稿均来自互联网,仅供学习交 ...

  3. 剑指Offer——京东校招笔试题+知识点总结

    剑指Offer--京东校招笔试题+知识点总结 笔试感言 经过一系列的笔试,发觉自己的基础知识还是比较薄弱的,尤其是数据结构和网络,还有操作系统.工作量还是很大的.做到精确制导的好方法就是在网上刷题,包 ...

  4. 【编程练习】poj1111

    Image Perimeters Time Limit: 1000MS   Memory Limit: 10000K Total Submissions: 8632   Accepted: 5168 ...

  5. Android项目开发填坑记-Fragment的onBackPressed

    Github版 CSDN版 知识背景 Fragment在当前的Android开发中,有两种引用方式,一个是 Android 3.0 时加入的,一个是supportV4包中的.这里简称为Fragment ...

  6. Android的四个基本概念(线程通信和GLSurfaceView)

    GLSurfaceView提供了下列特性: 1> 管理一个surface,这个surface就是一块特殊的内存,能直接排版到android的视图view上. 2> 管理一个EGL disp ...

  7. 1.Android中解析json程序代码

    Android程序解析json数据可以通过gson的方式,这种情况需要导入相应的jar包.测试代码如下: @Override protected void onCreate(Bundle savedI ...

  8. Socket实现聊天客户端

    今天在极客学院上看到了一个关于Socket的视频讲解,感觉还不错,就写了份代码,拿来分享一下. Socket使用方法 关于Socket的使用,我们首先要弄清楚的是,在服务器端还是在客户端使用.因为这的 ...

  9. SpriteBuilder中使用GUI界面快速搭建RPG游戏中的地图名显示动画

    大熊猫猪·侯佩原创或翻译作品.欢迎转载,转载请注明出处. 如果觉得写的不好请告诉我,如果觉得不错请多多支持点赞.谢谢! hopy ;) 在RPG游戏中我们在进入一个新的场景时,比如一个房间,一个村庄, ...

  10. 【一天一道LeetCode】#242. Valid Anagram

    一天一道LeetCode 本系列文章已全部上传至我的github,地址:ZeeCoder's Github 欢迎大家关注我的新浪微博,我的新浪微博 欢迎转载,转载请注明出处 (一)题目 Given t ...