通过

教程：从命令行安装依赖项

  • 项目

提示

有关安装依赖项的建议方法，请参阅“从清单文件安装依赖项”。

警告

某些 vcpkg 功能在经典模式下不可用。

vcpkg 有两种运行模式：经典模式和清单模式。 本文介绍如何使用经典模式安装包。 对于大多数用户，我们建议改用清单模式。

在经典模式下，使用 vcpkg 作为命令行接口在常用安装目录中安装依赖项。 该目录通常位于 %VCPKG_ROOT%/installed，其中 %VCPKG_ROOT% 是 vcpkg 安装目录所在的位置。

在本教程中，学习：

先决条件

  • vcpkg
  • 终端
  • 代码编辑器
  • C++ 编译器
  • （可选）CMake 或 MSBuild

1 - 创建项目

在新文件夹中，使用以下内容创建名为 main.cxx 的源文件：

#include <cxxopts.hpp>
#include <fmt/format.h>
#include <range/v3/view.hpp>

namespace view = ranges::views;

int fib(int x)
{
  int a = 0, b = 1;

  for (int it : view::repeat(0) | view::take(x))
  {
    (void)it;
    int tmp = a;
    a += b;
    b = tmp;
  }

  return a;
}

int main(int argc, char **argv)
{
  cxxopts::Options options("fibo", "Print the fibonacci sequence up to a value 'n'");
  options.add_options()("n,value", "The value to print to", cxxopts::value<int>()->default_value("10"));

  auto result = options.parse(argc, argv);
  auto n = result["value"].as<int>();

  for (int x : view::iota(1) | view::take(n))
  {
    fmt::print("fib({}) = {}\n", x, fib(x));
  }
}

该代码引用开放源代码库：cxxopts、fmt 和 range-v3；这些库均在 https://github.com/Microsoft/vcpkg 的 vcpkg 公共注册表中提供。

2 - 将 vcpkg 与构建系统集成

在此步骤中，我们将向你展示如何将 vcpkg 与 CMake 或 MSBuild 集成，以便在构建项目时自动安装或还原项目依赖项。

如果使用其他构建系统，请跳到下一步：安装依赖项。

详细了解如何从 MSBuild 使用 vcpkg

要在 MSBuild 项目中使用 vcpkg，请运行以下命令：

vcpkg integrate install

只需在首次要启用 MSBuild 集成时运行 vcpkg integrate install 命令。 这将为所有现有和未来项目启用 MSBuild 集成。 使用 vcpkg integrate remove 可移除 MSBuild 系统范围的集成。

此集成方法自动将已安装 vcpkg 的包添加到以下项目属性：Include Directories、Link Directories 和 Link Libraries。 此外，这会创建一个构建后操作，该操作可确保将任何所需的 DLL 复制到构建输出文件夹中。 这适用于使用 Visual Studio 2015 或更高版本的所有解决方案和项目。

3 - 安装依赖项

该代码引用开放源代码库：cxxopts、fmt 和 range-v3；这些均在 https://github.com/Microsoft/vcpkg 的 vcpkg 公共注册表中提供。

要安装这些包，请使用 vcpkg install 命令。

vcpkg install cxxopts fmt range-v3

$ ./vcpkg install cxxopts fmt range-v3
Computing installation plan...
The following packages will be built and installed:
    cxxopts:x64-windows -> 3.1.1
    fmt:x64-windows -> 10.0.0
    range-v3:x64-windows -> 0.12.0#1
  * vcpkg-cmake:x64-windows -> 2023-05-04
  * vcpkg-cmake-config:x64-windows -> 2022-02-06#1
Additional packages (*) will be modified to complete this operation.
(omitted)
cxxopts provides CMake targets:

    # this is heuristically generated, and may not be correct
    find_package(cxxopts CONFIG REQUIRED)
    target_link_libraries(main PRIVATE cxxopts::cxxopts)

The package fmt provides CMake targets:

    find_package(fmt CONFIG REQUIRED)
    target_link_libraries(main PRIVATE fmt::fmt)

    # Or use the header-only version
    find_package(fmt CONFIG REQUIRED)
    target_link_libraries(main PRIVATE fmt::fmt-header-only)

range-v3 provides CMake targets:

    # this is heuristically generated, and may not be correct
    find_package(range-v3 CONFIG REQUIRED)
    target_link_libraries(main PRIVATE range-v3::meta range-v3::concepts range-v3::range-v3)

4 - 构建项目

重要

确保已安装包的三元组与项目的配置匹配。 对 64 位项目，使用 x64-windows 或 x64-windows-static；对 32 位项目，使用 x86-windows 或 x86-windows-static。

启用系统范围的集成后，只需运行 msbuild 即可构建项目：

PS D:\projects\manifest-example> msbuild
MSBuild version 17.7.0-preview-23319-02+6829506b8 for .NET Framework
Build started 8/13/2023 3:07:36 PM.

Project "D:\projects\manifest-example\manifest-example.sln" on node 1 (default targets).
ValidateSolutionConfiguration:
  (omitted)
PrepareForBuild:
  (omitted)
InitializeBuildStatus:
  (omitted)
ComputeStdModulesCompileInputs:
  (omitted)
SetModuleDependencies:
VcpkgTripletSelection:
  Using triplet "x64-windows" from "D:\vcpkg\installed\x64-windows\"
  Using normalized configuration "Debug"
ClCompile:
  (omitted)
Link:
  (omitted)
AppLocalFromInstalled:
  pwsh.exe -ExecutionPolicy Bypass -noprofile -File "D:\vcpkg\scripts\buildsystems\msbuild\applocal.ps1" "D:\projects\manifest-example\x64\Debug\manifest-example.exe"
   "D:\vcpkg\installed\x64-windows\debug\bin" "x64\Debug\manifest-example.tlog\manifest-example.write.1u.tlog" "x64\Debug\vcpkg.applocal.log"
  D:\projects\manifest-example\x64\Debug\fmtd.dll
FinalizeBuildStatus:
  Deleting file "x64\Debug\manifest-example.tlog\unsuccessfulbuild".
  Touching "x64\Debug\manifest-example.tlog\manifest-example.lastbuildstate".
Done Building Project "D:\projects\manifest-example\manifest-example.vcxproj" (default targets).

Done Building Project "D:\projects\manifest-example\manifest-example.sln" (default targets).

Build succeeded.

后续步骤

在本教程中，你将使用 vcpkg 作为命令行接口安装简单项目的依赖项。

以下是接下来要尝试的一些其他任务：