第 7 章 高级构建定制

构建选项

Java 编译选项）

android {
    compileOptions {
        sourceCompatibility = "1.6"
        targetCompatibility = "1.6"
    }
}

默认值是“1.6”。这个设置将影响所有task编译Java源代码。

aapt 选项

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

这将影响所有使用aapt的task。

dex 选项

android {
    dexOptions {
        incremental false
 
        preDexLibraries = false
 
        jumboMode = false
 
    }
}

这将应用所有使用dex的task。

操作 task

基础Java项目有一组有限的task用于互相处理生成一个输出。classes是一个编译Java源代码的task。可以在build.gradle文件中通过脚本很容易使用classes。这是project.tasks.classes的缩写。

在Android项目中，相比之下这就有点复杂。因为Android项目中会有大量相同的task，并且它们的名字基于_Build Types_和_Product Flavor_生成。

为了解决这个问题，android对象有两个属性：

• applicationVariants（只适用于app plugin）
• libraryVariants（只适用于library plugin）
• testVariants（两个plugin都适用）

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

注意使用这三个collection中的其中一个都会触发生成所有对应的task。这意味着使用collection之后不需要更改配置。

DomainObjectCollection可以直接访问所有对象，或者通过过滤器进行筛选。

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

这三个variant类都共享下面的属性：

ApplicationVariant类还有以下附加属性：

LibraryVariant类还有以下附加属性：

TestVariant类还有以下属性：

Android task特有类型的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”可以改变最终的输出文件夹。

• ZipAlign

• File inputFile

• File outputFile

• 直接在Variant对象中使用“outputFile”可以改变最终的输出文件夹。

每个task类型的API由于Gradle的工作方式和Android plugin的配置方式而受到限制。首先，Gradle意味着拥有的task只能配置输入输出的路径和一些可能使用的选项标识。因此，task只能定义一些输入或者输出。

其次，这里面大多数task的输入都不是单一的，一般都混合了sourceSet、_Build Type_和_Product Flavor_中的值。为了保持构建文件的简单和可读性，目标是要让开发者通过DSL语言修改这些对象来配饰构建的过程，而不是深入修改输入和task的选项。

另外需要注意，除了ZipAlign这个task类型，其它所有类型都要求设置私有数据来让它们运行。这意味着不可能自动创建这些类型的新task实例。

这些API也可能会被更改。一般来说，目前的API是围绕着给定task的输入和输出入口来添加额外的处理（如果需要的时候）。欢迎反馈意见，特别是那些没有预见过的需求。

对于Gradle的task（DefaultTask，JavaCompile，Copy，Zip），请参考Gradle文档。

BuildType 和 Product Flavor 属性参考

即将到来...对于Gradle的task（DefaultTask，JavaCompile，Copy，Zip），请参考Gradle文档。

使用 JDK 1.7 版本的 sourceCompatibility

使用Android KitKat（19版本的buildTools）就可以使用diamond operator，multi-catch，switch中使用字符串，try with resource等等（译注：都是JDK7的一些新特性，详情请参考JDK7文档）。设置使用1.7版本，需要修改你的构建文件：

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使用1.7或者更高版本的JDK（Android Gradle plugin也需要0.6.1或者更高的版本）。