Release (NL)

Een release is een versie van je app die je uitbrengt: met een versienummer, een label op GitHub en de bestanden die mensen kunnen downloaden. Dat doe je op de pagina Release.

Versienummers

Coodoo houdt versienummers bij volgens semantic versioning: 1.4.2 betekent grote versie 1, functieversie 4, fixversie 2.

• Na elk doel verhoogt Coodoo het nummer van elk onderdeel dat veranderde en schrijft wat er nieuw is in CHANGELOG.md. Dit staat aan bij Autopilot-instellingen → Versienummers bijhouden.
• De nummers staan in .coodoo/versions.json, het enige teamgeheugenbestand dat wel in git staat.
• Op het dashboard zie je ze bij Onderdelen.

Changelog voor gebruikers

CHANGELOG.md is technisch. Daarnaast schrijft Coodoo bij elke nieuwe versie een changelog voor de mensen die je app gebruiken: alleen wat zij merken, in gewone taal, gegroepeerd onder Nieuw, Opgelost en Verbeterd.

• Kies de talen bij Autopilot-instellingen → Changelog voor gebruikers. Standaard is dat Nederlands. Een taal die je later toevoegt, krijgt een item vanaf de volgende versie; oudere versies vul je aan op de pagina Changelog.
• Per taal staat de changelog in changelog/nl.md, changelog/en.md enzovoort, met de nieuwste versie bovenaan. De bestanden gaan mee in de versie-commit.
• Merken gebruikers niets van een versie, bijvoorbeeld bij alleen onderhoud, dan staat er één neutrale zin.
• Lukt het schrijven niet, dan gaat de versie gewoon door. Coodoo onthoudt in .coodoo/versions.json welk item nog ontbreekt.
• Bij een release op GitHub wordt deze changelog de releasetekst: in de taal van Coodoo als je project die heeft, anders in de eerste gekozen taal.

Eenmalig instellen

De eerste keer klik je op Eerst eenmalig instellen. Je beantwoordt een paar vragen:

Vanaf welke branch?

De branch waaruit je uitbrengt, meestal main.

Waar wordt er gebouwd?

• Op deze computer: gratis. Vul het Bouwcommando in, of klik op Voorstel invullen zodat Coodoo het voorstelt.
• Op GitHub (Actions): GitHub bouwt het. Vul de Naam van de workflow in (standaard release.yml). De workflow moet met de hand te starten zijn (workflow_dispatch) en een invoer tag hebben.

Welke bestanden komen in de release?

Patronen voor de bestanden die mee moeten, zoals dist/*.dmg of build/*.zip.

Geavanceerd: variabelen voor de build

Heeft de build sleutels nodig (bijvoorbeeld om je app te ondertekenen)? Kies per variabele een sleutel uit de Projectkluis of een Gewone waarde.

Waar kunnen releases heen?

Bestemming	Wat je nodig hebt
GitHub, in deze repository	Niets extra
GitHub, in een andere repository	De Repository, en een token: Mijn GitHub-login in Coodoo of een token uit de kluis
Eigen opslag (S3)	Bucket, Regio, eventueel het Adres van de opslag (voor Cloudflare R2, DigitalOcean Spaces of MinIO), een Map in de bucket (standaard {tag}/) en de toegangssleutels uit de kluis

Een versie uitbrengen

1. Klik op Nieuwe versie uitbrengen.
2. Welke versie wordt dit? Coodoo doet een voorstel op basis van wat er veranderde (aanbevolen). Of kies zelf: Grote wijziging, Nieuwe functies, Alleen fixes, de Huidige versie, of Zelf invullen.
3. Waarheen: kies de bestemming.
4. Klik op Uitbrengen.

Coodoo doorloopt dan: Controleren → Versie zetten → Bouwen → Versielabel op GitHub → Uploaden. Bestanden gaan eerst naar een concept-release, die pas gepubliceerd wordt als alles gelukt is.

Bij Eerdere releases zie je wat er al uitgebracht is.

Let op: Een bestand dat al in een release staat, wordt nooit vervangen, en Coodoo verwijdert nooit iets. Wil je een release opnieuw doen, breng dan een nieuwe versie uit.