conanfile.txt¶
文件 conanfile.txt
是 conanfile.py
的简化版本,旨在简化依赖项的消费,但它不能用于创建包。此外,消费依赖项并不一定需要 conanfile.txt
,conanfile.py
完全适用于简单的依赖项消费。
它还提供了简化的功能,例如无法在 conanfile.txt
中表达条件要求,为此需要使用 conanfile.py
。阅读 理解使用 conanfile.py 与 conanfile.txt 的灵活性 以获取更多信息。
[requires]¶
要求列表,指定完整的引用。等同于 conanfile.py
中的 self.requires(<ref>)
。
[requires]
poco/1.9.4
zlib/1.3.1
本节也支持带版本范围的引用
[requires]
poco/[>1.0 <1.9]
zlib/1.3.1
并且也可以固定特定配方修订版
[requires]
zlib/1.2.13#revision1
boost/1.70.0#revision2
[tool_requires]¶
工具要求(可执行工具)列表,指定完整的引用。等同于 conanfile.py
中的 self.tool_requires()
。
[tool_requires]
7zip/16.00
cmake/3.23.0
本节也支持版本范围和固定的配方修订版,如上所述。
实际上,[tool_requires]
总是会被安装(与 [requires]
相同),因为从 conanfile.txt 安装意味着将要构建某些东西,因此确实需要工具要求。然而请注意,默认情况下 tool_requires
存在于“构建”上下文中,它们不能作为构建库,只能是可执行工具,例如,使用 CMakeDeps
生成器,它们不会为其创建 CMake 配置文件(可能存在例外,但这需要使用 conanfile.py
,请阅读 CMakeDeps 参考 以获取更多信息)。
[test_requires]¶
测试要求列表,指定完整的引用。等同于 conanfile.py
中的 self.test_requires()
。
[test_requires]
gtest/1.12.1
本节也支持版本范围和固定的配方修订版,如上所述。test_requires
的行为与上面的 [requires]
部分完全等同,因为唯一的区别是 test_requires
不会传播给消费者,但由于 conanfile.txt
从不创建可供消费的包,因此这无关紧要。提供它是为了保持与 conanfile.py
的等效性。
[generators]¶
要使用的内置生成器列表,等同于 conanfile.py
的 generators = "CMakeDeps", ...
属性。
[requires]
poco/1.9.4
zlib/1.2.13
[generators]
CMakeDeps
CMakeToolchain
[options]¶
以 package_name*:option = Value 模式为每个包指定选项列表。
[requires]
poco/1.9.4
zlib/1.3.1
[generators]
CMakeDeps
CMakeToolchain
[options]
poco/*:shared=True
openssl/*:shared=True
例如,使用 *:shared=True
将为依赖图谱中所有定义了此选项的包定义 shared=True
。
[layout]¶
您可以指定一个预定义布局的名称。可用值包括:
cmake_layout
vs_layout
bazel_layout (实验性)
[layout]
cmake_layout
另请参阅
阅读 理解使用 conanfile.py 与 conanfile.txt 的灵活性 以获取有关 conanfile.txt 与 conanfile.py 的更多信息。