使用 Conan 构建一个简单的 Meson 项目

在这个例子中,我们将创建一个使用最流行的 C++ 库之一:Zlib 的字符串压缩应用程序。

注意

本示例基于主要的使用 Conan 构建一个简单的 CMake 项目教程。因此,强烈建议在尝试本示例之前先阅读该教程。

在本例中,我们将使用 Meson 作为构建系统,并使用 pkg-config 作为辅助工具,因此在继续本示例之前应该先安装它们。

请先克隆源代码以重新创建此项目。您可以在 GitHub 的 examples2 仓库中找到它们

$ git clone https://github.com/conan-io/examples2.git
$ cd examples2/examples/tools/meson/mesontoolchain/simple_meson_project

我们从一个非常简单的 C 语言项目开始,其结构如下

.
├── meson.build
└── src
    └── main.c

该项目包含一个基本的 meson.build 文件,其中包括对 zlib 的依赖,以及字符串压缩程序在 main.c 中的源代码。

让我们看看 main.c 文件

main.c
#include <stdlib.h>
#include <stdio.h>
#include <string.h>

#include <zlib.h>

int main(void) {
    char buffer_in [256] = {"Conan is a MIT-licensed, Open Source package manager for C and C++ development "
                            "for C and C++ development, allowing development teams to easily and efficiently "
                            "manage their packages and dependencies across platforms and build systems."};
    char buffer_out [256] = {0};

    z_stream defstream;
    defstream.zalloc = Z_NULL;
    defstream.zfree = Z_NULL;
    defstream.opaque = Z_NULL;
    defstream.avail_in = (uInt) strlen(buffer_in);
    defstream.next_in = (Bytef *) buffer_in;
    defstream.avail_out = (uInt) sizeof(buffer_out);
    defstream.next_out = (Bytef *) buffer_out;

    deflateInit(&defstream, Z_BEST_COMPRESSION);
    deflate(&defstream, Z_FINISH);
    deflateEnd(&defstream);

    printf("Uncompressed size is: %lu\n", strlen(buffer_in));
    printf("Compressed size is: %lu\n", strlen(buffer_out));

    printf("ZLIB VERSION: %s\n", zlibVersion());

    return EXIT_SUCCESS;
}

此外,meson.build 的内容如下

meson.build
project('tutorial', 'c')
zlib = dependency('zlib', version : '1.2.11')
executable('compressor', 'src/main.c', dependencies: zlib)

让我们创建一个内容如下的 conanfile.txt 文件来安装 Zlib

conanfile.txt
[requires]
zlib/1.2.11

[generators]
PkgConfigDeps
MesonToolchain

在本例中,我们将使用 PkgConfigDeps 来生成关于 Zlib 库文件安装位置的信息(通过 *.pc 文件),并使用 MesonToolchain 通过一个 conan_meson_[native|cross].ini 文件将构建信息传递给 Meson,该文件描述了 native/cross 编译环境,本例中是 conan_meson_native.ini 文件。

我们将使用 Conan 安装 Zlib 并生成 Meson 需要的文件,以便找到该库并构建我们的项目。我们将在 build 文件夹中生成这些文件。为此,运行

$ conan install . --output-folder=build --build=missing

现在我们可以构建并运行我们的 compressor 应用了

Windows
$ cd build
$ meson setup --native-file conan_meson_native.ini .. meson-src
$ meson compile -C meson-src
$ meson-src\compressor.exe
Uncompressed size is: 233
Compressed size is: 147
ZLIB VERSION: 1.2.11
Linux, macOS
$ cd build
$ meson setup --native-file conan_meson_native.ini .. meson-src
$ meson compile -C meson-src
$ ./meson-src/compressor
Uncompressed size is: 233
Compressed size is: 147
ZLIB VERSION: 1.2.11