The latest version of this document lives in the vcpkg repo.
Extract an archive into the source directory. Deprecated in favor of vcpkg_extract_source_archive_ex
.
vcpkg_extract_source_archive(
<${ARCHIVE}> [<${TARGET_DIRECTORY}>]
)
The full path to the archive to be extracted.
This is usually obtained from calling vcpkg_download_distfile
.
If specified, the archive will be extracted into the target directory instead of ${CURRENT_BUILDTREES_DIR}/src/
.
This can be used to mimic git submodules, by extracting into a subdirectory of another archive.
This command will also create a tracking file named .extracted in the TARGET_DIRECTORY. This file, when present, will suppress the extraction of the archive.