Freigeben über

Lernprogramm: Einrichten eines vcpkg-Binärcaches mithilfe des GitHub-Aktionscaches

  • Artikel

Hinweis

In diesem Abschnitt wird ein experimentelles Feature von vcpkg behandelt, das jederzeit geändert oder entfernt werden kann.

vcpkg unterstützt die Verwendung des GitHub-Aktionen-Caches als binären Cachespeicher, wenn er im Kontext eines GitHub Actions-Workflows ausgeführt wird. Wenn Sie sich nicht darum kümmern, binärpakete in einen externen NuGet-Feed hochzuladen, ist dies die empfohlene Methode zum Verwenden der binären Zwischenspeicherung in einem GitHub-Aktionen-Workflow. Lesen Sie andernfalls das Lernprogramm, um GitHub-Pakete in einem GitHub Actions-Workflow zu verwenden.

In diesem Tutorial lernen Sie Folgendes:

Voraussetzungen

  • Ein Code-Editor
  • Ein GitHub-Repository mit GitHub-Aktionen
  • Ein Projekt mit vcpkg

1 – Exportieren erforderlicher GitHub Actions-Umgebungsvariablen

vcpkg benötigt die Aktionen Cache-URL und das Laufzeittoken, um als Umgebungsvariablen exportiert zu werden, die in Ihrem Workflow verfügbar sind. Kopieren Sie den folgenden Schritt in der Workflowdatei:

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

2 – Konfigurieren von vcpkg für die Verwendung des GitHub Actions-Caches

Legen Sie als Nächstes den Wert wie VCPKG_BINARY_SOURCES folgt fest:

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

Das war’s! vcpkg lädt jetzt Pakete aus Dem GitHub Actions-Cache hoch oder stellt sie wieder her.

Nächste Schritte

Authentifizieren bei privaten NuGet-Feeds

Hier sind weitere Aufgaben, die Sie als Nächstes ausprobieren können: