Deb-paketin tekeminen - Muutoshistoria

Lahtis: /* Katso myös */

2025-11-14T23:32:49Z

Katso myös

← Vanhempi versio		Versio 15. marraskuuta 2025 kello 02.32
Rivi 380:		Rivi 380:

	==Katso myös==		==Katso myös==
	* [[Deb-paketin tekeminen ~~2025~~]] Päivitetty versio.		* [[Deb-paketin tekeminen (Moderni opas)]] Päivitetty versio (2025).
	* [[CDBS]]		* [[CDBS]]

Lahtis: /* Katso myös */

2025-11-14T23:27:21Z

Katso myös

← Vanhempi versio		Versio 15. marraskuuta 2025 kello 02.27
Rivi 380:		Rivi 380:

	==Katso myös==		==Katso myös==
	*[[CDBS]]		* [[Deb-paketin tekeminen 2025]] Päivitetty versio.
			* [[CDBS]]

	==Aiheesta muualla==		==Aiheesta muualla==

Eojl: /* Aiheesta muualla */

2017-02-23T13:36:09Z

Aiheesta muualla

← Vanhempi versio		Versio 23. helmikuuta 2017 kello 16.36
Rivi 387:		Rivi 387:
	*Ubuntun [https://wiki.ubuntu.com/PackagingGuide PackagingGuide]-opas		*Ubuntun [https://wiki.ubuntu.com/PackagingGuide PackagingGuide]-opas
	*[http://wiki.ubuntu.com/PackagingGuide Packaging guide - Ubuntu Wiki]		*[http://wiki.ubuntu.com/PackagingGuide Packaging guide - Ubuntu Wiki]
	*[~~http~~://~~www.~~debian-administration.org/~~articles~~/286 Setting up your own APT ~~reposity~~]		*[https://debian-administration.org/article/286/Setting_up_your_own_APT_repository_with_upload_support Setting up your own APT repository with upload support]
	*Vincent Bernat: [https://vincent.bernat.im/en/blog/2016-pragmatic-debian-packaging.html Pragmatic Debian packaging]		*Vincent Bernat: [https://vincent.bernat.im/en/blog/2016-pragmatic-debian-packaging.html Pragmatic Debian packaging]

Apdeit: /* Aiheesta muualla */ Pragmatic Debian Packaging

2016-12-26T11:20:53Z

Aiheesta muualla: Pragmatic Debian Packaging

← Vanhempi versio		Versio 26. joulukuuta 2016 kello 14.20
Rivi 388:		Rivi 388:
	*[http://wiki.ubuntu.com/PackagingGuide Packaging guide - Ubuntu Wiki]		*[http://wiki.ubuntu.com/PackagingGuide Packaging guide - Ubuntu Wiki]
	*[http://www.debian-administration.org/articles/286 Setting up your own APT reposity]		*[http://www.debian-administration.org/articles/286 Setting up your own APT reposity]
			*Vincent Bernat: [https://vincent.bernat.im/en/blog/2016-pragmatic-debian-packaging.html Pragmatic Debian packaging]

	[[Luokka:Ohjeet]]		[[Luokka:Ohjeet]]
	[[Luokka:Paketinhallinta]]		[[Luokka:Paketinhallinta]]
	[[Luokka:Debian GNU/Linux]]		[[Luokka:Debian GNU/Linux]]

Apdeit: /* Valmistelut */

2016-12-26T11:17:53Z

Valmistelut

← Vanhempi versio		Versio 26. joulukuuta 2016 kello 14.17
Rivi 6:		Rivi 6:

	== Valmistelut ==		== Valmistelut ==
	Aluksi on hyvä asentaa muutamia perustyökaluja, jotka sisältävät paketointityössä tarvittavia tai valinnaisia apuohjelmia. Asenna siis seuraavat paketit:		Aluksi on hyvä asentaa muutamia perustyökaluja, jotka sisältävät paketointityössä tarvittavia tai valinnaisia apuohjelmia. Asenna siis seuraavat paketit (<tt>[[APT#apt\|apt]] install <i>paketit</i></tt>):
	dpkg-dev autoconf dh-make devscripts [[fakeroot]] [[Gpg\|gnupg]] build-essential lintian libtool automake pbuilder		dpkg-dev autoconf dh-make devscripts [[fakeroot]] [[Gpg\|gnupg]] build-essential lintian libtool automake pbuilder

Apdeit: /* Katso myös */ cdbs

2016-08-30T10:33:42Z

Katso myös: cdbs

← Vanhempi versio		Versio 30. elokuuta 2016 kello 13.33
Rivi 378:		Rivi 378:

	Virallisten pakettilähteiden lisäksi voit myös ylläpitää omaa. Paketteja voi myös jakaa helposti esimerkiksi [[Launchpad \| Launchpadin]] tarjoaman [[PPA]]-ominaisuuden avulla. PPA automatisoi paketin kääntämistä ja julkaisua. Halutessasi voit myös vain yksinkertaisesti jakaa tekemääsi deb-tiedostoa millä tahansa tiedostonjakotekniikalla.		Virallisten pakettilähteiden lisäksi voit myös ylläpitää omaa. Paketteja voi myös jakaa helposti esimerkiksi [[Launchpad \| Launchpadin]] tarjoaman [[PPA]]-ominaisuuden avulla. PPA automatisoi paketin kääntämistä ja julkaisua. Halutessasi voit myös vain yksinkertaisesti jakaa tekemääsi deb-tiedostoa millä tahansa tiedostonjakotekniikalla.

			==Katso myös==
			*[[CDBS]]

	==Aiheesta muualla==		==Aiheesta muualla==

Apdeit: rules

2016-08-16T15:30:23Z

rules

Näytä muutokset

Apdeit: johdanto, rules, jäi keskeneräiseen kuntoon

2016-08-15T19:41:10Z

johdanto, rules, jäi keskeneräiseen kuntoon

@@ Rivi 4: / Rivi 4: @@
 <hr/>
-[[Debian]]issa ja siihen pohjautuvissa jakeluissa (esim. [[Knoppix]]issa, [[MEPIS]]issä ja [[Ubuntu]]ssa) käytetään [[Dpkg]]-paketinhallintajärjestelmää. Dpkg:ssa paketit ovat <tt>.deb</tt>-tiedostoja, jotka sisältävät itse ohjelman lisäksi mm. tiedot paketin riippuvuuksista ja siitä, mihin ohjelma asennetaan. Deb-pakettien tekeminen ei ole mitenkään ylivoimainen tehtävä, kunhan perusasiat ja mm. [[komentorivi|komentorivin käyttö]] ovat hallussa.
+[[Debian]]issa ja siihen pohjautuvissa jakeluissa (esim. [[Ubuntu]]ssa ja [[Linux Mint]]issä) käytetään [[Dpkg]]-paketinhallintajärjestelmää. Dpkg:ssa paketit ovat <tt>.deb</tt>-tiedostoja, jotka sisältävät itse ohjelman lisäksi mm. tiedot paketin riippuvuuksista ja siitä, mihin ohjelma asennetaan. Deb-pakettien tekeminen ei ole mitenkään ylivoimainen tehtävä, kunhan perusasiat ja mm. [[komentorivi|komentorivin käyttö]] ovat hallussa.
-Tässä oppaassa luodaan aluksi malliksi yksinkertainen paketti [http://www.gnu.org/software/hello/ GNU Hello] -ohjelmasta, joka on [[GNU]]-projektin esimerkkiohjelma. Ohjelman lähdekoodipaketin voi ladata [http://ftp.gnu.org/gnu/hello/ GNU:n palvelimelta]. Paketin luomisessa käytetään tässä apuna Debhelper-apuohjelmaa. Tämä ei aina ole yksinkertaisin tapa paketoida ohjelma, mutta ennen helpottaviin tekniikoihin tutustumista on hyvä käydä asiat yksityiskohtaisemmin läpi.
+Tässä oppaassa luodaan aluksi malliksi yksinkertainen paketti [http://www.gnu.org/software/hello/ GNU Hello] -ohjelmasta, joka on [[GNU]]-projektin esimerkkiohjelma. Ohjelman lähdekoodipaketin voi ladata [http://ftp.gnu.org/gnu/hello/ GNU:n palvelimelta]. Paketin luomisessa käytetään tässä apuna Debhelper-apuohjelmaa.
 Debianin eri versiosta löytyvän paketin voi kääntää käytetylle versiolle sopivaksi tai pakettiin tehdä pieniä muutoksia huomattavasti helpommin kuin tätä ohjetta seuraamalla, komennoilla <tt>apt-get build-dep paketti</tt>, <tt>apt-get source paketti</tt> ja <tt>dpkg-deb -build pakettihakemisto</tt>, jolloin muutokset tehdään viimeksi mainittujen välissä (varsinainen muutos + uusi kohta tiedostoon <tt>debian/changelog</tt>). Jos paketti tehdään valmiista Debianin lähdekoodipaketista, kääntämisen binääripaketiksi voi hoitaa paketin hakemisen yhteydessä komennolla <tt>apt-get --compile source paketti</tt>. Lisätietoja näistä komennoista löytyy artikkeleista [[apt-get]] ja [[dpkg]].
@@ Rivi 145: / Rivi 143: @@
 Koska Hello käyttää autoconfia, osaa paketin luova työkalu tehdä tarvittavat asetukset itse, eikä meidän periaatteessa tarvitse edes koskea <tt>rules</tt>-tiedostoon. Katsotaan nyt kuitenkin sitä malliksi, sillä vähänkin monimutkaisempien pakettien kohdalla sitä on muokattava. Dh_maken luoma malli on seuraava: (rivinumerot lisätty)
 <source lang="make" line>
-  #!/usr/bin/make -f
+#!/usr/bin/make -f
 </source>
 Tiedoston alussa annetaan käännösoptiot, esimerkiksi [[gcc|C-kääntäjän]] käännösparametrit laitetaan muuttujaan CFLAGS. Tämä tehdään riveillä 19-25.

Apdeit (31. heinäkuuta 2016 kello 17.22)

2016-07-31T17:22:38Z

← Vanhempi versio		Versio 31. heinäkuuta 2016 kello 20.22
Rivi 47:		Rivi 47:

	== Asetustiedostot ==		== Asetustiedostot ==
	~~Dh_make~~ loi <tt>debian</tt>-hakemiston, joka sisältää monia tiedostoja, joiden perusteella itse paketti luodaan. Tässä vaiheessa on käytävä ne läpi ja muokattava sopiviksi.		<tt>dh_make</tt> loi <tt>debian</tt>-hakemiston, joka sisältää monia tiedostoja, joiden perusteella itse paketti luodaan. Tässä vaiheessa on käytävä ne läpi ja muokattava sopiviksi.

	=== control ===		=== control ===
Rivi 100:		Rivi 100:
	</source>		</source>

	=== Suositeltavat paketit, ristiriidat ja muut suhteet toisiin paketteihin ===		==== Suositeltavat paketit, ristiriidat ja muut suhteet toisiin paketteihin ====
	Riippuvuuksien lisäksi paketti voi myös suositella jonkun toisen paketin asentamista, tai se voi myös kieltäytyä asentumasta samaan järjestelmään jonkin toisen paketin kanssa (ristiriita toisen paketin kanssa, engl. ''conflict''). Tällaiset paketit esitellään <tt>control</tt>-tiedostossa samaan tapaan kuin riippuvuudet.		Riippuvuuksien lisäksi paketti voi myös suositella jonkun toisen paketin asentamista, tai se voi myös kieltäytyä asentumasta samaan järjestelmään jonkin toisen paketin kanssa (ristiriita toisen paketin kanssa, engl. ''conflict''). Tällaiset paketit esitellään <tt>control</tt>-tiedostossa samaan tapaan kuin riippuvuudet.

Rivi 190:		Rivi 190:

	Jos paketti ei käytä autoconfia, on <tt>rules</tt> muokattava sellaiseksi, että ohjelma kääntyy ja asentuu polkuun <tt>debian/''paketinnimi''</tt>. Se, miten kääntäminen tapahtuu, riippuu ohjelmasta. Funktion <tt>dh_install</tt> avulla asennetaan tiedostot oikeisiin hakemistoihin lopullisessa binaaripaketissa.		Jos paketti ei käytä autoconfia, on <tt>rules</tt> muokattava sellaiseksi, että ohjelma kääntyy ja asentuu polkuun <tt>debian/''paketinnimi''</tt>. Se, miten kääntäminen tapahtuu, riippuu ohjelmasta. Funktion <tt>dh_install</tt> avulla asennetaan tiedostot oikeisiin hakemistoihin lopullisessa binaaripaketissa.

			=== compat ===
			Tässä tiedostossa ilmoitamme, mitä versiota debhelperistä käytämme.

			=== source/format ===
			Tätä tiedostoa ei tarvitse muuttaa. Sen sisältö on:
			3.0 (quilt)
			Quilt viittaa [[#Patchit\|patchien hallintaan]] käyttämäämme ohjelmaan. 3.0:n merkityksestä voi lukea tarkemmin Debian Wikin artikkelista [https://wiki.debian.org/Projects/DebSrc3.0 DebSrc3.0].

	=== .ex-päätteiset tiedostot ===		=== .ex-päätteiset tiedostot ===
Rivi 228:		Rivi 236:

	Tämän jälkeen, jos kaikki sujui ilman virheitä, ylähakemistosta pitäisi löytyä seuraavat tiedostot:		Tämän jälkeen, jos kaikki sujui ilman virheitä, ylähakemistosta pitäisi löytyä seuraavat tiedostot:
	*<tt>hello_2.6.~~orig.tar.gz~~</tt> ~~- alkuperäinen lähdekoodi~~		*<tt>hello_2.10-1_amd64.build</tt> – kääntämisloki (''build log'')
	*<tt>hello_2.6-1.~~dsc~~</tt> - [[gpg]]:llä allekirjoitettu <tt>~~control~~</tt>~~-tiedoston kaltainen tiedosto, jossa on listattu lähdekooditiedoston~~ ja ~~diff-tiedoston~~ [[~~md5~~]]-summat		*<tt>hello_2.10-1_amd64.changes</tt> – [[gpg]]:llä allekirjoitettu tiedosto, joka sisältää paketin muutoslokin (<tt>debian/changelog</tt>) ja pakettiin liittyvien tiedostojen [[SHA]]1- ja SHA256-summat
	*<tt>hello_2.6-1.~~diff.gz~~</tt> - ~~[[gzip]]-pakattu [[diff]]-tiedosto lähdekoodiin tehdyistä muutoksista~~		*<tt>hello_2.10-1_amd64.deb</tt> – lopullinen deb-paketti!
	*<tt>hello_2.6-~~1_i386~~.~~deb~~</tt> - ~~lopullinen deb~~-~~paketti!~~		*<tt>hello_2.10-1.debian.tar.xz</tt> – <tt>debian-hakemiston</tt> sisältö [[xz]]-pakattuna tar-arkistona
	*<tt>hello_2.6-~~1_i386~~.~~changes~~</tt> - [[gpg]]:llä allekirjoitettu ~~tiedosto, joka sisältää paketin muutoslokin (~~<tt>~~debian/changelog~~</tt>) ja ~~pakettiin liittyvien tiedostojen md5~~-summat		*<tt>hello_2.10-1.dsc</tt> – [[gpg]]:llä allekirjoitettu <tt>control</tt>-tiedoston kaltainen tiedosto, jossa on listattu lähdekooditiedoston ja diff-tiedoston SHA1- ja SHA256-summat
			*<tt>hello_2.10.orig.tar.gz</tt> – alkuperäinen lähdekoodi

	Nyt lopullinen paketti voidaan asentaa [[dpkg]]:llä:		Nyt lopullinen paketti voidaan asentaa [[dpkg]]:llä:
	dpkg -i hello_2.6-~~1_i386~~.deb		dpkg -i hello_2.10-1_amd64.deb

	Kun myöhemmin teet muutoksia pakettiin, voit luoda uuden paketin nopeasti komennolla		Kun myöhemmin teet muutoksia pakettiin, voit luoda uuden paketin nopeasti komennolla
Rivi 242:		Rivi 251:

	=== Lähdekoodipaketti ===		=== Lähdekoodipaketti ===
	Edellä teimme tavallisen ns. ''binääripaketin'', joka sisältää valmiiksi käännetyn ohjelman. Monesti on tarpeen tehdä myös lähdekoodipaketti, joka sisältää pakettiin ja sen kääntämiseen ja asentamiseen liittyvät tiedot (<tt>debian</tt>-hakemisto) ja ohjelman lähdekoodin. Tällöin paketti on mahdollista kääntää ja asentaa jokaiselle sopivalle alustalle kun taas käännetty <tt>.deb</tt>-paketti toimii vain yhdellä alustalla (esim. ~~x86~~).		Edellä teimme tavallisen ns. ''binääripaketin'', joka sisältää valmiiksi käännetyn ohjelman. Monesti on tarpeen tehdä myös lähdekoodipaketti, joka sisältää pakettiin ja sen kääntämiseen ja asentamiseen liittyvät tiedot (<tt>debian</tt>-hakemisto) ja ohjelman lähdekoodin. Tällöin paketti on mahdollista kääntää ja asentaa jokaiselle sopivalle alustalle kun taas käännetty <tt>.deb</tt>-paketti toimii vain yhdellä alustalla (esim. amd64, i386 tai armhf).

	Lähdekoodipaketteja käytetään etenkin kun paketti julkaistaan esimerkiksi lisäämällä se jonkin jakelun virallisiin pakettilähteisiin. Tällöin kehittäjä yleensä vain lähettää palvelimelle lähdekoodipaketin, jonka palvelin sitten kääntää useille eri arkkitehtuureille.		Lähdekoodipaketteja käytetään etenkin kun paketti julkaistaan esimerkiksi lisäämällä se jonkin jakelun virallisiin pakettilähteisiin. Tällöin kehittäjä yleensä vain lähettää palvelimelle lähdekoodipaketin, jonka palvelin sitten kääntää useille eri arkkitehtuureille.
Rivi 250:		Rivi 259:
	Missä valitsin <tt>-S</tt> tarkoittaa, että luodaan lähdekoodipaketti ja <tt>-sa</tt> sisällyttää pakettiin mukaan alkuperäisen lähdekooditiedoston (<tt>.orig.tar.gz</tt>). Tällöin ylähakemistoon pitäisi ilmestyä samanlaisten tiedostojen kuin luotaessa binääripakettia, paitsi että varsinaista <tt>.deb</tt>-pakettia ei ilmesty.		Missä valitsin <tt>-S</tt> tarkoittaa, että luodaan lähdekoodipaketti ja <tt>-sa</tt> sisällyttää pakettiin mukaan alkuperäisen lähdekooditiedoston (<tt>.orig.tar.gz</tt>). Tällöin ylähakemistoon pitäisi ilmestyä samanlaisten tiedostojen kuin luotaessa binääripakettia, paitsi että varsinaista <tt>.deb</tt>-pakettia ei ilmesty.

	Nyt lähdekoodipaketti koostuu näistä tiedostoista (<tt>paketti.dsc</tt>, <tt>paketti.orig.tar.gz</tt> ja <tt>paketti.~~diff~~.gz</tt>), ja sitä voidaan hallita esimerkiksi <tt>dpkg-source</tt>-ohjelmalla. Jos esimerkiksi olet saanut jostain lähdekoodipaketin, voit purkaa ja kääntää seuraavasti		Nyt lähdekoodipaketti koostuu näistä tiedostoista (<tt>paketti.dsc</tt>, <tt>paketti.orig.tar.gz</tt> ja <tt>paketti.debian.tar.xz</tt>), ja sitä voidaan hallita esimerkiksi <tt>dpkg-source</tt>-ohjelmalla. Jos esimerkiksi olet saanut jostain lähdekoodipaketin, voit purkaa ja kääntää seuraavasti
	dpkg-source -x paketti.dsc		dpkg-source -x paketti.dsc
	cd paketti		cd paketti
Rivi 259:		Rivi 268:
	== Lintian: onnistuiko paketti? ==		== Lintian: onnistuiko paketti? ==
	Lintian on ohjelma, joka tarkistaa tekemäsi paketin laadun. Sille annetaan parametrina pakettia luotaessa syntynyt <tt>.changes</tt>-päätteinen tiedosto. Yleensä kannattaa antaa myös valitsin -i, jolloin lintian kertoo tarkemmin, mikä paketissa on vialla:		Lintian on ohjelma, joka tarkistaa tekemäsi paketin laadun. Sille annetaan parametrina pakettia luotaessa syntynyt <tt>.changes</tt>-päätteinen tiedosto. Yleensä kannattaa antaa myös valitsin -i, jolloin lintian kertoo tarkemmin, mikä paketissa on vialla:
	lintian -i hello_2.6-~~1_i386~~.changes		lintian -i hello_2.10-1_amd64.changes
	Tulosteessa E:-alkavat rivit tarkoittavat virhettä, W:-alkavat varoituksia ja N:-alkavat huomautuksia.		Tulosteessa E:-alkavat rivit tarkoittavat virhettä, W:-alkavat varoituksia ja N:-alkavat huomautuksia.

Apdeit: /* changelog */ ''lähdekoodi''paketin nimi

2016-07-31T16:39:00Z

changelog: ''lähdekoodi''paketin nimi

← Vanhempi versio		Versio 31. heinäkuuta 2016 kello 19.39
Rivi 132:		Rivi 132:
	4 -- Paketin Tekijä <foo@bar.com> Fri, 29 Jul 2016 11:42:23 +0300		4 -- Paketin Tekijä <foo@bar.com> Fri, 29 Jul 2016 11:42:23 +0300
	</pre>		</pre>
	Rivillä 1 on aluksi ~~paketin~~ nimi (hello) ja versionumero (2.10-1). Seuraavana on jakelun nimi, johon paketti kuuluu (Debianilla on stable, testing ja unstable -jakelut). Yleensä uudet paketit ja päivitykset vanhoihin paketteihin lisätään ensin kehitysversioon, joka Debianilla on unstable. Viimeisenä on tieto paketin kiireellisyydestä (''urgency''), yleensä "medium" on sille oikea arvo.		Rivillä 1 on aluksi lähdekoodipaketin nimi (hello) ja versionumero (2.10-1). Seuraavana on jakelun nimi, johon paketti kuuluu (Debianilla on stable, testing ja unstable -jakelut). Yleensä uudet paketit ja päivitykset vanhoihin paketteihin lisätään ensin kehitysversioon, joka Debianilla on unstable. Viimeisenä on tieto paketin kiireellisyydestä (''urgency''), yleensä "medium" on sille oikea arvo.

	Tämän jälkeen seuraavilla riveillä on itse muutosloki (engl. ''changelog''). Rivin alussa on kaksi välilyöntiä ja tähti (*). Viimeisenä (rivillä 4) on tieto paketin tekijästä ja tekoajankohdasta (esimerkin mukaisessa muodossa). Tämän rivin alussa on yksi välilyönti.		Tämän jälkeen seuraavilla riveillä on itse muutosloki (engl. ''changelog''). Rivin alussa on kaksi välilyöntiä ja tähti (*). Viimeisenä (rivillä 4) on tieto paketin tekijästä ja tekoajankohdasta (esimerkin mukaisessa muodossa). Tämän rivin alussa on yksi välilyönti.