// limitations under the License.

[[upgrading_version_7]]
= Upgrading your build from Gradle 7.x to 8.0

This chapter provides the information you need to migrate your Gradle 7.x builds to Gradle 8.0.
For migrating from Gradle 6.x or earlier, complete the  <<upgrading_version_6.adoc#upgrading_version_6, older migration guide>> first.

We recommend the following steps for all users:

            if (GradleContextualExecuter.isConfigCache()) {
                executer.expectDocumentedDeprecationWarning(

        executer.expectDocumentedDeprecationWarning("Specifying custom build file location has been deprecated. This is scheduled to be removed in Gradle 9.0. Consult the upgrading guide for further information: https://docs.gradle.org/current/userguide/upgrading_version_7.html#configuring_custom_build_layout")

    flags: "--warning-mode=all"

        run("broken")

        then:
        noExceptionThrown()

        where:

        execute(buildA, ":checkDeps", ["--build-file", "build-copy.gradle"])

        then:
        assertTaskExecuted(":buildB", ":jar")
    }

        succeeds("broken")

        then:
        noExceptionThrown()
    }

    @UnsupportedWithConfigurationCache(because = "tests unsupported behaviour")

        run("broken")

        then:
        noExceptionThrown()

        where:
        type               | listener
        TestListener       | "testListener"

            succeeds ':problematic'
        }

        then:
        if (withCC) {
            problems.assertFailureHasProblems(failure) {

        executer.expectDocumentedDeprecationWarning("Specifying custom build file location has been deprecated. This is scheduled to be removed in Gradle 9.0. Consult the upgrading guide for further information: https://docs.gradle.org/current/userguide/upgrading_version_7.html#configuring_custom_build_layout")
        succeeds(AGGREGATE_TASK_NAME)