Qual è la differenza tra tutti i progetti e sottoprogetti

Question

In una build di gradle a più progetti, qualcuno può dirmi qual è esattamente la differenza tra la sezione "tutti i progetti" e quella "sottoprogetti"? Solo la directory principale? Qualcuno usa entrambi? In tal caso, hai delle regole generali che determinano cosa viene tipicamente inserito in ciascuna di esse?

questione connessa: qual è la differenza tra le due sintassi (in realtà per allprojects e sottoprogetti):

subprojects { ... 
} 

e

configure(subprojects) { ... 
} 

Quando volete uno sopra l'altro?

Answer 1

In una build gradle a più progetti, si dispone di un rootProject e dei sottoprogetti. La combinazione di entrambi è tutti i progetti. RootProject è da dove la build parte. Un modello comune è un rootProject senza codice ei sottoprogetti sono progetti java. In tal caso, si applica il plugin Java per solo i sottoprogetti:

subprojects { 
    apply plugin: 'java' 
} 

questo sarebbe equivalente ad un progetto di aggregazione pom Maven che solo costruisce i sottomoduli.

Per quanto riguarda le due sintassi, fanno esattamente la stessa cosa. Il primo sembra solo migliore.

Answer 2

In aggiunta alla risposta di Ryan, il metodo configure diventa importante quando si desidera configurare sottoinsiemi personalizzati di oggetti. Ad esempio configure([project(":foo"), project(":bar")]) { ... } o configure(tasks.matching { it.name.contains("foo") }) { ... }.

Quando utilizzare allprojects rispetto a subprojects dipende dalle circostanze. Spesso userete entrambi. Ad esempio, i plugin relativi al codice come il plugin Java sono tipicamente applicati a subprojects, perché in molte build il progetto root non contiene alcun codice. I plugin Eclipse e IDEA, d'altra parte, sono in genere applicati a allprojects. In caso di dubbi, guarda esempi e altre build e/o esperimenti. L'obiettivo generale è di evitare una configurazione irrilevante. In questo senso, subprojects è migliore di allprojects finché fornisce i risultati previsti.