取决于相同版本的工具需求,但具有不同的选项¶
注意
这是一个高级用例。在绝大多数情况下,它应该不是必需的。
在一般情况下,尝试做这样的事情
def build_requirements(self):
self.tool_requires("gcc/1.0")
self.tool_requires("gcc/1.0")
将生成“冲突”,显示类似 Duplicated requirement
的错误。
然而,在某些特殊情况下,我们可能需要依赖相同版本的 tool_requires
,但使用该 tool_requires
的不同二进制文件。这可以通过将不同的 options
传递给这些 tool_requires
来实现。请先克隆源代码以重新创建此项目。您可以在 GitHub 上的 examples2 仓库中找到它们
git clone https://github.com/conan-io/examples2.git
cd examples2/examples/graph/tool_requires/different_options
在那里我们有一个带有 gcc
伪造配方,其中包含
class Pkg(ConanFile):
name = "gcc"
version = "1.0"
options = {"myoption": [1, 2]}
def package(self):
# This fake compiler will print something different based on the option
echo = f"@echo off\necho MYGCC={self.options.myoption}!!"
save(self, os.path.join(self.package_folder, "bin", f"mygcc{self.options.myoption}.bat"), echo)
save(self, os.path.join(self.package_folder, "bin", f"mygcc{self.options.myoption}.sh"), echo)
os.chmod(os.path.join(self.package_folder, "bin", f"mygcc{self.options.myoption}.sh"), 0o777)
这不是一个真正的编译器,它使用 shell 或 bat 脚本来伪造它,该脚本在执行时打印 MYGCC=current-option
。 请注意,二进制文件本身被称为 mygcc1
和 mygcc2
,也就是说,它在可执行文件名本身中包含选项。
我们可以为 gcc/1.0
创建 2 个不同的二进制文件,使用
$ conan create gcc -o myoption=1
$ conan create gcc -o myoption=2
现在,在 wine
文件夹中有一个像这样的 conanfile.py
class Pkg(ConanFile):
name = "wine"
version = "1.0"
def build_requirements(self):
self.tool_requires("gcc/1.0", run=False, options={"myoption": 1})
self.tool_requires("gcc/1.0", run=False, options={"myoption": 2})
def generate(self):
gcc1 = self.dependencies.build.get("gcc", options={"myoption": 1})
assert gcc1.options.myoption == "1"
gcc2 = self.dependencies.build.get("gcc", options={"myoption": 2})
assert gcc2.options.myoption == "2"
def build(self):
ext = "bat" if platform.system() == "Windows" else "sh"
self.run(f"mygcc1.{ext}")
self.run(f"mygcc2.{ext}")
第一个重点是 build_requirements()
方法,它对两个二进制文件都执行 tool_requires()
,但定义了 run=False
和 options={"myoption": value}
特征。这非常重要:我们告诉 Conan 我们实际上不需要从这些包中运行任何东西。由于 tool_requires
是不可见的,它们不定义头文件或库,并且它们定义了不同的 options
,因此没有任何东西可以使 Conan 将这两个 tool_requires
识别为冲突。因此,可以构造依赖关系图而不会出错,并且 wine/1.0
包将包含两个不同的工具需求,分别对应 gcc/1.0
,其中 myoption=1
和 myoption=2
。
当然,我们不会从这些 tool_requires
中运行任何东西,这并非事实,但现在 Conan 并不知道这一点,并且完全由用户负责管理它。
警告
使用 run=False
会使 tool_requires()
完全不可见,这意味着配置文件 [tool_requires]
将无法覆盖其版本,但它将创建一个额外的工具需求依赖项,其版本是从配置文件注入的。 您可能希望使用类似 !wine/*: gcc/3.0
的内容排除特定的包。
配方仍然可以在 generate()
方法中访问每个不同的 tool_require
版本,只需为我们想要的依赖项提供选项值 self.dependencies.build.get("gcc", options={"myoption": 1})
。
最后,最重要的是,这些工具的用法完全由用户负责。包含可执行文件的两个 tool_requires
的 bin
文件夹将位于路径中,这要归功于默认更新 PATH 环境变量的 VirtualBuildEnv
生成器。 在这种情况下,可执行文件是不同的,例如 mygcc1.sh```和 ``mygcc2.sh
,因此这不是问题,并且每个文件都将在其包内找到。
但是,如果可执行文件完全相同,例如 gcc.exe
,那么将需要获取完整文件夹(通常在 generate()
方法中),使用类似 self.dependencies.build.get("gcc", options={"myoption": 1}).cpp_info.bindir
的内容,并使用完整路径来消除歧义。
让我们看看它的工作原理。如果我们执行
$ conan create wine
...
wine/1.0: RUN: mygcc1.bat
MYGCC=1!!
wine/1.0: RUN: mygcc2.bat
MYGCC=2!!