Ero sivun ”Kääntäminen” versioiden välillä

Linux.fista
Siirry navigaatioon Siirry hakuun
p (checkinstall-hehkutusta vielä)
p (Mikäli ''configure''-tiedostoa ei löydy.)
 
(17 välissä olevaa versiota 8 käyttäjän tekeminä ei näytetä)
Rivi 1: Rivi 1:
Ohjelma kannattaa yleisesti ottaen asentaa jotenkin [[Ohjelmien asentaminen|muuten]]. Jos itse kääntäminen on välttämätöntä, se käy yleensä näin:
{{vaihtoehdot|koodin kääntämistä konekieleksi|Ohjelmatekstin suomeksi kääntämisestä|kotoistus}}


# Tarkista että ainakin [[gcc]] ja [[make]] ovat asennettuina.
[[wikipedia:fi:Ohjelmointikielen kääntäjä|Kääntämisellä]] tarkoitetaan toimenpidettä, jossa ohjelman [[lähdekoodi]]n perusteella luodaan konekielinen ohjelma, joka on tietokoneen ymmärtämässä muodossa. Konekielinen ohjelma toimii yleensä vain tietyn käyttöjärjestelmän ja prosessorityypin yhdistelmällä, kun taas samasta lähdekoodista voidaan yleensä (jos lähdekoodi on sopivasti kirjoitettu) kääntää versiot monille eri alustoille. Lisäksi lähdekoodia on mahdollista muokata, jos omaa kohtalaiset ohjelmointitaidot. Konekielisen ohjelman muokkaaminen taas ei ole käytännössä mahdollista kuin erittäin rajoitetusti.
# Kopio ohjelman lähdekoodipaketti ja pura se ( [[tar]] xvzf hyvasofta.tar.gz / tar xvjf hyvasofta.tar.bz2)
# Siirry paketin hakemistoon (cd hyvasofta)
# Hakemistossa on yleensä tekstitiedostoja, joiden nimet ovat README, INSTALL taikka jotain muuta vastaavaa. Lue nämä ja varmista, että kääntäminen todella tapahtuu niin kuin seuraavassa kerrotaan.
# Aja configure-[[Bash-skriptaus|skripti]] komennolla ./configure. Jos configure-skriptiä ei ole, kokeile komentoja make config ja/tai make menuconfig. Jos mistään ei tapahdu mitään, katso olisiko hakemistossa install.sh tyylistä skriptiä. Jos on, aja se (./install.sh)
# Jos configure-skripti ei mene kunnialla läpi, syy on usein puuttuvissa kehityskirjastoissa. Asenna siis mainitut kirjastot.
# Käännä ohjelma komennolla make
# Siirry pääkäyttäjäksi komennolla su - ja asenna ohjelma komennolla make install (ks. [[CheckInstall]])


Joskus configure-skriptissä tulee virheitä puuttuvien pakettien kanssa. Tällöin täytyy vain etsiä jostain tarvittava [[kirjasto]] ja asentaa se ensin. On myös mahdollista, että kirjasto itsessään on jo asennettuna, mutta sen header - tiedostoja ym. sisältävä kehityspaketti puuttuu. Esimerkiksi, mikäli configure jää kaipaamaan libaudiofile - pakettia ja se on asennettuna, saattaa kehityspaketti olla nimeltään ([[Debian]]in tapauksessa) libaudiofile-dev. Debianissa ohjelman kääntämiseen tarvittavat kirjastot on useimmiten helppo asentaa komentamalla:
Jos haluaa muokata oman jakelun pakettia, tämä kannattaa tehdä jakelun omilla työkaluilla ja mieluiten jakelun omasta lähdekoodista (ellei nimenomaan halua toista versiota ohjelmasta - silloinkin jakelun tekemät muutokset on hyvä huomioida). Oman jakelun lähdekoodipaketit on yleensä mahdollista asentaa [[paketinhallinta|paketinhallinnan]] kautta erillisestä asennuslähteestä (source). Jatkossa käsitellään muualta haetun lähdekoodin kääntämistä ja asentamista ilman jakelun omia työkaluja.
apt-get build-dep ohjelma


On myös suositeltavaa käyttää configure:n kanssa parametriä --prefix=/opt/hyvasofta jolloin ohjelma asentuu annettuun polkuun (yleensä /opt-alkuinen) ja sieltä se on helppo tarvittaessa poistaa. [[CheckInstall]] toteuttaa saman toimenpiteen ja luo vielä pakettienhallintaan paketitkin.
==Perinteinen tapa==
Ohjelmat kannattaa yleisesti ottaen asentaa jotenkin [[Ohjelmien asentaminen|muuten]] kuin muualta haettua koodia kääntämällä. Jos itse kääntäminen on välttämätöntä, käy se yleensä näin:


