julkaisutiedostoille

Julkaisutiedostoille tarkoitetaan projektin julkaisun yhteydessä jaettavia tiedostoja, joita käyttäjät voivat ladata ja asentaa. Ne muodostavat julkaisun artefaktikokonaisuuden ja voivat sisältää sekä lähdekoodin että valmiiksi rakennettuja binäärejä. Julkaisutiedostoilla pyritään tarjoamaan toimiva, dokumentoitu ja riippuvuuksiltaan hallittu kokonaisuus.

Yleisimpiin julkaisutiedostoihin kuuluvat muun muassa lähdearkistot (esimerkiksi .tar.gz tai .zip), binääriarkistot (esimerkiksi Windows .exe tai .msi, macOS .dmg, Linux .AppImage sekä .deb- ja .rpm-paketit), sekä erityyppiset asennuspaketit. Lisäksi julkaisuun sisältyvät usein lisenssi-tiedosto (LICENSE), README- ja INSTALL-ohjeet, CHANGELOG tai Release Notes sekä mahdolliset tekijänoikeudet ja vastuuvapautusilmoitukset. Tiedostojen eheyden ja aitouden varmistamiseksi tarjotaan usein digitaalisia allekirjoituksia sekä summatiedostoja (esimerkiksi SHA256SUMS).

Julkaisuprosessiin kuuluu versionhallinnan tagien käyttäminen, automatisoitu rakennus ja artefaktien julkaiseminen valitulle julkaisusivustolle tai pakettivarastoon (esimerkiksi GitHub Releases, GitLab Releases tai vastaavat paketinhallintajärjestelmät). Julkaisut voivat sisältää sekä lähdekoodin että käännetyt binäärit sekä asianmukaiset ohjeet eri alustoille.

Turvallisuus ja verifikaatio ovat keskeisiä: allekirjoitukset, tarkistetut summaariset arvot ja mahdollisuus toistaa rakennus konfiguraatioineen parantavat luotettavuutta. Reproducible builds -mahdollisuus on suositeltavaa, jotta käyttäjät voivat vahvistaa tulosten identiyden.

Käytännön suositukset sisältävät sekä lähde- että binääritiedostojen tarjoamisen, tuen eri arkkitehtuureille ja alustoille, selkeät julkaisun versionumerot sekä ajan tasalla pidetyn changelogin. Lisäksi tulisi noudattaa projektin lisenssi- ja dokumentaatiokäytäntöjä.