Autotools¶
Autotools 构建助手是 autotools 命令行调用的封装器。它会将类似 ./configure 或 make 的调用抽象为 Python 方法调用。
用法
from conan import ConanFile
from conan.tools.gnu import Autotools
class App(ConanFile):
settings = "os", "arch", "compiler", "build_type"
def build(self):
autotools = Autotools(self)
autotools.configure()
autotools.make()
它将读取 AutotoolsToolchain 生成的 conanbuild.conf 文件，以了解调用 configure 和 make 脚本的参数
configure_args：调用
configure脚本的参数。make_args：调用
make脚本的参数。
参考¶
- class Autotools(conanfile, namespace=None)¶
- 参数:
conanfile – 当前的配方对象。始终使用
self。namespace – 此参数可避免在同一个配方中进行多次工具链调用时发生冲突。通过设置此参数，用于将信息传递给工具链的 *conanbuild.conf* 文件将被命名为：*<namespace>_conanbuild.conf*。默认值为
None，这意味着生成文件的名称为 *conanbuild.conf*。此命名空间还必须在 AutotoolsToolchain 的构造函数中以相同的值设置，以便它从正确的文件读取信息。
- configure(build_script_folder=None, args=None)¶
调用 configure 脚本。
- 参数:
args – 用于
configure调用参数列表。build_script_folder – 包含 configure 脚本的子文件夹。如果未指定，则使用 conanfile.source_folder。
- make(target=None, args=None, makefile=None)¶
调用 make 程序。
- 参数:
target – (可选，默认为
None)：选择要构建的目标。这允许构建例如文档、共享库或某些 Autotools 项目的安装。args – (可选，默认为
None)：用于make调用的参数列表。makefile – (可选，默认为
None)：允许指定要使用的自定义 Makefile，而不是默认的“Makefile”。
- install(args=None, target=None, makefile=None)¶
这只是
self.make(target="install")或self.make(target="install-strip")的“别名”。- 参数:
args – (可选，默认为
None)：用于make调用的参数列表。默认情况下，如果传递的值为None，则会将参数DESTDIR=unix_path(self.package_folder)添加到调用中。有关 tools.microsoft.unix_path() 函数 的更多信息。target – (可选，默认为
None)：选择要安装的目标。makefile – (可选，默认为
None)：允许指定要使用的自定义 Makefile，而不是默认的“Makefile”。
- autoreconf(build_script_folder=None, args=None)¶
调用
autoreconf- 参数:
args – (可选，默认为
None)：用于autoreconf调用的参数列表。build_script_folder – 包含 configure 脚本的子文件夹。如果未指定，则使用 conanfile.source_folder。
conf¶
Autotools 构建助手受这些 [conf] 变量影响
tools.gnu:make_program允许定义正在使用的make可执行文件。对于 MinGW 构建，这将默认为mingw32-make，对于任何其他构建，则默认为make。tools.build:install_strip（自 Conan 2.20.0 起）将在 Autotools.install() 方法中定义make install-strip目标（如果设置为True），否则将使用make install目标。