Руководство. Настройка двоичного кэша vcpkg с помощью кэша действий GitHub

Примечание.

В этом разделе рассматривается экспериментальная функция vcpkg, которая может изменяться или удаляться в любое время.

vcpkg поддерживает использование кэша GitHub Actions в качестве двоичного хранилища кэширования при выполнении в контексте рабочего процесса GitHub Actions. Если вы не заботитесь о отправке двоичных пакетов во внешний веб-канал NuGet, это рекомендуемый метод для использования двоичного кэширования в рабочем процессе GitHub Actions. В противном случае ознакомьтесь с руководством по использованию пакетов GitHub в рабочем процессе GitHub Actions.

Из этого руководства вы узнаете, как выполнять следующие задачи:

Необходимые компоненты

  • Редактор кода
  • Репозиторий GitHub с помощью GitHub Actions
  • Проект с помощью vcpkg

1. Экспорт обязательных переменных envrionment GitHub Actions

vcpkg требует, чтобы URL-адрес кэша действий и маркер среды выполнения экспортировались в виде переменных среды, доступных в рабочем процессе. Скопируйте следующий шаг в файл рабочего процесса:

- name: Export GitHub Actions cache environment variables
  uses: actions/github-script@v6
  with:
    script: |
      core.exportVariable('ACTIONS_CACHE_URL', process.env.ACTIONS_CACHE_URL || '');
      core.exportVariable('ACTIONS_RUNTIME_TOKEN', process.env.ACTIONS_RUNTIME_TOKEN || '');

2. Настройка vcpkg для использования кэша GitHub Actions

Затем задайте значение VCPKG_BINARY_SOURCES следующим образом:

env: 
    VCPKG_BINARY_SOURCES: "clear;x-gha,readwrite"

Вот и все! vcpkg теперь будет отправлять или восстанавливать пакеты из кэша GitHub Actions.

Следующие шаги

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