Руководство. Установка зависимости из командной строки

Кончик

Рекомендуемый метод установки зависимостей см. в разделе "Установка зависимости из manifest файла".

Предупреждение

Некоторые функции vcpkg недоступны в classic режиме.

vcpkg имеет два режима работы: classic режим и manifest режим. В этой статье описывается установка пакетов с помощью classic режима. Для большинства пользователей вместо этого рекомендуется использовать manifest режим.

В classic режиме 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; которые доступны в общедоступном реестре vcpkg в https://github.com/Microsoft/vcpkg.

2. Интеграция vcpkg с системой сборки

На этом шаге мы покажем, как интегрировать vcpkg с CMake или MSBuild, чтобы зависимости проекта автоматически устанавливались или восстанавливались при сборке проекта.

Если вы используете другую систему сборки, перейдите к следующему шагу: установить зависимости.

Узнайте больше об использовании vcpkg в MSBuild

Чтобы использовать vcpkg в проектах MSBuild, выполните следующую команду:

vcpkg integrate install

Вам нужно выполнить только команду vcpkg integrate install при первом включении интеграции MSBuild. Это позволяет интегрировать MSBuild для всех существующих и будущих проектов. Используйте vcpkg integrate remove для удаления интеграции на уровне системы MSBuild.

Этот метод интеграции автоматически добавляет пакеты, установленные vcpkg, в следующие свойства проекта: Include Directories, Link Directoriesи Link Libraries. Кроме того, это создает действие после сборки, которое гарантирует, что все необходимые библиотеки DLL копируются в выходную папку сборки. Это работает для всех решений и проектов с помощью Visual Studio 2017 или более поздней версии.

3. Установка зависимостей

Код ссылается на библиотеки с открытым кодом: cxxopts, fmtи range-v3; Все они доступны в общедоступном реестре vcpkg в https://github.com/Microsoft/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. Создание проекта

Важный

Убедитесь, что triplet ваших установленных пакетов соответствует конфигурации вашего проекта. Используйте x64-windows или x64-windows-static для 64-разрядных проектов и x86-windows или x86-windows-static для 32-разрядных проектов.

С включенной интеграцией на уровне системы просто запустите 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:
  "D:\vcpkg\vcpkg.exe" z-applocal --target-binary="D:\projects\manifest-example\x64\Debug\manifest-example.exe"
   --installed-bin-dir="D:\vcpkg\installed\x64-windows\debug\bin" --tlog-file="x64\Debug\manifest-example.tlog\manifest-example.write.1u.tlog" --copied-files-log="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 в качестве интерфейса командной строки.

Ниже приведены некоторые дополнительные задачи, которые необходимо выполнить следующим образом:

  • Установка пакетов с помощью manifest файла
  • Установите пакеты для пользовательских платформ, используя триплеты
  • Закрепите ваши версии для воспроизводимых сборок, используя управление версиями .
  • Повторное использование двоичных файлов в запусках непрерывной интеграции с использованием двоичного кэширования
  • Управляйте частными библиотеками с помощью пользовательских реестров
  • Last updated on