VirtualBuildEnv

VirtualBuildEnv 是一个生成器,它生成一个 conanbuildenv .bat、.ps1 或 .sh 脚本,其中包含构建时上下文的环境变量

  • 来自“build”上下文中的直接 tool_requiresself.buildenv_info

  • 来自那些 tool_requires 的传递依赖项的 self.runenv_info

它可以在 conanfile 中通过名称使用

conanfile.py
class Pkg(ConanFile):
    generators = "VirtualBuildEnv"
conanfile.txt
[generators]
VirtualBuildEnv

并且它也可以在 conanfile 的 generate() 方法中完全实例化

conanfile.py
from conan import ConanFile
from conan.tools.env import VirtualBuildEnv

class Pkg(ConanFile):
    settings = "os", "compiler", "arch", "build_type"
    requires = "zlib/1.2.11", "bzip2/1.0.8"

    def generate(self):
        ms = VirtualBuildEnv(self)
        ms.generate()

请注意,实例化 VirtualBuildEnv() 生成器而不稍后调用 generate() 方法(该方法仅用于 generate() 构建配方方法)将阻止环境变量文件的创建。

因此,类似于

ms = VirtualBuildEnv(self)
my_env_var = ms.vars().get("MY_ENV_VAR")
# does not create conanbuildenv.sh|.bat files

将停止创建默认情况下创建的 conanbuild.sh|.batconanbuildenv.sh|.bat 文件,即使 VirtualBuildEnv 未被实例化。

为了继续创建这些文件,可以将 auto_generate=True 参数传递给构造函数,例如

ms = VirtualBuildEnv(self, auto_generate=True)
my_env_var = ms.vars().get("MY_ENV_VAR")
# does create conanbuildenv.sh|.bat files

生成的文件

此生成器(例如调用 conan install --tool-require=cmake/3.20.0@ -g VirtualBuildEnv)将创建以下文件

  • conanbuildenv-release-x86_64.(bat|ps1|sh):该文件包含环境变量(如 PATH、LD_LIBRARY_PATH 等)的实际定义,以及依赖项 buildenv_info 中定义的与 build 上下文对应的任何其他变量,以及当前安装的配置。如果使用其他设置重复调用,将创建不同的文件。在执行或 sourcing 此文件后,将生成一个新的停用脚本,捕获当前环境,以便在需要时可以恢复环境。该文件也将根据当前活动配置命名,例如 deactivate_conanbuildenv-release-x86_64.bat

  • conanbuild.(bat|ps1|sh):累积对一个或多个其他脚本的调用,以防生成过程中有多个工具创建文件,从而提供一个方便的单一文件用于所有情况。这只调用最新的特定配置脚本,也就是说,如果 conan install 首先为 Release 构建类型调用,然后为 Debug 调用,conanbuild.(bat|ps1|sh) 脚本将调用 Debug 脚本。

  • deactivate_conanbuild.(bat|ps1|sh):累积上述 conanbuild.(bat|ps1|sh) 中定义的停用调用。该文件只能在累积的激活脚本首先被调用后才能被调用。

注意

要为 PowerShell 创建所需的 .ps1 文件,您需要将 tools.env.virtualenv:powershell 配置设置为 PowerShell 可执行文件的值(例如,powershell.exepwsh)。请注意,自 Conan 2.11.0 起,将其设置为 TrueFalse 已弃用,不应再使用。

注意

可以通过将 --envs-generation=false 传递给 conan install 命令,从而禁用为消费者自动生成这些文件。此功能是实验性的,可能会发生变化,如果例如使用了 tool_requires,禁用此文件可能会导致意外的构建错误。如果禁用生成,请确保不需要它们。

参考

class VirtualBuildEnv(conanfile, auto_generate=False)

计算构建时上下文的环境变量并生成一个 conanbuildenv .bat 或 .sh 脚本。

environment()

返回一个包含构建上下文环境变量的 Environment 对象。

返回

一个包含获取变量的 Environment 对象实例。

vars(scope='build')
参数

scope – 要使用的范围。

返回

一个包含计算出的环境变量的 EnvVars 实例。

generate(scope='build')

生成用于激活构建上下文变量的启动器脚本。

参数

scope – 要使用的范围。