Joskus Makefilessä on myös uninstall-toiminto, jolla ohjelma poisto onnistuu kätevästi komennolla <tt>make uninstall</tt>. Huomaa kuitenkin, että mikäli esimerkiksi poistat näin jonkin kirjaston, sitä käyttävät ohjelmat lakkaavat toimimasta.
* Tarkista että ainakin [[gcc]] ja [[make]] ovat asennettuina.
* Hanki jostakin ohjelman lähdekoodit, joko kopioi ohjelman lähdekoodipaketti ja pura se
 
[[tar]] xvzf hyvasofta.tar.[[gz]]
tai
tar xvjf hyvasofta.tar.[[bz2]]
 
tai käytä ohjelmistoprojektin [[versionhallintajärjestelmä]]ä.
 
* Siirry paketin hakemistoon.
cd hyvasofta
 
* Hakemistossa on yleensä tekstitiedostoja, joiden nimet ovat <tt>README</tt>, <tt>INSTALL</tt> tai vastaavaa. Lue nämä ja varmista, että kääntäminen todella tapahtuu niin kuin seuraavassa kerrotaan.
 
* Mikäli ''configure''-tiedostoa ei löydy. Aja [[autoreconf]]-[[Bash-skriptaus|skripti]] komennolla:
 
autoreconf -i
 
* autoreconf ajaa automaattisesti autoconf-, autoheader-, aclocal-, automake-, gettextize- ja libtoolize-ohjelmat oikeassa järjestyksessä ja luo configure-skriptin.
 
* Aja [[autoconf|<tt>configure</tt>]]-[[Bash-skriptaus|skripti]] komennolla:
 
./configure
 
tai
 
./configure --prefix=$HOME/ohjelmat/
 
Jos käyttää tällaista vipua käytetään niin käännetty ohjelma pitäisi löytyä hakemistosta $HOME/ohjelmat/bin.
 
Configure luo käännöksessä tarvittavan [[Makefile]]n. Jos <tt>configure</tt>-skriptiä ei ole, kokeile komentoja <tt>make config</tt> ja/tai <tt>make menuconfig</tt>. Jos mistään ei tapahdu mitään, katso olisiko hakemistossa <tt>install.sh</tt>-tyylistä skriptiä. Jos on, aja se komennolla:
./install.sh
 
Osassa ohjelmapaketteja saattaa myös olla Makefile valmiina, jolloin <tt>configure</tt>a ei ole, eikä sitä tarvitse ajaa.
* Jos <tt>configure</tt>-skripti ei mene kunnialla läpi, on syy usein puuttuvissa kehitys[[kirjasto]]issa eli headereissa (skripti mainitsee jonkin tietyn riippuvaisuuden puuttuvan). Nämä löytyvät paketinhallinnan kautta yleensä päätteellä ''-devel'' tai ''-dev'' (esimerkiksi ''[[gimp]]-devel'', pääte vaihtelee jakeluittain). Tilan säästämiseksi useimpien ohjelmien paketointien mukana ei toimiteta niiden kehityskirjastoja, vaan nämä on asennettava erillisestä paketista. Joskus ongelmana voi myös olla se, ettei <tt>configure</tt> löydä tarvittavaa riippuvaisuutta vaikka se ja sen kehityskirjastot olisi asennettu. Tällöin niiden sijainti on yleensä mahdollista määritellä erillisellä [[valitsin|valitsimella]]. Lisätietoja valitsimista saa komennolla:
./configure --help
 
Myös <tt>INSTALL</tt>- tai <tt>README</tt>-tiedostoissa on usein mainittu asiasta jotakin. [[Debian]]-pohjaisissa jakeluissa kehityskirjastot on yleensä helppo asentaa komennolla <tt>[[apt-get]] build-dep ohjelma</tt>.
* Käännä ohjelma komennolla:
make
 
Käännön aikana ruutuun tulostuu yleensä runsaasti tietoa käännön etenemisestä. Jos <tt>make</tt>-komento ei mene läpi, vaan pysähtyy ilmoittaen virheestä jollakin rivillä, on lähdekoodissa todennäköisesti vikaa. Yleensä kyse on lähdekoodin epäyhteensopivuudesta käytetyn kääntäjäversion kanssa. Virheilmoituksen perusteella saattaa olla mahdollista helpostikin korjata virhe. Muussa tapauksessa kannattaa lähettää palautetta ohjelman kehittäjälle.
 
* Siirry [[pääkäyttäjä]]ksi ja asenna ohjelma komennolla:
[[sudo]] make install
 
