192

On a multi-project gradle build, can someone tell me what exactly is the difference between the "allprojects" section and the "buildscript" one? Both have a repositories and dependencies task. Is allprojects for my project? What about buildscript?

buildscript {  
     repositories {
         ...
     }
     dependencies {
         ...
     }
}

and 

allprojects(subprojects) { 
     repositories {
         ...
     }
     dependencies {
         ...
     }
}
serv-inc
  • 35,772
  • 9
  • 166
  • 188
kidoher
  • 2,297
  • 2
  • 12
  • 19

2 Answers2

193

The "buildscript" configuration section is for gradle itself (i.e. changes to how gradle is able to perform the build). So this section will usually include the Android Gradle plugin.

The "allprojects" section is for the modules being built by Gradle.

Oftentimes the repository section is the same for both, since both will get their dependencies from jcenter usually (or maybe maven central). But the "dependencies" section will be different.

Usually the "dependencies" section for "allprojects" is empty since the dependencies for each module are unique and will be in the "build.gradle" file within each of the modules. However, if all of the modules shared the same dependencies then they could be listed here.

serv-inc
  • 35,772
  • 9
  • 166
  • 188
AndroidGuy
  • 3,371
  • 1
  • 19
  • 21
  • Do we have to specify gradle version? – IgorGanapolsky Mar 12 '19 at 17:22
  • user:6998684 The version of gradle applies to the entire project and is declared in a file that's a bit hidden. Look in "./gradle/wrapper/gradle-wrapper.properties" – AndroidGuy Mar 13 '19 at 21:26
  • Hello, question: Can I use *one* repositories or dependencies property outside of the scope/closures of both *for* both or do they both have to be inside the scope of either `buildscript` or `allprojects`? And does the `classpath` property inside the `buildscript` property have an effect on a `dependencyManagement` property outside of the `buildscript` property? Thanks – von spotz Feb 16 '22 at 09:54
28

TL;DR: buildscript helps find plugins, allprojects applies to all projects

https://docs.gradle.org/current/userguide/userguide_single.html#applyPluginBuildscript says

Binary plugins that have been published as external jar files can be added to a project by adding the plugin to the build script classpath and then applying the plugin.

So you need buildscript for gradle to find the plugins, as

Gradle at its core intentionally provides very little for real world automation. All of the useful features, like the ability to compile Java code, are added by plugins. Plugins add new tasks (e.g. JavaCompile), domain objects (e.g. SourceSet), conventions (e.g. Java source is located at src/main/java) as well as extending core objects and objects from other plugins.

Concerning allprojects:

The Project API provides a property allprojects which returns a list with the current project and all its subprojects underneath it. If you call allprojects with a closure, the statements of the closure are delegated to the projects associated with allprojects.

Community
  • 1
  • 1
serv-inc
  • 35,772
  • 9
  • 166
  • 188
  • 3
    To me, as beginner in android ecosystem, this means nothing. Where do we need to put our dependencies? Can we delete that "buildscript"? – Martin Berger Jan 09 '20 at 14:40
  • @MartinBerger: put your dependencies in the module's `build.gradle`, not the `build.gradle` that is one directory above, which this question deals with – serv-inc Jan 10 '20 at 09:12