Taakeigenschappen en configuratie

Aangepaste Gradle-taken kunnen zeer flexibel worden gemaakt door eigenschappen toe te voegen. Deze eigenschappen werken als variabelen waarmee je het gedrag van een taak vanuit je build.gradle-script kunt configureren.

Dankzij eigenschappen zijn je aangepaste taken herbruikbaar en aanpasbaar aan verschillende projectbehoeften, zonder dat je hun kernlogica hoeft te wijzigen.

Om een eigenschap aan een aangepaste taak toe te voegen, declareer je eenvoudig een openbaar veld binnen je taakklasse. Voor basistypen zoals String, int of boolean is dit rechttoe rechtaan.

Voor geavanceerdere scenario's biedt Gradle ook speciale typen Property, maar we beginnen met eenvoudige declaraties.

Hier zie je een eenvoudige aangepaste taak die rechtstreeks in build.gradle is gedefinieerd. De taak heeft een eigenschap message die wordt afgedrukt wanneer de taak wordt uitgevoerd. Let op de standaardwaarde die voor de eigenschap is ingesteld.

Nadat een taakeigenschap is gedefinieerd, kun je de waarde ervan eenvoudig instellen vanuit je build.gradle-bestand. Dit doe je binnen het configuratieblok van de taak, waarmee je de taakinstantie kunt aanpassen.

Voer het voorbeeld uit om te zien hoe het standaardbericht wordt overschreven.

Een van Gradles krachtigste functies is incrementeel bouwen. Dit betekent dat Gradle taken kan overslaan als hun invoer en uitvoer sinds de vorige build niet zijn gewijzigd, wat veel tijd bespaart.

Om dit mogelijk te maken, moet je Gradle vertellen welke eigenschappen als invoer van de taak worden beschouwd. Dit zijn eigenschappen waarvan de waarden invloed hebben op het resultaat van de taak.

Je markeert een eigenschap als invoer met de annotatie @Input. Gradle houdt de waarde ervan dan bij. Als de waarde tussen builds verandert, wordt de taak uitgevoerd. Zo niet, dan kan Gradle de taak markeren als UP-TO-DATE en overslaan.

Gebruik voor invoer van bestanden of mappen @InputFile, @InputDirectory of @InputFiles.

Ook uitvoer is van groot belang. Dit zijn de bestanden of mappen die je taak tijdens de uitvoering maakt of wijzigt. Gradle houdt ook deze bij om te bepalen of een taak actueel is.

Als de invoer van een taak niet is gewijzigd EN de gedeclareerde uitvoer aanwezig en geldig is, weet Gradle dat de taak niet opnieuw hoeft te worden uitgevoerd.

Je gebruikt annotaties zoals @OutputFile voor één resultaatbestand of @OutputDirectory voor een map met resultaten. Hiermee geef je Gradle aan waar de gegenereerde artefacten van de taak worden opgeslagen.

De taak zorgt ervoor dat de bovenliggende map bestaat voordat het bestand wordt geschreven.

Door zowel invoer als uitvoer correct te declareren, benut je Gradles krachtige functie voor incrementeel bouwen. Hierdoor worden je taken alleen uitgevoerd wanneer dat nodig is, waardoor builds aanzienlijk sneller worden.

Deze optimalisatie is essentieel voor efficiënte ontwikkelprocessen en robuuste CI/CD-pijplijnen, omdat ze snelle feedback en een lager resourcegebruik garandeert.

In deze les heb je geleerd hoe je eigenschappen aan aangepaste taken toevoegt, zodat je ze kunt configureren en hergebruiken. Je hebt ook ontdekt hoe je eigenschappen markeert als invoer (bijvoorbeeld @Input, @InputFile) en uitvoer (bijvoorbeeld @OutputFile, @OutputDirectory).

Deze annotaties zijn essentieel om Gradles krachtige functie voor incrementeel bouwen mogelijk te maken. Die functie versnelt je builds aanzienlijk door taken over te slaan die al actueel zijn. Blijf oefenen om efficiënte taakconfiguratie onder de knie te krijgen!