Tämä kopioi käännetyt binäärit lopulliseen asennushakemistoonsa. Mikäli et halua asentaa ohjelmaa pääkäyttäjänä, voit antaa tunnuksellesi kirjoitusoikeudet asennushakemistoon asennuksen ajaksi. Voit toki käyttää ohjelmaa myös lähdekoodihakemistosta käsin tai määrittää sopivan asennuspolun omasta kotihakemistostasi. Tämä tapahtuu <tt>configure</tt>n valitsimella <tt>--prefix</tt>, esimerkiksi <tt>--prefix=/home/kayttaja/hyvasofta</tt>.
 
Joskus Makefilessä on uninstall-toiminto, jolla ohjelma poisto onnistuu kätevästi komennolla:
make uninstall  
 
Huomaa kuitenkin, että mikäli esimerkiksi poistat näin jonkin [[kirjasto]]n, sitä käyttävät ohjelmat lakkaavat toimimasta. Jos jostain syystä haluat kääntää ohjelman uudelleen, voit poistaa luodut binäärit ja Makefilen lähdekoodihakemistosta komennolla:
make clean
 
==Kääntäminen ja paketinhallinta==
Kenties paras vaihtoehto on tehdä käännetystä ohjelmasta oman jakelun mukainen paketti ja asentaa se paketinhallinnan kautta. Tällöin komentoa <tt>make install</tt> ei anneta, vaan tilalle tulee jakelun omat paketinluomis- ja asennuskomennot. Katso esimerkiksi [[CheckInstall]] sekä [[Deb-paketin tekeminen]].
 
Jos käännettävä ohjelmisto tarjoaa jotakin toiminnallisuutta, josta paketinhallinnan olisi hyvä olla tietoinen, tämän voi kertoa paketinhallinnalle, vaikka itse ohjelmasta ei tekisikään oikeata ohjelmapakettia. Tähän käyttöön sopii "dummy"-paketti, joka sisältää vain riippuvuudet ja muun metadatan. Debianissa tällaisen paketin tekoon on olemassa apupaketti ''equivs''.


[[Luokka:Järjestelmä]]
[[Luokka:Järjestelmä]]
[[Luokka:Kehitystyökalut]]
[[Luokka:Kehitystyökalut]]
[[Luokka:Ohjeet]]

Nykyinen versio 15. huhtikuuta 2022 kello 17.30

Tämä artikkeli käsittelee koodin kääntämistä konekieleksi. Ohjelmatekstin suomeksi kääntämisestä kerrotaan artikkelissa kotoistus.


Kääntämisellä tarkoitetaan toimenpidettä, jossa ohjelman lähdekoodin perusteella luodaan konekielinen ohjelma, joka on tietokoneen ymmärtämässä muodossa. Konekielinen ohjelma toimii yleensä vain tietyn käyttöjärjestelmän ja prosessorityypin yhdistelmällä, kun taas samasta lähdekoodista voidaan yleensä (jos lähdekoodi on sopivasti kirjoitettu) kääntää versiot monille eri alustoille. Lisäksi lähdekoodia on mahdollista muokata, jos omaa kohtalaiset ohjelmointitaidot. Konekielisen ohjelman muokkaaminen taas ei ole käytännössä mahdollista kuin erittäin rajoitetusti.

Jos haluaa muokata oman jakelun pakettia, tämä kannattaa tehdä jakelun omilla työkaluilla ja mieluiten jakelun omasta lähdekoodista (ellei nimenomaan halua toista versiota ohjelmasta - silloinkin jakelun tekemät muutokset on hyvä huomioida). Oman jakelun lähdekoodipaketit on yleensä mahdollista asentaa paketinhallinnan kautta erillisestä asennuslähteestä (source). Jatkossa käsitellään muualta haetun lähdekoodin kääntämistä ja asentamista ilman jakelun omia työkaluja.

Perinteinen tapa[muokkaa]

Ohjelmat kannattaa yleisesti ottaen asentaa jotenkin muuten kuin muualta haettua koodia kääntämällä. Jos itse kääntäminen on välttämätöntä, käy se yleensä näin:

  • Tarkista että ainakin gcc ja make ovat asennettuina.
  • Hanki jostakin ohjelman lähdekoodit, joko kopioi ohjelman lähdekoodipaketti ja pura se
tar xvzf hyvasofta.tar.gz 

tai

tar xvjf hyvasofta.tar.bz2

tai käytä ohjelmistoprojektin versionhallintajärjestelmää.

  • Siirry paketin hakemistoon.
cd hyvasofta
  • Hakemistossa on yleensä tekstitiedostoja, joiden nimet ovat README, INSTALL tai vastaavaa. Lue nämä ja varmista, että kääntäminen todella tapahtuu niin kuin seuraavassa kerrotaan.
autoreconf -i
  • autoreconf ajaa automaattisesti autoconf-, autoheader-, aclocal-, automake-, gettextize- ja libtoolize-ohjelmat oikeassa järjestyksessä ja luo configure-skriptin.
./configure

tai

./configure --prefix=$HOME/ohjelmat/

Jos käyttää tällaista vipua käytetään niin käännetty ohjelma pitäisi löytyä hakemistosta $HOME/ohjelmat/bin.

Configure luo käännöksessä tarvittavan Makefilen. Jos configure-skriptiä ei ole, kokeile komentoja make config ja/tai make menuconfig. Jos mistään ei tapahdu mitään, katso olisiko hakemistossa install.sh-tyylistä skriptiä. Jos on, aja se komennolla:

./install.sh

Osassa ohjelmapaketteja saattaa myös olla Makefile valmiina, jolloin configurea ei ole, eikä sitä tarvitse ajaa.

  • Jos configure-skripti ei mene kunnialla läpi, on syy usein puuttuvissa kehityskirjastoissa eli headereissa (skripti mainitsee jonkin tietyn riippuvaisuuden puuttuvan). Nämä löytyvät paketinhallinnan kautta yleensä päätteellä -devel tai -dev (esimerkiksi gimp-devel, pääte vaihtelee jakeluittain). Tilan säästämiseksi useimpien ohjelmien paketointien mukana ei toimiteta niiden kehityskirjastoja, vaan nämä on asennettava erillisestä paketista. Joskus ongelmana voi myös olla se, ettei configure löydä tarvittavaa riippuvaisuutta vaikka se ja sen kehityskirjastot olisi asennettu. Tällöin niiden sijainti on yleensä mahdollista määritellä erillisellä valitsimella. Lisätietoja valitsimista saa komennolla:
./configure --help

Myös INSTALL- tai README-tiedostoissa on usein mainittu asiasta jotakin. Debian-pohjaisissa jakeluissa kehityskirjastot on yleensä helppo asentaa komennolla apt-get build-dep ohjelma.

  • Käännä ohjelma komennolla:
make

Käännön aikana ruutuun tulostuu yleensä runsaasti tietoa käännön etenemisestä. Jos make-komento ei mene läpi, vaan pysähtyy ilmoittaen virheestä jollakin rivillä, on lähdekoodissa todennäköisesti vikaa. Yleensä kyse on lähdekoodin epäyhteensopivuudesta käytetyn kääntäjäversion kanssa. Virheilmoituksen perusteella saattaa olla mahdollista helpostikin korjata virhe. Muussa tapauksessa kannattaa lähettää palautetta ohjelman kehittäjälle.

sudo make install

Tämä kopioi käännetyt binäärit lopulliseen asennushakemistoonsa. Mikäli et halua asentaa ohjelmaa pääkäyttäjänä, voit antaa tunnuksellesi kirjoitusoikeudet asennushakemistoon asennuksen ajaksi. Voit toki käyttää ohjelmaa myös lähdekoodihakemistosta käsin tai määrittää sopivan asennuspolun omasta kotihakemistostasi. Tämä tapahtuu configuren valitsimella --prefix, esimerkiksi --prefix=/home/kayttaja/hyvasofta.

Joskus Makefilessä on uninstall-toiminto, jolla ohjelma poisto onnistuu kätevästi komennolla:

make uninstall 

Huomaa kuitenkin, että mikäli esimerkiksi poistat näin jonkin kirjaston, sitä käyttävät ohjelmat lakkaavat toimimasta. Jos jostain syystä haluat kääntää ohjelman uudelleen, voit poistaa luodut binäärit ja Makefilen lähdekoodihakemistosta komennolla:

make clean

Kääntäminen ja paketinhallinta[muokkaa]

Kenties paras vaihtoehto on tehdä käännetystä ohjelmasta oman jakelun mukainen paketti ja asentaa se paketinhallinnan kautta. Tällöin komentoa make install ei anneta, vaan tilalle tulee jakelun omat paketinluomis- ja asennuskomennot. Katso esimerkiksi CheckInstall sekä Deb-paketin tekeminen.

Jos käännettävä ohjelmisto tarjoaa jotakin toiminnallisuutta, josta paketinhallinnan olisi hyvä olla tietoinen, tämän voi kertoa paketinhallinnalle, vaikka itse ohjelmasta ei tekisikään oikeata ohjelmapakettia. Tähän käyttöön sopii "dummy"-paketti, joka sisältää vain riippuvuudet ja muun metadatan. Debianissa tällaisen paketin tekoon on olemassa apupaketti equivs.