build.gradle（项目）和 build.gradle（模块）之间的区别

Question

我正在尝试将 Android Asynchronous Http Client 的依赖项添加到我的项目中。所以项目中有两个build.gradle文件。

根据我的理解，有不同类型的依赖：

1. 在 build.gradle (Project:My-app) 的根级别定义的一个
2. build.gradle（Project:My-app）的buildscript中的一个
3. 另一个是 build.gradle (Modules:app)

This question 是关于 buildScript 依赖的仓库，解释一下前两种类型。

还有 build.gradle (Project:My-app) 说

// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files

所以我猜Android Asynchronous Http Client的依赖代码应该是在build.gradle(Module:app)中添加的。

它们是如何组合在一起的？

Answer 1

这有点令人困惑，因为 Android Studio 默认显示两个 build.gradle 文件并排显示（使用 Android 视图时）。

如果您切换到项目视图，您可以看到实际结构以及不同的build.gradle 文件所在的位置。

build.gradle (Project: MyApplication) 文件位于项目的根文件夹中，其配置设置适用于项目中的每个模块。模块是更大项目的一个孤立部分。在一个多模块项目中，这些模块有自己的工作，但共同构成了整个项目。大多数 Android 项目只有一个模块，即 app 模块。

build.gradle（模块：app）文件位于app 文件夹中。它的构建设置仅适用于应用程序模块。如果有另一个模块，那么该模块也将有自己的build.gradle 文件。作为example，我创建了一个包含三个模块的库项目：一个库模块、一个演示应用程序模块和另一个我计划用于测试的应用程序模块。他们每个人都有自己的build.gradle 文件，我可以对其进行调整。

在基本项目中，您需要编辑的几乎所有内容都在应用模块的build.gradle 文件中。你可以这样记住：

您正在制作一个应用程序，因此请转到build.gradle（模块：app）文件。

进一步阅读

• Configure Your Build（Android 文档——非常易读和有用）
• Introduction to multi-project builds（Gradle 文档）

Answer 2

build.gradle（项目：我的应用程序）

顶级构建文件，您可以在其中添加常见的配置选项 所有子项目/模块。

每个项目都包含一个顶级 Gradle 文件。它通常包含所有modules 的通用配置。无论这个顶级 Gradle gile 中包含什么，它都会影响所有 模块。

例子：

// Top-level build file where you can add configuration options common to all sub-projects/modules.

buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:2.0.0-alpha3'

        //Maven plugin
        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
        maven { url "https://jitpack.io" }
    }
}

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

---

build.gradle (Module:app)

特定模块的构建文件（您可以在其中添加依赖项、签名配置、构建类型、风味等）

所有模块都有一个特定的 Gradle 文件。无论这个 gradle 文件中包含什么，它只会影响包含在其中的 module。

例子：

apply plugin: 'com.android.application'

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.2"

    defaultConfig {
        applicationId "com.hrskrs.gesturefun"
        minSdkVersion 10
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            zipAlignEnabled true
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        debug {
            debuggable true
            zipAlignEnabled true
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    compile project(':gesture-fun')
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.1.1'
    compile 'com.android.support:design:23.1.1'
    compile 'com.jakewharton:butterknife:7.0.1'
}

Answer 3

关于gradle这两个文件的关系，hrskrs解释的很清楚，我会做一些补充。

如果你的项目只有一个Module（比如app），上面的build.gradle(Project:My-app)的优势表现的不是很明显。因为你可以在build.gradle(Module:app)中配置关于Module的所有内容，以后升级的时候只修改一个文件。

但是如果你的项目有五个模块，并且碰巧它们有相同的依赖A，如果你不使用最上面的build.gradle(Project: My-app) 您需要在接下来的几天内维护五个文件。

顺便说一下，build.gradle(Module:app)可以覆盖build.gradle(Project:My-app)。

这种设计可以提高应用的可维护性。

Answer 4

[Project vs Module]

Projects 的 build.gradle 文件用于公共/共享逻辑。例如，您可以在此处定义存储库（Maven、Google、JCenter 和自定义）或使用共享变量指定 ext {} 或 classpath^[About]。

Module 的build.gradle 用于当前模块，如依赖项、minSdkVersion、targetSdkVersion、compileSdkVersion^[About]、ProGuard 设置^[About]。通常作为开发人员，您应该注意这个文件。

Answer 5

当你拥有多项目模块时，事情变得更加清晰，那么模块与项目 Gradle 的差异就更加清晰了。

您可以使用 project Gradle 来定义所需的类路径、插件、源存储库（google、maven 等） 以从中获取依赖项。项目级别的 build.gradle 中的更改适用于完整的项目。 然而，有一个谷歌问题跟踪器说依赖泄漏到项目中。

https://github.com/gradle/gradle/issues/8301

https://github.com/gradle/gradle/issues/4741

但是，如果您希望更改适用于您的整个项目，则在较高级别上向项目级别的 Gradle 文件添加一些内容，这样可以减少维护模块之间的依赖关系。

而在模块级 Gradle 顶级模块主要用于签名信息、版本详细信息、构建类型、产品风格、插件和依赖项等。 更底层的模块主要关注特定模块所需的依赖项和插件，通常我们只使用 lower modules 的 build gradle 来添加特定的依赖项。