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

Question

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

据我了解，有不同类型的依赖关系：

在 build.gradle 的根级别上定义的一个（项目：My-app）
build.gradle（项目：My-app）
另一个是build.gradle（模块：app）

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

还有build.gradle（项目：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

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

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

每个项目都包含一个 顶级 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（模块：应用程序）

Build file of your specific module (where you add your dependencies, signing configurations, build types, flavors, etc.)

所有模块都有一个特定的 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 2

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

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

build.gradle（项目：MyApplication）文件位于项目的根文件夹中，其配置设置适用于项目中的每个模块。模块是更大项目的一个孤立部分。在多模块项目中，这些模块各司其职，但协同工作构成了整个项目。大多数 Android 项目只有一个模块，即 app 模块。

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

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

You're making an app, so go to the build.gradle (Module: app) file.

进一步阅读

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

Answer 3

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

如果你的项目只有一个Module（比如app），优势在上面build.gradle（项目：My-app)没有显示的很清楚。因为你可以在build.gradle(Module:app)里面配置所有关于Module的东西，以后升级的时候只修改一个文件

但是如果你的项目有5个模块，正好它们有相同的依赖A，如果你不使用最上面的build.gradle（项目：My-app）您需要在接下来的几天维护五个文件。

顺便说一句，build.gradle（模块：app）可以覆盖build.gradle（项目：My-app).

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

Answer 4

[Project vs Module]

Projects 的 build.gradle 文件用于 common/shared 逻辑。例如，您可以在此处定义存储库 (Maven, Google, JCenter, and custom) or specify ext {} with shared variables or classpath^[About].

模块的build.gradle用于当前模块，如dependencies, minSdkVersion, targetSdkVersion, compileSdkVersion^[About], ProGuard settings^[About]。通常作为开发人员，您应该注意这个文件。

Answer 5

当你有 multi-project 模块时，事情会变得更清楚，然后模块与项目的差异 Gradle 会更清楚。

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

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

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

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

而在 模块级别 Gradle top-level 模块主要用于签名信息、版本详细信息、构建类型、产品风格、插件和依赖项等。此外 lower-level 模块主要与特定模块所需的依赖项和插件有关，通常我们只使用 较低模块的构建 gradle 来添加特定的依赖项。

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

Difference between build.gradle (Project) and build.gradle (Module)

android

android-studio

build.gradle

进一步阅读