3.1 基本的build文件

最基本的Java工程,其 build.gradle 非常简单:

  1. apply plugin: 'java'

这里应用了Gradle提供的Java插件。该插件提供了构建和测试Java应用所需的一些东西。

一个最基本的Android工程的build.gradle如下:

  1. buildscript {
  2. repositories {
  3. mavenCentral()
  4. }
  5. dependencies {
  6. classpath 'com.android.tools.build:gradle:0.11.1'
  7. }
  8. }
  9. apply plugin: 'android'
  10. android {
  11. compileSdkVersion 19
  12. buildToolsVersion "19.0.0"
  13. }

在 Android buid file 中,有3个主要组成部分。

buildscript { ... } 部分配置了驱动构建的代码。

在该部分中,定义配置使用了 Maven 中央仓库,并且声明依赖一个 Maven artifact(构件?)。 这个 artifact 是一个包含 0.11.1 版本的 Android Gradle 插件库。

注意: 这部分的配置只会影响构建过程的代码,和你的工程没有关系。工程会定义它自己的仓库和相关依赖。稍候会详细介绍。

接下来,android 插件被应用,这和上面的Java插件是一样的。

最后,android { ... } 这部分配置了 android 构建需要的所有参数。这里也是 Android DSL 的入口点。

默认情况下,只有编译的目标SDK、构建工具的版本是必需的。就是 compileSdkVersionbuildtoolsVersion 两个配置属性。

compilation target 和旧构建系统中的 project.properties 文件里 target 属性是一样的。这个新的属性和以前的 target 一样,可以指定一个 int 类型( api 级别)或者 string 类的值。

重要: 你应该只应用 android 插件就好了,不要同时应用 java 插件,因为这会导致构建错误

注意: 你还需要在同目录下添加一个 local.properties 文件,并通过 sdk.dir 属性配置所需的 SDK 的路径。除此之外,你也可以设置一个名为 ANDROID_HOME 环境变量。这两种方法都差不多,你可以选择自己喜欢的。