Esercitazione: Configurare una cache binaria vcpkg usando la cache di GitHub Actions

Nota

Questa sezione illustra una funzionalità sperimentale di vcpkg che può cambiare o essere rimossa in qualsiasi momento.

vcpkg supporta l'uso della cache di GitHub Actions come archiviazione di memorizzazione nella cache binaria durante l'esecuzione nel contesto di un flusso di lavoro di GitHub Actions. Se non ti interessa caricare pacchetti binari in un feed NuGet esterno, questo è il metodo consigliato per usare la memorizzazione nella cache binaria in un flusso di lavoro di GitHub Actions. In caso contrario, leggere l'esercitazione per usare GitHub Packages in un flusso di lavoro di GitHub Actions.

Questa esercitazione illustra come:

Prerequisiti

  • Editor di codice
  • Un repository GitHub con GitHub Actions
  • Un progetto che usa vcpkg

1 - Esportare le variabili di ambiente di GitHub Actions necessarie

vcpkg richiede che l'URL della cache delle azioni e il token di runtime vengano esportati come variabili di ambiente disponibili nel flusso di lavoro. Copiare il passaggio seguente nel file del flusso di lavoro:

- 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 - Configurare vcpkg per l'uso della cache di GitHub Actions

Impostare quindi il valore di VCPKG_BINARY_SOURCES come segue:

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

L'attività è terminata. vcpkg caricherà o ripristinerà i pacchetti dalla cache di GitHub Actions.

Passaggi successivi

Ecco altre attività da provare: