Ero sivun ”Meson” versioiden välillä

Linux.fista
Siirry navigaatioon Siirry hakuun
päivitys
p Mesonin tiedostot ja koodi esimerkki
Rivi 38: Rivi 38:
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.
* '''1. meson.build:''' Pääasiallinen rakennusmääritystiedosto, joka kuvaa, mitä tiedostoja projektissa on ja miten ne käännetään.
Koodiesimerkki Hei maailma! ''main.c''
<syntaxhighlight lang="C">
#include <stdio.h>
#ifdef DEBUG
    printf("Debug mode is enabled!\n");
#endif
int main(void) {
    printf("Hei, Maailma!\n");
    return 0;
}
</syntaxhighlight>
<syntaxhighlight lang="meson">
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.
</syntaxhighlight>
* ''' 2. meson_options.txt:''' Määrittelee projektiin liittyvät käännösvaihtoehdot, joita käyttäjä voi muuttaa.
* ''' 2. meson_options.txt:''' Määrittelee projektiin liittyvät käännösvaihtoehdot, joita käyttäjä voi muuttaa.
Tässä on Hei maailma! esimerkki, miten ''meson_options.txt''-tiedostoa voi käyttää yhdessä ''meson.build''-tiedoston kanssa:
''meson_options.txt'' tiedosto määrittelee projektin käännösvaihtoehtoja, joita käyttäjä voi muuttaa konfigurointivaiheessa.
<syntaxhighlight lang="text">
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')
</syntaxhighlight>
meson.build
Voit käyttää näitä valintoja projektissa näin:
<syntaxhighlight lang="text">
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'] : [])
)
</syntaxhighlight>
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:
<syntaxhighlight lang="c">
#ifdef DEBUG
    printf("Debug mode is enabled!\n");
#endif
</syntaxhighlight>


== Käyttö ==
== Käyttö ==

Versio 14. marraskuuta 2025 kello 23.39

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

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

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

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.

Koodiesimerkki Hei maailma! main.c

#include <stdio.h>
#ifdef DEBUG
    printf("Debug mode is enabled!\n");
#endif

int main(void) {
    printf("Hei, Maailma!\n");
    return 0;
}
 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: Määrittelee projektiin liittyvät käännösvaihtoehdot, joita käyttäjä voi muuttaa.

Tässä on Hei maailma! esimerkki, miten meson_options.txt-tiedostoa voi käyttää yhdessä meson.build-tiedoston kanssa:

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')

meson.build Voit käyttää näitä valintoja projektissa näin:

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ö

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

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
Huomautus: Huomaa: Monissa nykyaikaisissa Meson-projekteissa meson compile voidaan korvata lyhyemmällä ninja -C builddir -komennolla, koska Ninja on Mesonin oletusarvoinen taustajärjestelmä.


Katso myös