// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

[[multi_project_builds]]
= Structuring Projects with Gradle

It is important to structure your Gradle project to optimize build performance.
A multi-project build is the standard in Gradle.

image::structuring-builds-1.png[]

// limitations under the License.

[[tweaking_structure]]
= Multi-project Build Considerations and Optimizations

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

[[structure_large_projects]]
= Structuring Large Projects

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

[[fine_tuning_project_layout]]
= Fine-Tuning the Project Layout

 - Consuming JVM libraries using link:{userManualPath}/core_dependency_management.html[dependency management]
 - link:{userManualPath}/publishing_setup.html[Publishing JVM libraries]

org.gradle.jvmargs=-Xmx1536m
# When configured, Gradle will run in incubating parallel mode.
# This option should only be used with decoupled projects. More details, visit
# http://www.gradle.org/docs/current/userguide/multi_project_builds.html#sec:decoupled_projects
# org.gradle.parallel=true
# AndroidX package structure to make it clearer which packages are bundled with the
# Android operating system, and which are packaged with your app's APK

 - link:{userManualPath}/building_java_projects.html[Building Java & JVM projects]
 - link:{userManualPath}/multi_project_builds.html[Working with multi-project builds]

            .fileComment(documentationRegistry.getDocumentationRecommendationFor("detailed information on multi-project builds", "multi_project_builds"));
        if (settings.getModularizationOption() == ModularizationOption.WITH_LIBRARY_PROJECTS && settings.isUseIncubatingAPIs()) {
            builder.includePluginsBuild();
        }

}
----

Congratulations, you have completed the tutorial!

== Step 4. Next steps
We recommend going through each section of the User Manual.

[.text-right]

Any task you run in the root project folder will cause that same-named task to be run on all the children.

You can run `gradle build` to build and test ALL projects.

Consult the <<multi_project_builds.adoc#multi_project_builds,Structuring Builds chapter>> to learn more.

[.text-right]