In a few places (mainly in the documentation) I have seen that it is possible to configure multiple Gradle projects in one build.gradle file using a syntax like

project(":foo") { ... }

. Is this something that is officially supported for use in real builds?

It is supported and can be used in real builds, yes, but it should be avoided. https://docs.gradle.org/current/userguide/sharing_build_logic_between_subprojects.html#sec:convention_plugins_vs_cross_configuration

This talks about

allprojects

and

subprojects

but that's a bit different from what I'm asking about. I'm thinking about this method.

It's the same as

allprojects

and

subprojects

. They allow configuring other projects. The documentation should probably be updated.

I see, thanks.

cc @Laura Kassovic

Thanks! The

Cross project configuration

link to learn more about it takes you to the

Do not use cross-project configuration

section I linked above. 😅 That section definitely should be updated.