使用 Meson 创建你的第一个 Conan 包¶
在创建你的第一个 Conan 包教程中,CMake 被用作构建系统。如果你还没有阅读该部分,请先阅读它以熟悉 conanfile.py
和 test_package
的概念,然后再回来阅读 Meson
包创建的细节。
使用 conan new 命令创建一个“Hello World” C++ 库示例项目
$ conan new meson_lib -d name=hello -d version=1.0
这将创建一个具有以下结构的 Conan 包项目。
├── conanfile.py
├── meson.build
├── hello.vcxproj
├── src
│ ├── hello.h
│ └── hello.cpp
└── test_package
├── conanfile.py
├── meson.build
└── src
└── example.cpp
其结构和文件与之前的 CMake 示例非常相似
conanfile.py:在根文件夹中,有一个 conanfile.py,它是主要的 recipe 文件,负责定义包如何构建和消费。
meson.build:一个 Meson 构建脚本。此脚本无需包含任何 Conan 特定的内容,它完全独立于 Conan,因为集成是透明的。
src 文件夹:包含简单 C++ “hello” 库的文件夹。
test_package 文件夹:包含一个将需要并链接到所创建包的示例应用程序。在这种情况下,
test_package
也包含一个meson.build
,但如果需要,test_package
也可以使用像 CMake 这样的其他构建系统。test_package 不强制要求使用与包相同的构建系统。
让我们看看包 recipe 文件 conanfile.py(仅相关新部分)
exports_sources = "meson.build", "src/*"
def layout(self):
basic_layout(self)
def generate(self):
tc = MesonToolchain(self)
tc.generate()
def build(self):
meson = Meson(self)
meson.configure()
meson.build()
def package(self):
meson = Meson(self)
meson.install()
让我们简要解释 recipe 的不同部分
layout()
定义了一个basic_layout()
,这比 CMake 的灵活性更低,因此它不支持任何参数化。generate()
方法调用MesonToolchain
,它可以为交叉编译生成conan_meson_native.ini
和conan_meson_cross.ini
Meson 工具链文件。如果项目有依赖于 Conanrequires
的依赖项,它也应该添加PkgConfigDeps
build()
方法使用Meson()
助手来驱动构建package()
方法使用Meson
的安装功能来定义最终的工件并将其复制到包文件夹中。
test_package 文件夹也包含一个 meson.build
文件,该文件声明了对被测包的依赖,并链接了一个应用程序,以验证包是否正确创建并包含该库
project('Testhello', 'cpp')
hello = dependency('hello', version : '>=0.1')
executable('example', 'src/example.cpp', dependencies: hello)
请注意,test_package/conanfile.py
也包含 generators = "PkgConfigDeps", "MesonToolchain"
,因为 test_package
依赖于 “hello” 包,而 PkgConfigDeps
对于定位它来说是必需的。
注意
本示例假设 Meson、Ninja 和 PkgConfig 已安装在系统中,但并非总是如此。如果它们未安装,你可以使用以下方式创建一个 profile myprofile
:
include(default)
[tool_requires]
meson/[*]
pkgconf/[*]
我们已将 Meson 和 pkg-config 作为工具需求添加到 profile 中。通过执行 conan create . -pr=myprofile
,这些工具将在包的构建过程中被安装并可用。
让我们使用当前的默认配置从源代码构建包,然后让 test_package
文件夹测试该包
$ conan create .
...
======== Testing the package: Executing test ========
hello/1.0 (test package): Running test()
hello/1.0 (test package): RUN: .\example
hello/1.0: Hello World Release!
hello/1.0: _M_X64 defined
hello/1.0: MSVC runtime: MultiThreadedDLL
hello/1.0: _MSC_VER1939
hello/1.0: _MSVC_LANG201402
hello/1.0: __cplusplus201402
hello/1.0 test_package
我们现在可以验证 recipe 和包二进制文件是否在缓存中
$ conan list "hello/1.0:*"
Local Cache:
hello
hello/1.0
revisions
856c535669f78da11502a119b7d8a6c9 (2024-03-04 17:52:39 UTC)
packages
c13a22a41ecd72caf9e556f68b406569547e0861
info
settings
arch: x86_64
build_type: Release
compiler: msvc
compiler.cppstd: 14
compiler.runtime: dynamic
compiler.runtime_type: Release
compiler.version: 193
os: Windows
另请参阅