visual_studio_logo Visual Studio

适用于 Visual Studio 的 Recipe 工具

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 扩展

有一个扩展程序 可在 Visual Studio 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 博客中的此示例。

另请参阅