This migration process can be performed incrementally, and you can maintain a functional Gradle build throughout the transition.

WARNING: Ant integration is not fully compatible with the <<configuration_cache.adoc#config_cache,configuration cache>>.
Using link:{javadocPath}/org/gradle/api/Task.html#getAnt--[Task.ant] to run Ant task in the task action may work, but importing the Ant build is not supported.

[[sec:ant_api]]

====
.gradle.properties
[source,properties]
----
org.gradle.configuration-cache=true
----
====

For more information about the configuration cache, check out the
<<configuration_cache.adoc#config_cache,configuration cache documentation>>.

=== Additional configuration cache benefits

The configuration cache enables additional benefits as well. When enabled, Gradle:

Toggles the <<build_cache.adoc#build_cache, Gradle Build Cache>>. Gradle will try to reuse outputs from previous builds. _Default is off_.

`--configuration-cache`, `--no-configuration-cache`::
Toggles the <<configuration_cache.adoc#config_cache,Configuration Cache>>. Gradle will try to reuse the build configuration from previous builds. _Default is off_.

`--configuration-cache-problems=(fail,warn)`::

An example of a build feature is the <<configuration_cache.adoc#config_cache,configuration cache>>.

There are two main use cases:

- Using the status of build features in reports or statistics.

[[migant:imported_builds]]
== Working with an imported build

WARNING: Importing an Ant build is not supported with the <<configuration_cache.adoc#config_cache,configuration cache>>.
You need to complete the conversion to Gradle to get the benefits of caching.

The first step of many migrations will involve <<ant#sec:import_ant_build,importing an Ant build>> using `ant.importBuild()`.

// See the License for the specific language governing permissions and
// limitations under the License.

:gradle-issues: https://github.com/gradle/gradle/issues/

[[config_cache]]
= Configuration cache

// Run tests for snippets included in this chapter with:
// ./gradlew :docs:docsTest --tests="ExemplarExternalSamplesFunctionalTest.snippet-configuration-cache-*"