mirror of
https://github.com/microsoft/vcpkg.git
synced 2024-11-24 08:39:01 +08:00
6b117c9c7e
* [vcpkg docs] Change how documenting port functions works Instead of using `##`, use comment blocks for documentation. Also, add some minor docs and change RST -> MD so we actually get docs generated. * add CI stuff * regenerate docs * fix vcpkg_find_acquire_program to not use _execute_process
240 lines
8.2 KiB
CMake
240 lines
8.2 KiB
CMake
#[===[.md:
|
|
# vcpkg_from_sourceforge
|
|
|
|
Download and extract a project from sourceforge.
|
|
|
|
## Usage:
|
|
```cmake
|
|
vcpkg_from_sourceforge(
|
|
OUT_SOURCE_PATH SOURCE_PATH
|
|
REPO <cunit/CUnit>
|
|
[REF <2.1-3>]
|
|
SHA512 <547b417109332...>
|
|
FILENAME <CUnit-2.1-3.tar.bz2>
|
|
[DISABLE_SSL]
|
|
[NO_REMOVE_ONE_LEVEL]
|
|
[PATCHES <patch1.patch> <patch2.patch>...]
|
|
)
|
|
```
|
|
|
|
## Parameters:
|
|
### OUT_SOURCE_PATH
|
|
Specifies the out-variable that will contain the extracted location.
|
|
|
|
This should be set to `SOURCE_PATH` by convention.
|
|
|
|
### REPO
|
|
The organization or user and repository (optional) on sourceforge.
|
|
|
|
### REF
|
|
A stable version number that will not change contents.
|
|
|
|
### 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.
|
|
|
|
For example, we can get the download link:
|
|
https://sourceforge.net/settings/mirror_choices?projectname=mad&filename=libmad/0.15.1b/libmad-0.15.1b.tar.gz&selected=nchc
|
|
So the REPO is `mad/libmad`, the REF is `0.15.1b`, and the FILENAME is `libmad-0.15.1b.tar.gz`
|
|
|
|
For some special links:
|
|
https://sourceforge.net/settings/mirror_choices?projectname=soxr&filename=soxr-0.1.3-Source.tar.xz&selected=nchc
|
|
The REPO is `soxr`, REF is not exist, and the FILENAME is `soxr-0.1.3-Source.tar.xz`
|
|
|
|
### SHA512
|
|
The SHA512 hash that should match the archive.
|
|
|
|
### WORKING_DIRECTORY
|
|
If specified, the archive will be extracted into the working directory instead of `${CURRENT_BUILDTREES_DIR}/src/`.
|
|
|
|
Note that the archive will still be extracted into a subfolder underneath that directory (`${WORKING_DIRECTORY}/${REF}-${HASH}/`).
|
|
|
|
### PATCHES
|
|
A list of patches to be applied to the extracted sources.
|
|
|
|
Relative paths are based on the port directory.
|
|
|
|
### DISABLE_SSL
|
|
Disable ssl when downloading source.
|
|
|
|
### NO_REMOVE_ONE_LEVEL
|
|
Specifies that the default removal of the top level folder should not occur.
|
|
|
|
## Examples:
|
|
|
|
* [cunit](https://github.com/Microsoft/vcpkg/blob/master/ports/cunit/portfile.cmake)
|
|
* [polyclipping](https://github.com/Microsoft/vcpkg/blob/master/ports/polyclipping/portfile.cmake)
|
|
* [tinyfiledialogs](https://github.com/Microsoft/vcpkg/blob/master/ports/tinyfiledialogs/portfile.cmake)
|
|
#]===]
|
|
|
|
function(vcpkg_from_sourceforge)
|
|
macro(check_file_content)
|
|
if (EXISTS ${ARCHIVE})
|
|
file(SIZE ${ARCHIVE} DOWNLOAD_FILE_SIZE)
|
|
if (DOWNLOAD_FILE_SIZE LESS_EQUAL 1024)
|
|
file(READ ${ARCHIVE} _FILE_CONTENT_)
|
|
string(FIND "${_FILE_CONTENT_}" "the Sourceforge site is currently in Disaster Recovery mode." OUT_CONTENT)
|
|
message("OUT_CONTENT: ${OUT_CONTENT}")
|
|
if (OUT_CONTENT EQUAL -1)
|
|
set(download_success 1)
|
|
else()
|
|
file(REMOVE ${ARCHIVE})
|
|
endif()
|
|
endif()
|
|
endif()
|
|
endmacro()
|
|
|
|
macro(check_file_sha512)
|
|
file(SHA512 ${ARCHIVE} FILE_HASH)
|
|
if(NOT FILE_HASH STREQUAL _vdus_SHA512)
|
|
message(FATAL_ERROR
|
|
"\nFile does not have expected hash:\n"
|
|
" File path: [ ${ARCHIVE} ]\n"
|
|
" Expected hash: [ ${_vdus_SHA512} ]\n"
|
|
" Actual hash: [ ${FILE_HASH} ]\n"
|
|
"${CUSTOM_ERROR_ADVICE}\n")
|
|
endif()
|
|
endmacro()
|
|
|
|
set(booleanValueArgs DISABLE_SSL NO_REMOVE_ONE_LEVEL)
|
|
set(oneValueArgs OUT_SOURCE_PATH REPO REF SHA512 FILENAME WORKING_DIRECTORY)
|
|
set(multipleValuesArgs PATCHES)
|
|
# parse parameters such that semicolons in options arguments to COMMAND don't get erased
|
|
cmake_parse_arguments(PARSE_ARGV 0 _vdus "${booleanValueArgs}" "${oneValueArgs}" "${multipleValuesArgs}")
|
|
|
|
if(NOT DEFINED _vdus_OUT_SOURCE_PATH)
|
|
message(FATAL_ERROR "OUT_SOURCE_PATH must be specified.")
|
|
endif()
|
|
|
|
if(NOT DEFINED _vdus_SHA512)
|
|
message(FATAL_ERROR "SHA512 must be specified.")
|
|
endif()
|
|
|
|
if(NOT DEFINED _vdus_REPO)
|
|
message(FATAL_ERROR "The sourceforge repository must be specified.")
|
|
endif()
|
|
|
|
if(DEFINED _vdus_WORKING_DIRECTORY)
|
|
set(WORKING_DIRECTORY WORKING_DIRECTORY "${_vdus_WORKING_DIRECTORY}")
|
|
else()
|
|
set(WORKING_DIRECTORY)
|
|
endif()
|
|
|
|
if (_vdus_DISABLE_SSL)
|
|
set(URL_PROTOCOL http:)
|
|
else()
|
|
set(URL_PROTOCOL https:)
|
|
endif()
|
|
|
|
set(SOURCEFORGE_HOST ${URL_PROTOCOL}//sourceforge.net/projects)
|
|
|
|
string(FIND ${_vdus_REPO} "/" FOUND_ORG)
|
|
if (NOT FOUND_ORG EQUAL -1)
|
|
string(SUBSTRING "${_vdus_REPO}" 0 ${FOUND_ORG} ORG_NAME)
|
|
math(EXPR FOUND_ORG "${FOUND_ORG} + 1") # skip the slash
|
|
string(SUBSTRING "${_vdus_REPO}" ${FOUND_ORG} -1 REPO_NAME)
|
|
if (REPO_NAME MATCHES "/")
|
|
message(FATAL_ERROR "REPO should contain at most one slash (found ${_vdus_REPO}).")
|
|
endif()
|
|
set(ORG_NAME ${ORG_NAME}/)
|
|
else()
|
|
set(ORG_NAME ${_vdus_REPO}/)
|
|
set(REPO_NAME )
|
|
endif()
|
|
|
|
if (DEFINED _vdus_REF)
|
|
set(URL "${SOURCEFORGE_HOST}/${ORG_NAME}files/${REPO_NAME}/${_vdus_REF}/${_vdus_FILENAME}")
|
|
else()
|
|
set(URL "${SOURCEFORGE_HOST}/${ORG_NAME}${REPO_NAME}/files/${_vdus_FILENAME}")
|
|
endif()
|
|
|
|
set(NO_REMOVE_ONE_LEVEL )
|
|
if (_vdus_NO_REMOVE_ONE_LEVEL)
|
|
set(NO_REMOVE_ONE_LEVEL "NO_REMOVE_ONE_LEVEL")
|
|
endif()
|
|
|
|
string(SUBSTRING "${_vdus_SHA512}" 0 10 SANITIZED_REF)
|
|
|
|
list(APPEND SOURCEFORGE_MIRRORS
|
|
cfhcable # United States
|
|
pilotfiber # New York, NY
|
|
gigenet # Chicago, IL
|
|
versaweb # Las Vegas, NV
|
|
ayera # Modesto, CA
|
|
netactuate # Durham, NC
|
|
phoenixnap # Tempe, AZ
|
|
astuteinternet # Vancouver, BC
|
|
freefr # Paris, France
|
|
netcologne # Cologne, Germany
|
|
deac-riga # Latvia
|
|
excellmedia # Hyderabad, India
|
|
iweb # Montreal, QC
|
|
jaist # Nomi, Japan
|
|
jztkft # Mezotur, Hungary
|
|
managedway # Detroit, MI
|
|
nchc # Taipei, Taiwan
|
|
netix # Bulgaria
|
|
ufpr # Curitiba, Brazil
|
|
tenet # Wynberg, South Africa
|
|
)
|
|
|
|
# Try to use auto-select first
|
|
set(DOWNLOAD_URL ${URL}/download)
|
|
message(STATUS "Trying auto-select mirror...")
|
|
vcpkg_download_distfile(ARCHIVE
|
|
URLS "${DOWNLOAD_URL}"
|
|
SKIP_SHA512
|
|
FILENAME "${_vdus_FILENAME}"
|
|
SILENT_EXIT
|
|
)
|
|
check_file_content()
|
|
if (download_success)
|
|
check_file_sha512()
|
|
else()
|
|
message(STATUS "The default mirror is in Disaster Recovery mode, trying other mirrors...")
|
|
endif()
|
|
|
|
if (NOT download_success EQUAL 1)
|
|
foreach(SOURCEFORGE_MIRROR ${SOURCEFORGE_MIRRORS})
|
|
set(DOWNLOAD_URL ${URL}/download?use_mirror=${SOURCEFORGE_MIRROR})
|
|
message(STATUS "Trying mirror ${SOURCEFORGE_MIRROR}...")
|
|
vcpkg_download_distfile(ARCHIVE
|
|
URLS "${DOWNLOAD_URL}"
|
|
SKIP_SHA512
|
|
FILENAME "${_vdus_FILENAME}"
|
|
SILENT_EXIT
|
|
)
|
|
|
|
if (EXISTS ${ARCHIVE})
|
|
set(download_success 1)
|
|
check_file_content()
|
|
if (download_success)
|
|
check_file_sha512()
|
|
else()
|
|
message(STATUS "Mirror ${SOURCEFORGE_MIRROR} is in Disaster Recovery mode, trying other mirrors...")
|
|
endif()
|
|
break()
|
|
endif()
|
|
endforeach()
|
|
endif()
|
|
|
|
if (NOT download_success)
|
|
message(FATAL_ERROR [[
|
|
Couldn't download source from any of the sourceforge mirrors, please check your network.
|
|
If you use a proxy, please set the HTTPS_PROXY and HTTP_PROXY environment
|
|
variables to "http[s]://user:password@your-proxy-ip-address:port/".
|
|
Otherwise, please submit an issue at https://github.com/Microsoft/vcpkg/issues
|
|
]])
|
|
endif()
|
|
|
|
vcpkg_extract_source_archive_ex(
|
|
OUT_SOURCE_PATH SOURCE_PATH
|
|
ARCHIVE "${ARCHIVE}"
|
|
REF "${SANITIZED_REF}"
|
|
${NO_REMOVE_ONE_LEVEL}
|
|
${WORKING_DIRECTORY}
|
|
PATCHES ${_vdus_PATCHES}
|
|
)
|
|
|
|
set(${_vdus_OUT_SOURCE_PATH} "${SOURCE_PATH}" PARENT_SCOPE)
|
|
endfunction()
|