vcpkg Reference

The Sol3 SDK uses vcpkg for C++ dependency management, providing consistent builds across platforms. Additional third party dependencies should be added via vcpkg if possible.

Package Management

Add Dependencies - Edit vcpkg.json:

{
  "dependencies": ["boost-system", "openssl"]
}

Binary Caching

Within the docker workflow we cache vcpkg binaries to speed up incremental builds. To inspect/clear the cache, use the following commands:

# Check cache usage
docker system df

# Clean build cache (forces full rebuild)
docker builder prune

# Clear specific package build artifacts
rm -rf external/vcpkg/buildtrees/<package-name>

Triplets

The SDK uses custom triplets for cross-compilation:

Triplet	Target	Use Case
`x64-sol3-clang`	x86_64/Host	Development PC builds
`arm64-sol3-clang`	ARM64/QRB5165	Sol3/HDK cross-compiled builds

Troubleshooting

Clean Rebuild:

# Clear all vcpkg artifacts
rm -rf external/vcpkg/buildtrees external/vcpkg/packages
docker builder prune
cmake --preset x64