chore(build): align vcpkg configuration with registry baseline#246
Merged
Conversation
added 2 commits
March 28, 2026 15:29
Update kcenon vcpkg-registry baseline to latest commit (afdfab7)
which includes 18 commits of portfile fixes for cmake config paths,
dependency declarations, and FETCHCONTENT flags.
Add CONFIG hint to find_package calls in UnifiedDependencies.cmake
to ensure vcpkg-installed config-mode packages are found reliably.
Add vcpkg manifest mode preset to CMakePresets.json referencing
$env{VCPKG_ROOT} toolchain file for standardized local builds.
Refs: #245
…ment - README.md: add vcpkg preset as build option alongside manual toolchain - BUILD_TROUBLESHOOTING.md: add section on stale vcpkg baseline issues - DEVELOPER_GUIDE.md: add vcpkg preset option to build instructions
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Summary
Aligns vcpkg ecosystem configuration with the latest registry baseline and improves CMake package resolution for vcpkg manifest mode. Adds a dedicated
vcpkgCMake preset for streamlined builds.Change Type
Affected Components
vcpkg-configuration.json— registry baseline updatecmake/UnifiedDependencies.cmake— CONFIG hint for find_packageCMakePresets.json— new vcpkg presetREADME.md,docs/guides/BUILD_TROUBLESHOOTING.md,docs/guides/DEVELOPER_GUIDE.md— documentationWhy
Problem Solved
The vcpkg registry baseline (
77cc46d5) was outdated, which could cause dependency resolution failures or version mismatches when building with vcpkg manifest mode. Additionally,find_package()calls lackedCONFIGhints, causing CMake to prefer module-mode search over vcpkg-installed config packages.Related Issues
Alternative Approaches Considered
Where
Files Changed
vcpkg-configuration.json77cc46d5→afdfab7f)cmake/UnifiedDependencies.cmakeCMakePresets.jsonvcpkgconfigure and build presetsREADME.mddocs/guides/BUILD_TROUBLESHOOTING.mddocs/guides/DEVELOPER_GUIDE.mdHow
Implementation Details
vcpkg-configuration.jsonto point to latest registry commit (afdfab7f) for current package versions.CONFIGkeyword tofind_package()inUnifiedDependencies.cmakeso CMake prefers vcpkg config-mode packages over system module-mode discovery.vcpkgpreset inCMakePresets.jsonthat sets the vcpkg toolchain file, enables external systems, and disables FetchContent — providing a one-command build experience.Testing Done
Test Plan
VCPKG_ROOTenvironment variablecmake --preset vcpkg && cmake --build --preset vcpkgBreaking Changes
None — existing build workflows are unaffected. The new
vcpkgpreset is opt-in.