}

    def "substitutes external dependency for a subproject of the root build - #rootIsIncluded"() {
        given:
        def empty = file('empty').tap {
            it.mkdir()
        }
        mavenRepo.module("org.test", "subproject1", "2.0").publish()
        buildA.buildFile << """
            subprojects {
                apply plugin: 'java-library'
                group = 'org.test'

    }

    def "multiple subprojects with identical toolchain definitions"() {
        given:
        settingsFile << settingsForBuildWithSubprojects(singleUrlResolverCode(uri))

        def jdkMetadata = getJvmInstallationMetadata(jdkRepository.getJdk())
        setupSubproject("subproject1", "Foo", jdkMetadata)
        setupSubproject("subproject2", "Bar", jdkMetadata)

        when:

    def "service provided by a plugin cannot be shared by subprojects with different classloaders"() {
        createDirs("plugin1", "plugin2", "subproject1", "subproject2")
        settingsFile """
        pluginManagement {
            includeBuild 'plugin1'
            includeBuild 'plugin2'
        }
        include 'subproject1'
        include 'subproject2'
        """
        // plugin 1 declares a service

        given:
        createDirs("subprojectA", "subprojectB", "subprojectC", "subprojectD")
        settingsFile << """
rootProject.name = "root"
include 'subprojectA'
include 'subprojectB'
include 'subprojectC'
include 'subprojectD'
"""

        buildFile << """
configure(project(':subprojectA')) {
    apply plugin: 'java'
    apply plugin: 'idea'

        """
        createDirs("subproject-a", "subproject-b", "subproject-c")
        settingsFile << """
            include 'subproject-a', 'subproject-b', 'subproject-c'
        """

        when:
        EclipseProject rootProject = loadToolingModel(EclipseProject)
        EclipseProject subprojectA = rootProject.children.find { it.name == 'subproject-a' }

    }

    def "Multi-project build can define different target bytecode level for subprojects"() {
        given:
        createDirs("subproject-a", "subproject-b", "subproject-c")
        settingsFile << """
            include 'subproject-a', 'subproject-b', 'subproject-c'
        """

        buildFile << """
            project(':subproject-a') {
                apply plugin: 'java'

        task(':subproject:b').dependencies == tasks(':subproject:a')
        task(':subproject:c').dependencies == tasks(':subproject:b')
        task(':subproject:d').dependencies == tasks(':subproject:b', ':subproject:c')
    }

    def "reports task dependencies for tasks in another build"() {
        given:
        settingsFile << """
            includeBuild 'included'
        """
        buildFile << """

        EclipseProject subprojectA = rootProject.children.find {EclipseProject project -> project.name == "subprojectA"}
        then:
        subprojectA.linkedResources.size() == 4
        subprojectA.sourceDirectories.size() == 5

        subprojectA.linkedResources[0].name == 'src-sibling'
        subprojectA.linkedResources[0].type == '2'

    "functionalTests": false,
    "crossVersionTests": false
  },
  {
    "name": "core",
    "path": "subprojects/core",
    "unitTests": true,
    "functionalTests": true,
    "crossVersionTests": true
  },
  {
    "name": "core-api",
    "path": "subprojects/core-api",
    "unitTests": true,
    "functionalTests": true,
    "crossVersionTests": false
  },
  {

This is sometimes referred to as a multi-module project.
Gradle refers to modules as subprojects.

A multi-project build consists of one root project and one or more subprojects.

[[sec:project_structure]]
== Multi-Project structure

The following represents the structure of a multi-project build that contains two subprojects:

image::multi-project-structure.png[]

The directory structure should look as follows: