kmpkg_download_distfile
Download and cache a file needed for this port.
This helper should always be used instead of CMake's built-in file(DOWNLOAD) command, as it
enables features like Asset Caching.
If possible, one of the kmpkg_from_ functions should be used rather than calling this function
directly, such as one of the following:
Usage
kmpkg_download_distfile(
<out-var>
URLS <http://mainUrl> <http://mirror1>...
FILENAME <output.zip>
SHA512 <5981de...>
[ALWAYS_REDOWNLOAD]
)
Parameters
out-var
The name of the out variable to be set with the full path to the downloaded file.
This variable can then immediately be passed to kmpkg_extract_source_archive
for sources.
Conventionally, ARCHIVE is used as the out variable name.
kmpkg_donwload_distfile(
ARCHIVE #this is the out-var
URLS "https://downloads.apache.org/apr/apr-${VERSION}.tar.bz2"
FILENAME "apr-${VERSION}.tar.bz2"
SHA512 629b60680d1244641828019db903a1b199e8a19c8f27a5132b93faacb381ce561f88463345ab019258f1f1e8cfdf8aa986ac815153a8e7e04a22b3932f9fedd2
)
URLS
A list of URLs to be consulted. They will be tried in order until one of the downloaded files successfully matches the SHA512 given.
FILENAME
The local name for the file. Files are shared between ports, so the file may need to be renamed to make it clearly attributed to this port and avoid conflicts.
SHA512
The expected hash for the file.
If this doesn't match the downloaded version, the build will be terminated with a message describing the mismatch.
QUIET
Suppress output on cache hit
SKIP_SHA512
Skip SHA512 hash check for file.
This switch is only valid when building with the --head command line flag.
ALWAYS_REDOWNLOAD
Avoid caching; this is a REST call or otherwise unstable.
Requires SKIP_SHA512.
HEADERS
A list of headers to append to the download request. This can be used for authentication during a download.
Headers should be specified as "<header-name>: <header-value>".