Oprettelse og administration af releases

GitHub-funktionen Releases hjælper dig med at pakke og levere stabile versioner af din software til brugerne. Tænk på det som en formel meddelelse om en ny version.

Det er afgørende for projekter, der skal distribuere kompilerede binærfiler, dokumentation eller bestemte øjebliksbilleder af kildekoden.

Alle GitHub-udgivelser er direkte knyttet til et Git-tag. Et tag markerer et bestemt punkt i dit repositories historik, normalt et versionsnummer som v1.0.0.

• Tags giver en permanent, uforanderlig reference til en commit.
• Udgivelser føjer omfattende metadata (f.eks. udgivelsesnoter og filer) oven på dette tag.

Før du opretter en udgivelse, skal du sikre dig, at du har sendt det ønskede tag til GitHub!

Udgivelsesnoter er beskrivelser, der forklarer, hvad der er nyt, forbedret eller rettet i en bestemt version. De er afgørende for kommunikationen af ændringer til dine brugere.

• Brug et klart og kortfattet sprog.
• Fremhæv vigtige funktioner og fejlrettelser.
• Markdown-formatering understøttes til formateret tekst.

Udgivelsesfiler er filer, du kan vedhæfte til en udgivelse, så de kan downloades. Det kan f.eks. være:

• Kompilerede binærfiler (f.eks. .exe, .dmg)
• Komprimeret kildekode (.zip, .tar.gz)
• Dokumentationsfiler eller installationsprogrammer

De giver brugerne alt, hvad de har brug for til den pågældende version, samlet ét sted.

Sådan opretter du en udgivelse:

1. Gå til dit repository på GitHub.
2. Klik på 'Releases' (findes ofte i højre sidepanel eller under fanen 'Code').
3. Klik på knappen 'Draft a new release'.

Det åbner en formular, hvor du kan angive oplysningerne om din udgivelse.

På siden til oprettelse af udgivelser skal du:

• Vælge et eksisterende Git-tag eller oprette et nyt.
• Angive en titel på udgivelsen (f.eks. 'Version 1.0.0 - Første udgivelse').
• Skrive dine detaljerede udgivelsesnoter.

Du kan markere den som en 'pre-release' (til test) eller udgive den direkte.

GitHub kan hjælpe dig med at generere udgivelsesnoter automatisk!

Ved at klikke på 'Generate release notes' gennemgår GitHub commits og pull requests, der er blevet flettet siden det seneste udgivelsestag, og foreslår en opsummering. Derefter kan du redigere og finpudse den.

Når dine udgivelsesnoter er klar, kan du uploade filer.

Træk og slip blot filer i det angivne område, eller klik for at gennemse dem. GitHub uploader dem, og de vises som filer, der kan downloades, på din udgivelsesside.

Fejl sker! Du kan altid redigere eller slette en udgivelse.

• Find den udgivelse, du vil ændre, på siden 'Releases'.
• Klik på blyantikonet for at redigere eller på papirkurvsikonet for at slette.

Ved redigering kan du ændre noter, titel eller filer. Når du sletter en udgivelse, fjernes den fra GitHub, men det underliggende Git-tag bevares.

Du har lært, hvordan du opretter og administrerer GitHub-udgivelser!

• Udgivelser giver formelle snapshots af dit projekt med versionsnumre.
• De bygger på Git-tags og indeholder udgivelsesnoter samt valgfri filer.
• Du kan oprette, redigere og slette udgivelser via GitHubs brugerflade.

Det gør det nemt for brugere at finde og downloade stabile versioner af din software.