}

    @ToBeFixedForConfigurationCache
    def multiProject() {
        given:
        sample multiProject

        when:
        run "installMainExecutable"

        then:
        executed(":exe:mainExecutable")

        and:
        sharedLibrary(multiProject.dir.file("lib/build/libs/main/shared/main")).assertExists()
        executable(multiProject.dir.file("exe/build/exe/main/main")).assertExists()

====
include::sample[dir="snippets/multiproject/dependencies-java/kotlin",files="settings.gradle.kts[]"]
include::sample[dir="snippets/multiproject/dependencies-java/groovy",files="settings.gradle[]"]
====

The source code for the convention plugin created in the `buildSrc` directory is as follows:

====

As an example, let's use a multi-project build with the following structure:
----
> gradle -q projects
----
----
include::{snippetsPath}/java/multiproject/tests/listProjects.out[]
----

Multi-project builds are collections of tasks you can run.
The difference is that you may want to control _which_ project's tasks get executed.

    @ToBeFixedForIsolatedProjects(because = "Access to root project from sub projects")
    def "can visit and edit zip archive differently from two different projects in a multiproject build"() {
        given: "an archive in the root of a multiproject build"
        createZip('test.zip') {
            subdir1 {
                file ('file1.txt').text = 'original text 1'
            }
            subdir2 {

.Custom buildSrc build script
====
include::sample[dir="snippets/java/multiproject/kotlin",files="buildSrc/build.gradle.kts[]"]
include::sample[dir="snippets/java/multiproject/groovy",files="buildSrc/build.gradle[]"]
====

A typical project including `buildSrc` has the following layout.

        }
        generatedCode['RootProjectDependency'].with {
            noSubAccessors()
        }

        and:
        compiles()
    }

    def "generates accessors for flat multiproject"() {
        when:
        generateSources project("root") {
            project("core")
            project("lib")
            project("utils")
        }

        then:

:buildB:compileJava
\\--- :buildC:compileJava
     \\--- :buildB:compileJava (*)""")
    }

    def "dependency cycle between subprojects in an included multiproject build"() {
        given:
        dependency "org.test:buildB:1.0"

        buildB.buildFile << """
            dependencies {
                implementation "org.test:b1:1.0"
            }

            '''.stripIndent()
    }

    @Requires(IntegTestPreconditions.NotParallelExecutor)
    def "can show dependent components in parallel"() {
        given: 'a multiproject build'
        settingsFile.text = multiProjectSettings()
        buildScript multiProjectBuild()

        when: 'two reports in parallel'

        imlHasDependencies(["buildB"], ["external-dep-1.0.jar"])
    }

    @ToBeFixedForConfigurationCache
    def "builds IDEA metadata with dependency cycle between substituted projects in a multiproject build"() {
        given:
        dependency "org.test:buildB:1.0"

        buildB.buildFile << """
            dependencies {
                api "org.test:b1:1.0"
            }

====
include::sample[dir="snippets/plugins/multiproject/kotlin", files="settings.gradle.kts[tags=include-subprojects];build.gradle.kts[tags=plugins-on-subprojects];hello-a/build.gradle.kts[];hello-b/build.gradle.kts[];goodbye-c/build.gradle.kts[]"]