Buildstappen en zig build run

Een build kan meer doen dan compileren. Een step is een benoemde taak die je activeert, zoals het uitvoeren van de app of het uitvoeren van tests. 🪜

Als je gewoon zig build uitvoert, wordt de standaardinstallatiestap uitgevoerd. Die compileert je geïnstalleerde artefacten en kopieert ze naar zig-out.

Als je je exe via de build wilt uitvoeren, maak je met addRunArtifact een uitvoeropdracht. Die weet hoe hij het binaire bestand dat je hebt gebouwd moet starten.

Laat het uitvoeren afhangen van de installatiestap met step.dependOn, zodat het nieuwste binaire bestand klaarstaat voordat het wordt gestart.

Geef gebruikers een duidelijke naam met b.step. Het eerste argument is de naam die ze typen en het tweede is de beschrijving ervan.

Koppel de uitvoeropdracht aan die benoemde stap, zodat het activeren ervan het werk daadwerkelijk uitvoert. Nu betekent de naam run ook echt iets.

Nu de stap is gekoppeld, bouwt zig build run de app en voert die onmiddellijk uit. Met één opdracht ga je van broncode naar uitvoer.

Geef opdrachtregelargumenten door aan je programma met addArgs. Lees ze uit b.args nadat er een dubbele min op de opdrachtregel staat.

Alles na -- wordt aan je app doorgegeven en niet aan Zig. Zo geeft zig build run -- hello hello door aan je programma.

Ben je de namen vergeten? Voer zig build --help uit om elke stap te zien die je met b.step hebt gedeclareerd, inclusief de beschrijving.

Elke stap hangt af van andere stappen. Als je er één activeert, wordt dus de volledige afhankelijkheidsketen in de juiste volgorde uitgevoerd, waarbij alleen gewijzigde onderdelen opnieuw worden gebouwd. ✅

Je hebt een uitvoerstap gekoppeld: addRunArtifact, afhankelijk gemaakt van install, benoemd met b.step en b.args doorgegeven, zodat zig build run je app start. 🎯