visual_studio_logo Visual Studio

Visual Studio 的配方工具

Conan 提供了多个工具来帮助使用 Microsoft Visual Studio 管理您的项目。这些工具可以从 conan.tools.microsoft 中导入,并允许与 Microsoft Visual Studio 进行原生集成,无需使用 CMake,而是直接使用 Visual Studio 解决方案、项目和属性文件。最相关的工具是

  • MSBuildDeps:Microsoft MSBuild 构建系统的依赖项信息生成器。它将为每个包的依赖项生成多个 xxxx.props 属性文件,供使用 MSBuild 或 Visual Studio 的使用者使用,只需将生成的属性文件添加到解决方案和项目中。

  • MSBuildToolchain:MSBuild 的工具链生成器。它将生成可添加到 Visual Studio 解决方案项目的 MSBuild 属性文件。此生成器将当前包配置、设置和选项转换为 MSBuild 属性文件语法。

  • MSBuild 构建助手是围绕 MSBuild 命令行调用的包装器。它将像 msbuild "MyProject.sln" /p:Configuration=<conf> /p:Platform=<platform> 这样的调用抽象为 Python 方法调用。

有关 conan.tools.microsoft 下所有工具的完整列表,请查看 参考 部分。

Visual Studio 的 Conan 扩展

有一个扩展 可在 VisualStudio Marketplace 获取,它从 Visual Studio 版本 2022 开始兼容。使用此扩展,您可以浏览 Conan Center 中可用的 Conan 包,将它们添加到您的项目中,它们将在构建项目之前自动安装。

注意

Visual Studio 扩展仅与基于 MSBuild 的 C/C++ 项目兼容。它不适用于基于 CMake 的项目或使用其他技术的项目。对于基于 CMake 的项目,请参阅 cmake-conan 依赖项提供程序

安装

Conan Visual Studio 扩展可以直接从 Visual Studio 中安装

  • 打开扩展菜单。

  • 选择管理扩展。

  • 在联机市场中搜索“Conan”。

  • 下载并安装扩展。

或者,您可以从我们的 发行版页面 下载最新版本并手动安装。

初始配置

安装 Conan 扩展后,您可以从 Visual Studio 中的“Conan”工具窗口访问它。为此,请转到**视图 > 其他窗口 > Conan C/C++ 包管理器**。

Initial configuration

最初,您需要配置扩展要使用的 Conan 可执行文件。通过单击扩展窗口中的“配置”按钮(齿轮图标),您可以设置 Conan 客户端可执行文件的路径。您可以指定自定义路径或选择使用系统级安装的 Conan 客户端。

Select Conan executable

配置完 Conan 客户端后,扩展即可使用,您可以开始将库添加到您的项目中。

搜索和添加库

配置完成后,Conan 工具窗口中的库列表变为活动状态,您可以使用搜索栏搜索 Conan 包。选择库将允许您查看其详细信息,包括可用的版本和集成选项。

Search for Conan packages

如果您现在单击“添加需求”按钮,扩展将向您的项目添加一个 conanfile.py 和一个 conandata.yml,其中包含安装选定的 Conan 包所需的信息。它还会向项目添加一个预构建事件,以便在下次编译项目时安装这些库。

在任何时候,您也可以使用“刷新”按钮(圆形箭头图标)来更新 Conan Center 中可用包的列表。

现在,如果您启动项目的构建过程,预构建事件将触发 Conan 安装包并将必要的属性注入到项目中,使 Visual Studio 能够编译并链接到这些库。

Build project with Conan packages

警告

如果 Visual Studio 没有足够的时间来处理注入的属性,则初始编译可能会失败。如果发生这种情况,只需重新构建项目,它应该会成功构建。

有关使用实际示例更深入地介绍 Conan Visual Studio 扩展,请查看此 Conan 博客中的示例

另请参阅