MSBuild

MSBuild 构建助手是对 MSBuild 命令行调用的封装。它将诸如 msbuild "MyProject.sln" /p:Configuration=<conf> /p:Platform=<platform> 这样的调用抽象为 Python 方法。

此助手可按如下方式使用:

from conan import ConanFile
from conan.tools.microsoft import MSBuild

class App(ConanFile):
    settings = "os", "arch", "compiler", "build_type"

    def build(self):
        msbuild = MSBuild(self)
        msbuild.build("MyProject.sln")

MSBuild.build() 方法内部实现了对 msbuild 的调用,例如:

$ <vcvars-cmd> && msbuild "MyProject.sln" /p:Configuration=<configuration> /p:Platform=<platform>

其中

  • <vcvars-cmd> 调用与当前配方 settings 匹配的 Visual Studio 命令提示符。

  • configuration,通常为 Release、Debug,将从 settings.build_type 中获取,但可以通过 build_type 属性进行自定义。

  • <platform> 是架构,是将 settings.arch 映射到常见的“x86”、“x64”、“ARM”、“ARM64”、“ARM64EC”。这可以通过 platform 属性进行自定义。

自定义

属性

如果需要更改,可以自定义以下属性:

  • build_type(默认 settings.build_type):/p:Configuration 的值。

  • platform(默认基于 settings.arch 选择以下值之一:('x86', 'x64', 'ARM', 'ARM64', 'ARM64EC')):/p:Platform 的值。

示例

from conan import ConanFile
from conan.tools.microsoft import MSBuild
class App(ConanFile):
    settings = "os", "arch", "compiler", "build_type"
    def build(self):
        msbuild = MSBuild(self)
        msbuild.build_type = "MyRelease"
        msbuild.platform = "MyPlatform"
        msbuild.build("MyProject.sln")

conf

MSBuild 受这些 [conf] 变量影响:

  • tools.build:verbosity 接受 quietverbose 之一,并作为 msbuild .... /verbosity:{Quiet,Detailed} 传递给 MSBuild.build() 调用。

  • tools.microsoft.msbuild:max_cpu_count 最大CPU数量,将作为 msbuild .... /m:N 传递给 MSBuild.build() 调用。如果 max_cpu_count=0,则将使用不带参数的 /m,这意味着使用所有可用的CPU。

参考

MSBuild(conanfile)

MSBuild 构建助手类

参数:

conanfile< ConanFile object > 当前的配方对象。始终使用 self

command(sln, targets=None)

获取 msbuild 命令行。例如,msbuild.exe "MyProject.sln" -p:Configuration=<conf> -p:Platform=<platform>

参数:
  • slnstr Visual Studio *.sln 文件的名称

  • targetstargets 是一个可选参数,默认为 None,否则它是一个要构建的目标列表。

返回:

str msbuild 命令行。

build(sln, targets=None)

运行从 self.command(sln) 获取的 msbuild 命令行。

参数:
  • slnstr Visual Studio *.sln 文件的名称

  • targetstargets 是一个可选参数,默认为 None,否则它是一个要构建的目标列表。