[vcpkg] Add experimental $X_VCPKG_ASSET_SOURCES for source caching (#13639)

* [vcpkg] Add experimental $VCPKG_X_READWRITE_MIRROR_URL_TEMPLATE for source caching

* [vcpkg] Use prerelease version for testing

* [docs] Add assetcaching.md

* Revert bootstrap changes

* [vcpkg_download_distfile] Deprecate SILENT_EXIT

* cmake_parse_arguments() always defines option arguments

* Adjust CI baseline

* [vcpkg_download_distfile] Address CR comments, restore ARIA2

* [CI] Add source caching to Linux and OSX CI passes

* [ci.baseline.txt] Skip chartdir on more platforms

2 files changed, 59 insertions, 105 deletions

diff --git a/scripts/cmake/vcpkg_download_distfile.cmake b/scripts/cmake/vcpkg_download_distfile.cmake
index 2e72726b6..5af4345ba 100644
--- a/scripts/cmake/vcpkg_download_distfile.cmake
+++ b/scripts/cmake/vcpkg_download_distfile.cmake
@@ -67,7 +67,12 @@ function(vcpkg_download_distfile VAR)
     if(NOT DEFINED vcpkg_download_distfile_FILENAME)
         message(FATAL_ERROR "vcpkg_download_distfile requires a FILENAME argument.")
     endif()
-    if(NOT _VCPKG_INTERNAL_NO_HASH_CHECK)
+    if(vcpkg_download_distfile_SILENT_EXIT)
+        message(WARNING "SILENT_EXIT has been deprecated as an argument to vcpkg_download_distfile -- remove the argument to resolve this warning")
+    endif()
+    if(_VCPKG_INTERNAL_NO_HASH_CHECK)
+        set(vcpkg_download_distfile_SKIP_SHA512 1)
+    else()
         if(NOT vcpkg_download_distfile_SKIP_SHA512 AND NOT DEFINED vcpkg_download_distfile_SHA512)
             message(FATAL_ERROR "vcpkg_download_distfile requires a SHA512 argument. If you do not know the SHA512, add it as 'SHA512 0' and re-run this command.")
         endif()
@@ -113,7 +118,7 @@ function(vcpkg_download_distfile VAR)
 
     if(EXISTS "${downloaded_file_path}")
         if(NOT vcpkg_download_distfile_QUIET)
-            message(STATUS "Using cached ${downloaded_file_path}")
+            message(STATUS "Using ${downloaded_file_path}")
         endif()
         test_hash("${downloaded_file_path}" "cached file" "Please delete the file and retry if this file should be downloaded again.")
     else()
@@ -127,7 +132,7 @@ function(vcpkg_download_distfile VAR)
             vcpkg_find_acquire_program("ARIA2")
             message(STATUS "Downloading ${vcpkg_download_distfile_FILENAME}...")
             if(vcpkg_download_distfile_HEADERS)
-                foreach(header ${vcpkg_download_distfile_HEADERS})
+                foreach(header IN LISTS vcpkg_download_distfile_HEADERS)
                     list(APPEND request_headers "--header=${header}")
                 endforeach()
             endif()
@@ -159,29 +164,60 @@ function(vcpkg_download_distfile VAR)
                 )
                 set(download_success 1)
             endif()
-        else()
+        elseif(vcpkg_download_distfile_SKIP_SHA512)
+            set(download_success 0)
+            set(request_headers)
+            if(vcpkg_download_distfile_HEADERS)
+                foreach(header IN LISTS vcpkg_download_distfile_HEADERS)
+                    list(APPEND request_headers HTTPHEADER ${header})
+                endforeach()
+            endif()
             foreach(url IN LISTS vcpkg_download_distfile_URLS)
                 message(STATUS "Downloading ${url} -> ${vcpkg_download_distfile_FILENAME}...")
-                if(vcpkg_download_distfile_HEADERS)
-                    foreach(header ${vcpkg_download_distfile_HEADERS})
-                        list(APPEND request_headers HTTPHEADER ${header})
-                    endforeach()
-                endif()
                 file(DOWNLOAD "${url}" "${download_file_path_part}" STATUS download_status ${request_headers})
                 list(GET download_status 0 status_code)
                 if (NOT "${status_code}" STREQUAL "0")
                     message(STATUS "Downloading ${url}... Failed. Status: ${download_status}")
-                    set(download_success 0)
                 else()
+                    test_hash("${download_file_path_part}" "downloaded file" "The file may have been corrupted in transit. This can be caused by proxies. If you use a proxy, please set the HTTPS_PROXY and HTTP_PROXY environment variables to \"https://user:password@your-proxy-ip-address:port/\".\n")
+                    get_filename_component(downloaded_file_dir "${downloaded_file_path}" DIRECTORY)
+                    file(MAKE_DIRECTORY "${downloaded_file_dir}")
+                    file(RENAME ${download_file_path_part} ${downloaded_file_path})
                     set(download_success 1)
                     break()
                 endif()
             endforeach(url)
