[source,kotlin]
----
include("app")
include("business-logic")
include("data-model")
----

You can also include entire builds using link:{javadocPath}/org/gradle/api/initialization/IncludedBuild.html[`includeBuild`].

== Settings File Scripting

There are many more properties and methods on the `Settings` object that you can use to configure your build.

            rootProject.name = 'test'
        """
    }

    def "dependency substitution on a dependency enforced by a published platform should not cause an exception"() {
        settingsFile << """
            includeBuild 'jackson-core'
        """
        file('jackson-core/build.gradle') << """
            plugins { id 'java-library' }
            group = 'com.fasterxml.jackson.core'
            version = '2.12.3-local-patch'

    }

    def "reports failure for duplicate included build name"() {
        given:
        def buildC = singleProjectBuild("buildC")
        includeBuild(buildB)
        includeBuildAs(buildC, 'buildB')

        when:
        fails(buildA, "help")

        then:

                ${printLocations()}
            """)
        }

        def rootBuild = singleProjectBuild("buildA") { BuildTestFile build ->
            groovyFile(build.settingsFile, """
                includeBuild "${buildB.toURI()}"
            """)
        }

        when:
        run("project", "--project-dir", rootBuild.absolutePath)

        then:

                public void apply(Project target) {
                }
            }
        """

        file("settings.gradle.dcl") << """
            pluginManagement {
                includeBuild("build-logic")
            }

            plugins {
                id("com.example.restricted.ecosystem")
            }
        """

        file("build.gradle.dcl") << """

            }

            gradle.taskGraph.whenReady {
                project(':').apply from: 'includedWhenReady.gradle'
            }
        """

        settingsFile << """
            includeBuild 'included-build'
            include 'foo'
        """

        file("foo/build.gradle")
        file("foo/before.gradle") << ""
        file("foo/after.gradle") << ""
        file("foo/whenReady.gradle") << ""

        """)
    }

    private
    fun withK2BuildLogicConsumingBuild() {
        withSettings("""
            pluginManagement {
                ${mavenCentralRepository(KOTLIN)}
                includeBuild("build-logic")
            }
            rootProject.name = "k2-gradle"
        """)
        withBuildScript("""
            plugins { id("my-plugin") }
            project.tasks.register("myTask", MyTask::class)

        Assume.assumeFalse(pluginName in ['xctest', 'visual-studio', 'xcode', 'play-application'])

        def includedBuildFile = file("included/build.gradle")

        settingsFile << """
            includeBuild 'included'
        """

        applyPlugin(includedBuildFile)
        includedBuildFile << """
            tasks.configureEach {
                println("configuring \${it.path}")
            }

                useJUnitPlatform()
            }
        """
        file("settings.gradle.kts") << """
            rootProject.name = "GradleEclipseWTPWithIncludedBuild"

            includeBuild("includedBuild")
        """
        file("src/main/java/org/example/Main.java") << """
            package org.example;

            public class Main {
                public static void main(String[] args) {

                        id = "test.worker"
                        implementationClass = "com.example.BlankPlugin"
                    }
                }
            }
        """
        settingsFile << "includeBuild 'included'"
        buildFile << """
            plugins {
                id 'jvm-toolchains'
                id 'test.worker'
            }
            import com.example.TestWorkAction