meson 概述

meson是一个构建系统，类似于 CMake 或者GNU Autotools. meson只是负责配置构建，后台默认是用ninja来编译的(当然也支持其它后台)。ninja是一个小型的致力于编译速度优化的编译系统，相当于make的替代物。所以meson+ninja相当于Cmake+make。

meson设计目标是好用，同时保持高性能。它采用了一种自定义语言，号称简单、清晰和简洁性。很多灵感来自于Python编程语言，具有较好的易读性。

meson的另一个设计目标，是为现代编程工具提供辅助的支持，包括单元测试、代码覆盖报告、预编译头文件等。所有这些特性用于任何meson的项目,用户不需要另外使用第三方宏或编写shell脚本。

Meson遵循其他流行编译系统（如CMake和GNU Autotools）的整体结构，编译被分为两个独立的步骤: 配置步骤和编译步骤。
第一步检查系统，检查依赖关系，并执行配置编译所需的所有其他步骤。然后生成实际的编译系统。
第二步是简单地执行这个生成的编译系统。最终的结果是一堆编译目标，通常是可执行文件、共享库和静态的库。

包含源代码的目录称为源目录。相应地，编译输出的目录称为编译目录。
在其他编译系统中，这两个目录通常是相同的，编译系统创建的所有文件都放在编译目录中。这被称为源内编译。
Meson编译目录和代码目录是分离的，称为源外编译。
源外编译有几个好处：生成的文件不会影响源代码，更重要的是可以创建多个编译目录，生成多个编译版本，比如调试版、发布版或者我们想要的任何其它差异。这时候源码目录都是不需要改动的，我们只需要在不同编译目录去编译对应的版本即可。
在编译源代码时，通常会运行一组单元测试，他们确保程序正常运行。测试通过就安装编译结果，然后就可以使用了。

1.运行Meson

有两种不同的方式来调用Meson。

• 使用命令/path/到/source/meson.py从源树中直接运行。
• 安装Meson，使用meson命令来运行。
  为简单起见，本手册仅使用后一种格式。

1.1示例代码

你可以通过以下命令取得一个工程示例。该示例会生成一个testproject.c、meson.build：

$ meson init --name testproject
Using "testproject" (project name) as name of executable to build.
Defaulting to generating a C language project.
Sample project created. To build it run the
following commands:

meson setup builddir
meson compile -C builddir
$ ll
total 16
drwxr-xr-x 2 e0005055 ibu 4096 10月 14 09:56 ./
drwxr-xr-x 3 e0005055 ibu 4096 10月 14 09:37 ../
-rw-r--r-- 1 e0005055 ibu  176 10月 14 09:56 meson.build
-rw-r--r-- 1 e0005055 ibu  254 10月 14 09:56 testproject.c

配置编译目录

假设我们已经有了上述的源代码，意思是顶层目录有一个meson.build文件。运行下面的命令来配置编译选项：

meson setup builddir ./

meson基础语法是：meson [command] [arguments] [options].
setup 命令接受编译目录和源码目录 setup builddir srcdir .
如果没有指定源码目录，那么meson会把当前目录和meson.build所在的目录作为源码目录。此外setup是meson默认命令，可以省略。因此我们可以直接运行：

meson builddir 

这将在builddir生成编译目录和配置文件。

$ ./builddir/
meson-info/    meson-logs/    meson-private/ testproject.p/ 

编译工程

meson compile -C [编译目录]

$ meson compile -C builddir
ninja: Entering directory `builddir'
[2/2] Linking target testproject

builddir下会生成可执行文件testproject，我们可以查看并运行程序testproject：

$ ./builddir/
meson-info/    meson-logs/    meson-private/ testproject    testproject.p/ 
$ ./builddir/testproject
This is project testproject.

你也可以用ninja直接编译：

ninja -C builddir

运行测试

meson test -C builddir

同样可以用ninja直接调用：

ninja -C builddir test

安装程序

meson install -C builddir

文件默认安装到/usr/local，可以用–prefix /your/prefix或者DESTDIR 环境变量自定义路径：

DESTDIR=/path/to/staging meson install -C builddir

同样可以用ninja直接调用：

ninja -C builddir install

1.2编译类型

默认情况下，meson使用调试编译类型，该模式下会打开debug和警告，并不会进行优化。–buildtype命令可以更改编译类型：

• plain 用户指定编译选项，一般用于发行包
• debug 默认模式，生成调试和警告并不做任何优化
• debugoptimized 生成调试和警告，但优化编译 (-g -O2)
• release 全体优化编译，没有调试信息

1.3声明共享库，给其他模组使用

可以用declare_dependency，将当前编译的库文件提供给其他模组使用。
通过include_directories来添加头文件路径，这样就可以直接在此目录中查找头文件。

注意此时source必须填写，否则会提示找不到对应的引用。
之后，其他模组只需要在依赖中添加es_cjson_dep就可以了。

1.4添加第三方共享库依赖

通过include_directories来声明头文件路径，
通过find_library查找库，并添加到dependencies 之中。

cc = meson.get_compiler('c')
cxx = meson.get_compiler('cpp')

libm = cc.find_library('m', required : false)
configinc = include_directories('../3rd/include')

gstavtp = library('gstavtp',
  avtp_sources,
  c_args : gst_plugins_bad_args,
  include_directories : [configinc],
  dependencies : [gstaudio_dep, gstvideo_dep, avtp_dep, libm],
  install : true,
  install_dir : plugins_install_dir,
)

当第三方库不在默认路径时，可以通过dirs添加绝对路径来指定（老版本不支持，请升级）：

注意，include_directories指定头文件时，可以使用相对路径，但find_library指定库文件必须使用绝对路径（不排除后续支持相对路径的可能）。

1.5指定其它编译后台

meson后台默认是用ninja来编译。如果要使用其它后台来编译，在配置的时候加上–backend命令。例如，后台想用vs编译：

meson builddir  --backend=vs

1.6生成代码发布包

meson dist