+        else()
+            set(urls)
+            foreach(url IN LISTS vcpkg_download_distfile_URLS)
+                list(APPEND urls "--url=${url}")
+            endforeach()
+            if(NOT vcpkg_download_distfile_QUIET)
+                message(STATUS "Downloading ${vcpkg_download_distfile_URLS} -> ${vcpkg_download_distfile_FILENAME}...")
+            endif()
+            set(request_headers)
+            if(vcpkg_download_distfile_HEADERS)
+                foreach(header IN LISTS vcpkg_download_distfile_HEADERS)
+                    list(APPEND request_headers "--header=${header}")
+                endforeach()
+            endif()
+            vcpkg_execute_in_download_mode(
+                COMMAND "$ENV{VCPKG_COMMAND}" x-download "${downloaded_file_path}" "${vcpkg_download_distfile_SHA512}" ${urls} ${request_headers} --debug
+                OUTPUT_VARIABLE output
+                ERROR_VARIABLE output
+                RESULT_VARIABLE failure
+                WORKING_DIRECTORY "${DOWNLOADS}"
+            )
+            if(failure)
+                message("${output}")
+                set(download_success 0)
+            else()
+                set(download_success 1)
+            endif()
         endif()
 
-        if (NOT vcpkg_download_distfile_SILENT_EXIT)
-            if (NOT download_success)
-                message(FATAL_ERROR
+        if(NOT download_success)
+            message(FATAL_ERROR
                 "    \n"
                 "    Failed to download file.\n"  
                 "    If you use a proxy, please check your proxy setting. Possible causes are:\n"
@@ -205,23 +241,6 @@ function(vcpkg_download_distfile VAR)
                 "    and (https://github.com/microsoft/vcpkg-tool/pull/77)\n"
                 "    \n"
                 "    Otherwise, please submit an issue at https://github.com/Microsoft/vcpkg/issues\n")
-            else()
-                test_hash("${download_file_path_part}" "downloaded file" "The file may have been corrupted in transit. This can be caused by proxies. If you use a proxy, please set the HTTPS_PROXY and HTTP_PROXY environment variables to \"https://user:password@your-proxy-ip-address:port/\".\n")
-                get_filename_component(downloaded_file_dir "${downloaded_file_path}" DIRECTORY)
-                file(MAKE_DIRECTORY "${downloaded_file_dir}")
-                file(RENAME ${download_file_path_part} ${downloaded_file_path})
-            endif()
-        else()
-            if (NOT download_success)
-                message(WARNING
-                "    \n"
-                "    Failed to download file.\n")
-            else()
-                test_hash("${download_file_path_part}" "downloaded file" "The file may have been corrupted in transit. This can be caused by proxies. If you use a proxy, please set the HTTPS_PROXY and HTTP_PROXY environment variables to \"https://user:password@your-proxy-ip-address:port/\".\n")
-                get_filename_component(downloaded_file_dir "${downloaded_file_path}" DIRECTORY)
-                file(MAKE_DIRECTORY "${downloaded_file_dir}")
-                file(RENAME ${download_file_path_part} ${downloaded_file_path})
-            endif()
         endif()
     endif()
     set(${VAR} ${downloaded_file_path} PARENT_SCOPE)
diff --git a/scripts/cmake/vcpkg_from_sourceforge.cmake b/scripts/cmake/vcpkg_from_sourceforge.cmake
index 82286b346..de0e6c509 100644
--- a/scripts/cmake/vcpkg_from_sourceforge.cmake
+++ b/scripts/cmake/vcpkg_from_sourceforge.cmake
@@ -67,34 +67,6 @@ Specifies that the default removal of the top level folder should not occur.
 #]===]
 
 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)
@@ -154,7 +126,8 @@ function(vcpkg_from_sourceforge)
 
     string(SUBSTRING "${_vdus_SHA512}" 0 10 SANITIZED_REF)
 
-    list(APPEND SOURCEFORGE_MIRRORS
+    set(Z_VCPKG_SOURCEFORGE_MIRRORS ${SOURCEFORGE_MIRRORS})
+    list(APPEND Z_VCPKG_SOURCEFORGE_MIRRORS
         cfhcable        # United States
         pilotfiber      # New York, NY
         gigenet         # Chicago, IL
@@ -176,56 +149,18 @@ function(vcpkg_from_sourceforge)
         ufpr            # Curitiba, Brazil
         tenet           # Wynberg, South Africa
     )
-    
-    # Try to use auto-select first
-    set(DOWNLOAD_URL ${URL}/download)
-    message(STATUS "Trying auto-select mirror...")
+
+    set(URLS "${URL}/download")
+    foreach(SOURCEFORGE_MIRROR IN LISTS Z_VCPKG_SOURCEFORGE_MIRRORS)
+        list(APPEND URLS "${URL}/download?use_mirror=${SOURCEFORGE_MIRROR}")
+    endforeach()
+
     vcpkg_download_distfile(ARCHIVE
-        URLS "${DOWNLOAD_URL}"
-        SKIP_SHA512
+        URLS ${URLS}
+        SHA512 "${_vdus_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}"