Android中使用Gradle来构建App项目的入门指南

Tani ·

更新时间:2024-11-13

· 743 次阅读

gradle是Android开发中引入的全新的构建系统，因为全新的构建系统主要是出于下面的目的：

1. 方便复用代码和资源
2. 构建多种版本的apk更见简单，不论是为多渠道构建不同的apk还是构建不同环境的apk（debug，release）
3. 方便配置，扩展，自定义构建过程
4. 良好的IDE集成

为什么选择Gradle？
Gradle主要有以下几个有点：

1. 使用领域驱动语言（DSL）来描述构建逻辑
2. 构建脚本使用Groovy，可以方便的定制构建逻辑
3. 内建的依赖管理系统，使用Maven或者Ivy
4. 非常灵活。可以使用最佳实践但并不强制
5. 良好的IDE支持

Gradle项目使用项目根目录下的build.gradle文件来配置
一个最简单的Java项目的build.gradle如下


apply plugin: 'java'

这表示改项目会使用Gradle的java插件，该插件是Gradle默认提供的，java插件提供了构建java应用和运行测试的功能。

最简单的Android项目build.gralde


buildscript { 
  repositories { 
    mavenCentral() 
  } 
  dependencies { 
    classpath 'com.android.tools.build:gradle:0.11.1' 
  } 
} 
apply plugin: 'android' 
android { 
  compileSdkVersion 19 
  buildToolsVersion "19.0.0" 
}

该Android构建文件包含3个部分：
1.buildscript { ... } 配置驱动构建过程的代码，意思就是buildscript中的配置仅仅在构建过程中起作用，也就是构建程序所使用的配置。
上面的代码中就声明了我们的构建程序会使用Maven中央仓库，并且有一个classpath依赖是指向一个Maven库的。这个Maven库就是Android Gradle插件，版本号是0.11.1。

2.随后就是使用这个Android插件，和之前使用Java插件一样。

3.最后，android { ... }配置了Android项目构建时需要的所有参数。
默认情况下，只需要指定compileSdkVersion和buildtoolsVersion，compileSdkVersion指定使用哪个版本的sdk编译，buildToolsVersion指定使用哪个版本的构建工具。
注意点:
1. 只需要使用android插件，再使用Java插件会报错.
2. 在local.properties中使用sdk.dir属性指定SDK路径，或者你可以使用ANDROID_HOME环境变量。

项目结构
Gradle采用约定优于配置的原则，最简单方式是使用一个默认的目录结构。当然目录结构是可以自己修改的。

默认情况下，android gradle项目的代码都在src目录下，src下会有两个目录main和androidTest，其中main目录下是项目代码，androidTest目录下是测试代码。


src/main/
src/androidTest/

在main和androidTest目录下面，针对不同类型的code，又不会不同的目录。
对于Java和Android的Gradle插件，Java代码和Java资源分别对应了java目录和resources目录。Android插件还需要一些其他的目录和文件，比如


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

下面我们来看一下如何更改这些默认的配置。

Android工程，默认情况下，java文件和resource文件分别在src/main/java和src/main/res目录下，在build.gradle文件，andorid{}里面添加下面的代码，便可以将java文件和resource文件放到src/java和src/resources目录下。（注意，如果你在gradle文件中修改了，只需要重新sync一下，gradle会自动创建新的目录，并将对应的文件移动到新的目录下）


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

更简便的写法是


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

数组里其实是可以指定多个目录，这样就可以将代码和资源放置到多个目录下。
在看一个Android项目的例子：


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') 
  } 
}

这里的main code其实使用的就是Android Gradle的默认值，而androidTest不再使用默认的androidTest目录，而是使用tests目录。

您可能感兴趣的文章:Android实现APP环境分离(利用Gradle)Android App开发中Gradle构建过程的配置方法App中如何获取gradle的配置信息

app项目 gradle 入门指南 app Android

1024 个赞