set_name()

动态定义 name 属性。 此方法很少需要使用，唯一有意义的用例是当 recipe 被共享并用于使用相同的 recipe 创建不同的软件包时。 在大多数情况下，推荐的方法是在 recipe 中定义 name = "mypkg" 属性。

此方法仅在 recipe 导出到缓存 conan create 和 conan export 时执行，以及当 recipe 在本地使用时执行，例如使用 conan install .。 在所有其他情况下，软件包的名称都已完全定义，并且不会调用 set_name()，因此不要依赖它来实现除定义 self.name 值之外的任何其他功能。

如果当前软件包名称在 name.txt 文件中定义，则可以执行以下操作

from conan import ConanFile
from conan.tools.files import load

class Pkg(ConanFile):
    def set_name(self):
        # This will execute relatively to the current user directory (name.txt in cwd)
        self.name = load(self, "name.txt")
        # if "name.txt" is located relative to the conanfile.py better do:
        self.name = load(self, os.path.join(self.recipe_folder, "name.txt"))

软件包名称也可以在命令行中为某些命令使用 --name=xxxx 参数来定义。 如果我们想优先考虑命令行参数，我们应该这样做

from conan import ConanFile
from conan.tools.files import load

class Pkg(ConanFile):
    def set_name(self):
        # Command line ``--name=xxxx`` will be assigned first to self.name and have priority
        self.name = self.name or load(self, "name.txt")

set_name() 方法可以决定定义 name 值，而无需考虑潜在的 --name=xxx 命令行参数，该参数甚至可以被 set_name() 完全忽略。 开发人员有责任提供正确的 set_name()

def set_name(self):
    # This will always assign "pkg" as name, ignoring ``--name`` command line argument
    # and without erroring or warning
    self.name = "pkg"

如果提供了命令行参数 --name=xxx，它将在 self.name 属性中初始化，因此 set_name() 方法可以读取和使用它

def set_name(self):
    # Takes the provided command line ``--name`` argument and creates a name appending to
    # it the ".extra" string
    self.name = self.name + ".extra"

警告

set_name() 方法是 name 属性的替代方法。 不建议或不支持同时定义 name 属性和 set_name() 方法。