5858 # Or pin to a specific CMake version:
5959 # lukka/get-cmake@v3.21.2
6060
61- # Run vcpkg leveraging its own binary caching integration with GitHub Action
62- # cache. Since vcpkg.json is being used later on to install the packages
63- # when `run-cmake` runs, no packages are installed at this time.
61+ # Setup vcpkg: ensures vcpkg is downloaded and built.
62+ # Since vcpkg.json is being used later on to install the packages
63+ # when `run-cmake` runs, no packages are installed at this time
64+ # (and vcpkg does not run).
6465 - name : Setup vcpkg (it does not install any package yet)
6566 uses : lukka/run-vcpkg@v11
6667 # with:
6970 # vcpkgDirectory: '${{ github.workspace }}/vcpkg'
7071
7172 # If not using a submodule for vcpkg sources, this specifies which commit
72- # id must be checkout from a Git repo. It must not be set if using a
73- # submodule for vcpkg.
73+ # id must be checkout from a Git repo.
74+ # Note: it must not be set if using a Git submodule for vcpkg.
7475 # vcpkgGitCommitId: '${{ matrix.vcpkgCommitId }}'
7576
7677 # This is the glob expression used to locate the vcpkg.json.
8182 # `**/path/from/root/of/repo/to/vcpkg.json` to match the desired `vcpkg.json`.
8283 # vcpkgJsonGlob: '**/vcpkg.json'
8384
84- # This is only needed if running `vcpkg install` is needed at this step.
85+ # This is only needed if the command `vcpkg install` must run at this step.
8586 # Instead it is highly suggested to let `run-cmake` to run vcpkg later on
8687 # using the vcpkg.cmake toolchain. The default is `false`.
8788 # runVcpkgInstall: true
@@ -123,10 +124,11 @@ Flowchart with related input in [action.yml](https://github.com/lukka/run-vcpkg/
123124
124125```
125126┌──────────────────────────┐
127+ | Skipped by default. |
126128│ Compute cache key from: │ Inputs:
127129│ - vcpkg Git commit │ - `vcpkgGitCommitId`
128- │ - platform and OS │
129- └─────────────┬────────────┘
130+ │ - platform and OS │ - `doNotCache`: set to false
131+ └─────────────┬────────────┘ to run this block.
130132 │
131133 ▼
132134 ┌─────────────────────────┐ Inputs:
@@ -135,9 +137,10 @@ Flowchart with related input in [action.yml](https://github.com/lukka/run-vcpkg/
135137 │
136138 ▼
137139 ┌─────────────────────────┐ Inputs:
140+ | Skipped by default. |
138141 │ Restore vcpkg │ - `vcpkgDirectory`
139- │ from the GH cache │
140- └────────────┬────────────┘
142+ │ from the GH cache. │ - `doNotCache`: set to false
143+ └────────────┬────────────┘ to run this block.
141144 │
142145 ▼
143146 ┌─────────────────────────┐
@@ -150,7 +153,7 @@ Flowchart with related input in [action.yml](https://github.com/lukka/run-vcpkg/
150153 ┌─────────────────────────┐
151154 │ Rebuild vcpkg executable│ Inputs:
152155 │ if not in sync with │ - `vcpkgGitCommitId`
153- │ sources │ - `vcpkgGitURL`
156+ │ sources. │ - `vcpkgGitURL`
154157 └────────────┬────────────┘
155158 │
156159 ▼
@@ -161,7 +164,7 @@ Flowchart with related input in [action.yml](https://github.com/lukka/run-vcpkg/
161164 ┌─────────────────────────┐ │
162165 │ Launch `vcpkg install` │ │ Inputs:
163166 │ where vcpkg.json has │ │ - `runVcpkgFormatString`
164- │ been located │ │ Environment variables:
167+ │ been located. │ │ Environment variables:
165168 └────────────┬────────────┘ │ - `VCPKG_DEFAULT_TRIPLET` is used. If not yet
166169 │ │ set, it is set to the current platform.
167170 │ │ - `VCPKG_INSTALLED_DIR` is used as value for
@@ -171,14 +174,15 @@ Flowchart with related input in [action.yml](https://github.com/lukka/run-vcpkg/
171174 ┌─────────────────────────┐ │ set, it is set to leverage the GitHub Action
172175 │ Set `VCPKG_ROOT` and │ │ cache storage for Binary Caching artifacts.
173176 │ `VCPKG_DEFAULT_TRIPLET` │ │
174- │ workflow-wide env vars │ │
177+ │ workflow-wide env vars. │ │
175178 └────────────┬────────────┘ │
176179 ├───────────── ┘
177180 ▼
178181 ┌─────────────────────────┐
179- │ If no cache-hit, │ Inputs:
180- │ store vcpkg onto │ - `doNotCache`: disable the caching of the vcpkg
181- │ GH cache │ executable and its data files.
182+ | Skipped by default. |
183+ │ If no cache-hit, │ Inputs:
184+ │ store vcpkg onto │ - `doNotCache`: set to false to
185+ │ GH cache │ run this block.
182186 └────────────┬────────────┘
183187 |
184188 ▼
0 commit comments