Ero sivun ”Meson” versioiden välillä
p Mesonin tiedostot ja koodi esimerkki |
p tupla popis |
||
| (5 välissä olevaa versiota samalta käyttäjältä ei näytetä) | |||
| Rivi 36: | Rivi 36: | ||
== Mesonin tiedostot == | == Mesonin tiedostot == | ||
Meson-projekti määritellään kahden pääasiallisen tiedoston kautta | Meson-projekti määritellään kahden pääasiallisen tiedoston kautta. | ||
'''1. meson.build''' | |||
Pääasiallinen rakennusmääritystiedosto, joka kuvaa, mitä tiedostoja projektissa on ja miten ne käännetään. | |||
C-koodi (main.c) | |||
<syntaxhighlight lang="C"> | <syntaxhighlight lang="C"> | ||
#include <stdio.h> | #include <stdio.h> | ||
| Rivi 51: | Rivi 54: | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
'''Mesonin määritys (meson.build)''' | |||
<syntaxhighlight lang="meson"> | <syntaxhighlight lang="meson"> | ||
| Rivi 57: | Rivi 62: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
'''2. meson_options.txt''' | |||
meson_options.txt-tiedosto määrittelee projektin käännösvaihtoehtoja, joita käyttäjä voi muuttaa konfigurointivaiheessa. | |||
<syntaxhighlight lang="text"> | <syntaxhighlight lang="text"> | ||
| Rivi 68: | Rivi 71: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
meson.build | '''Mesonin logiikka (meson.build)''' | ||
<syntaxhighlight lang="text"> | <syntaxhighlight lang="text"> | ||
| Rivi 95: | Rivi 97: | ||
Meson suosii aina ulkopuolista käännöstä (out-of-source build), mikä tarkoittaa, että käännöksessä syntyvät tiedostot (kuten objektit ja binäärit) luodaan erilliseen hakemistoon (tässä esimerkissä builddir) lähdekoodihakemiston ulkopuolelle. | Meson suosii aina ulkopuolista käännöstä (out-of-source build), mikä tarkoittaa, että käännöksessä syntyvät tiedostot (kuten objektit ja binäärit) luodaan erilliseen hakemistoon (tässä esimerkissä builddir) lähdekoodihakemiston ulkopuolelle. | ||
'''1. Konfigurointi | '''1. Konfigurointi''' Luo käännöshakemisto (Meson hoitaa tämän itse) ja luo tarvittavat rakennustiedostot. Tämä komento ajetaan lähdekoodihakemistossa: | ||
meson setup builddir | meson setup builddir | ||
'''2. Kääntäminen | Jos haluat asentaa ohjelman paikallisesti ilman pääkäyttäjän oikeuksia (esim. hakemistoon ''~/.local''), konfiguroi Meson alussa ''--prefix''-valitsimella: ''meson setup builddir --prefix=~/.local'' | ||
'''2. Kääntäminen''' Käännä ohjelma Mesonin luomassa hakemistossa (''-C builddir''): | |||
meson compile -C builddir | meson compile -C builddir | ||
'''3. Asennus | {{Huomautus|Huomaa: Monissa nykyaikaisissa Meson-projekteissa meson compile voidaan korvata lyhyemmällä ''ninja -C builddir'' -komennolla, koska [[Ninja]] on Mesonin oletusarvoinen taustajärjestelmä.}} | ||
'''3. Asennus''' Asenna ohjelma järjestelmään (vaatii pääkäyttäjän oikeudet): | |||
sudo meson install -C builddir | sudo meson install -C builddir | ||
Käytä sudoa vain, jos asennat järjestelmänlaajuisiin hakemistoihin. Käyttäjäkohtaisessa asennuksessa (käyttäen ''--prefixiä'') [[sudo]]a ei tarvita. | |||
==Katso myös== | ==Katso myös== | ||
Nykyinen versio 15. marraskuuta 2025 kello 00.05
| Meson | |
|---|---|
| Kehittäjä(t) | Jussi Pakkanen (perustaja), Meson-yhteisö |
| Moottori | Ninja |
| Ensijulkaisu | 2012 |
| Ohjelmoitu | Python |
| Käyttöliittymä | Komentorivi (CLI) |
| Tyyppi | Rakennusjärjestelmä (Build System) |
| Lisenssi | Apache-lisenssi 2.0 |
| Kotisivu | mesonbuild.com |
| Lähdekoodi | github.com/mesonbuild/meson |
Meson on moderni, nopea ja usealla alustalla toimiva käännösjärjestelmä (build system). Se on suunniteltu olemaan käyttäjäystävällinen ja toimii automaattisesti yhdessä nopean Ninja-rakennusjärjestelmän kanssa käännösprosessin suorittamiseksi. Meson on yleistynyt erityisesti vapaan lähdekoodin projekteissa ja on käytössä muun muassa GNOME-projektissa.
Tavoitteet ja periaatteet
[muokkaa]Mesonin perusfilosofiaan kuuluu kolme keskeistä periaatetta:
- 1. Nopeus: Meson käyttää Ninja-käännöstyökalua (Build system) taustalla, minkä ansiosta se on erittäin nopea suurtenkin projektien uudelleenkäännöksissä.
- 2. Käytettävyys: Rakennusmääritykset tehdään yksinkertaisella, erillisellä Meson-kielellä, joka on luettavampi ja ymmärrettävämpi kuin monien muiden järjestelmien käyttämät skriptit.
- 3. Yhteensopivuus: Se tukee natiivisti useita kieliä (esim. C, C++, Rust, Java) ja alustoja (Linux, macOS, Windows, jne.), helpottaen ristiinkäännöstä.
Asennus
[muokkaa]Meson löytyy useimpien jakeluiden paketinhallinnasta nimellä meson. Lisätietoja ohjelmien asentamisesta löytyy artikkelista Ohjelmien asentaminen.
Mesonin lisäksi usein tarvitaan sen taustajärjestelmä Ninja. Ninja löytyy useimpien jakeluiden paketinhallinnasta nimellä ninja-build. Lisätietoja ohjelmien asentamisesta löytyy artikkelista Ohjelmien asentaminen.
Mesonin tiedostot
[muokkaa]Meson-projekti määritellään kahden pääasiallisen tiedoston kautta.
1. meson.build
Pääasiallinen rakennusmääritystiedosto, joka kuvaa, mitä tiedostoja projektissa on ja miten ne käännetään.
C-koodi (main.c)
#include <stdio.h>
#ifdef DEBUG
printf("Debug mode is enabled!\n");
#endif
int main(void) {
printf("Hei, Maailma!\n");
return 0;
}
Mesonin määritys (meson.build)
meson project('Hei', 'c') # Määrittelee projektin nimen (Hei) ja käytettävän kielen (c).
executable('hei', 'main.c') # Luo ajettavan ohjelman nimeltä hei, joka käännetään tiedostosta main.c.
2. meson_options.txt
meson_options.txt-tiedosto määrittelee projektin käännösvaihtoehtoja, joita käyttäjä voi muuttaa konfigurointivaiheessa.
option('debug_mode', type: 'boolean', value: false, description: 'Enable debug output')
option('optimization_level', type: 'combo', choices: ['0', '1', '2', '3'], value: '2', description: 'Set compiler optimization level')
Mesonin logiikka (meson.build)
project('Hei', 'c')
# Haetaan käyttäjän valinnat
debug_mode = get_option('debug_mode')
opt_level = get_option('optimization_level')
executable('hei', 'main.c',
c_args: ['-O' + opt_level] + (debug_mode ? ['-DDEBUG'] : [])
)
Kun konfiguroit projektin, voit antaa valinnat komentorivillä:
meson setup builddir -Ddebug_mode=true -Doptimization_level=3
Tämä kääntää ohjelman -O3 optimoinnilla ja lisää -DDEBUG-määrittelyn, jolloin koodissa voi käyttää esimerkiksi:
#ifdef DEBUG
printf("Debug mode is enabled!\n");
#endif
Käyttö
[muokkaa]Meson suosii aina ulkopuolista käännöstä (out-of-source build), mikä tarkoittaa, että käännöksessä syntyvät tiedostot (kuten objektit ja binäärit) luodaan erilliseen hakemistoon (tässä esimerkissä builddir) lähdekoodihakemiston ulkopuolelle.
1. Konfigurointi Luo käännöshakemisto (Meson hoitaa tämän itse) ja luo tarvittavat rakennustiedostot. Tämä komento ajetaan lähdekoodihakemistossa:
meson setup builddir
Jos haluat asentaa ohjelman paikallisesti ilman pääkäyttäjän oikeuksia (esim. hakemistoon ~/.local), konfiguroi Meson alussa --prefix-valitsimella: meson setup builddir --prefix=~/.local
2. Kääntäminen Käännä ohjelma Mesonin luomassa hakemistossa (-C builddir):
meson compile -C builddir
3. Asennus Asenna ohjelma järjestelmään (vaatii pääkäyttäjän oikeudet):
sudo meson install -C builddir
Käytä sudoa vain, jos asennat järjestelmänlaajuisiin hakemistoihin. Käyttäjäkohtaisessa asennuksessa (käyttäen --prefixiä) sudoa ei tarvita.