Cache Gutenberg XCFramework downloads on disk

Makefile

@@ -0,0 +1,7 @@
+.PHONY: help dependencies
+
+help: ## Show available targets
+	@grep -E '^[a-zA-Z_-]+:.*##' $(MAKEFILE_LIST) | awk -F ':.*## ' '{printf "  %-20s %s\n", $$1, $$2}'
+
+dependencies: ## Download and cache Gutenberg XCFrameworks
+	./Scripts/download-gutenberg-xcframeworks.sh

Rakefile

@@ -6,15 +6,10 @@ require 'tmpdir'
 require 'rake/clean'
 require 'yaml'
 require 'digest'
-require 'open-uri'
-require 'rubygems/package'
-require 'zlib'
 
 RUBY_REPO_VERSION = File.read('./.ruby-version').rstrip
 XCODE_WORKSPACE = 'WordPress.xcworkspace'
 EXPECTED_XCODE_VERSION = File.read('.xcode-version').rstrip
-GUTENBERG_VERSION = 'v1.121.0'
-
 PROJECT_DIR = __dir__
 abort('Project directory contains one or more spaces – unable to continue.') if PROJECT_DIR.include?(' ')
 
@@ -101,53 +96,7 @@ bundle exec fastlane run configure_apply force:true
 
   desc 'Download and extract Gutenberg xcframeworks'
   task :gutenberg_xcframeworks do
-    puts 'Setting up Gutenberg xcframeworks...'
-
-    frameworks_dir = 'WordPress/Frameworks'
-
-    # Clean the slate
-    FileUtils.rm_rf(frameworks_dir)
-    FileUtils.mkdir_p(frameworks_dir)
-
-    gutenberg_tar_gz_download_path = "#{frameworks_dir}/Gutenberg.tar.gz"
-
-    URI.open("https://cdn.a8c-ci.services/gutenberg-mobile/Gutenberg-#{GUTENBERG_VERSION}.tar.gz") do |remote_file|
-      File.binwrite(gutenberg_tar_gz_download_path, remote_file.read)
-    end
-
-    # Extract the archive
-    Zlib::GzipReader.open(gutenberg_tar_gz_download_path) do |gz|
-      Gem::Package::TarReader.new(gz) do |tar|
-        tar.each do |entry|
-          next unless entry.file?
-
-          dest_path = File.join(frameworks_dir, entry.full_name)
-          FileUtils.mkdir_p(File.dirname(dest_path))
-
-          File.binwrite(dest_path, entry.read)
-        end
-      end
-    end
-
-    # Move xcframeworks to the correct location
-    Dir.glob("#{frameworks_dir}/Frameworks/*.xcframework").each do |framework|
-      FileUtils.mv(framework, frameworks_dir, force: false)
-    end
-
-    # Create dSYMs directories
-    FileUtils.mkdir_p [
-      "#{frameworks_dir}/hermes.xcframework/ios-arm64/dSYMs",
-      "#{frameworks_dir}/hermes.xcframework/ios-arm64_x86_64-simulator/dSYMs"
-    ]
-
-    # Cleanup
-    FileUtils.rm_rf [
-      gutenberg_tar_gz_download_path,
-      "#{frameworks_dir}/Frameworks",
-      "#{frameworks_dir}/dummy.txt"
-    ]
-
-    puts 'Gutenberg xcframeworks setup complete'
+    sh("#{PROJECT_DIR}/Scripts/download-gutenberg-xcframeworks.sh")
   end
 end
 

Scripts/download-gutenberg-xcframeworks.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+# Downloads and installs Gutenberg XCFrameworks with progress and on-disk caching.
+#
+# Usage: download-gutenberg-xcframeworks.sh [frameworks_dir]
+#   frameworks_dir defaults to WordPress/Frameworks
+
+VERSION="v1.121.0"
+FRAMEWORKS_DIR="${1:-WordPress/Frameworks}"
+
+CACHE_DIR="${HOME}/Library/Caches/WordPress-iOS/Gutenberg/${VERSION}"
+DOWNLOAD_URL="https://cdn.a8c-ci.services/gutenberg-mobile/Gutenberg-${VERSION}.tar.gz"
+
+# Download and extract into the cache if this version isn't cached yet.
+if [[ -d "${CACHE_DIR}" ]]; then
+    echo "Using cached Gutenberg ${VERSION}"
+else
+    echo "Downloading Gutenberg ${VERSION}..."
+
+    # Extract into a temp directory first so a partial download doesn't
+    # leave a corrupt cache that persists across runs.
+    mkdir -p "$(dirname "${CACHE_DIR}")"
+    TEMP_DIR="$(mktemp -d "${CACHE_DIR}.XXXXXX")"
+    trap 'rm -rf "${TEMP_DIR}"' EXIT
+
+    curl --fail --location --progress-bar "${DOWNLOAD_URL}" \
+        | tar xzf - -C "${TEMP_DIR}"
+
+    # Move contents up from the nested Frameworks/ directory.
+    if [[ -d "${TEMP_DIR}/Frameworks" ]]; then
+        mv "${TEMP_DIR}"/Frameworks/* "${TEMP_DIR}/"
+        rm -rf "${TEMP_DIR}/Frameworks"
+    fi
+
+    # Create dSYMs directories that Xcode expects for hermes.
+    mkdir -p \
+        "${TEMP_DIR}/hermes.xcframework/ios-arm64/dSYMs" \
+        "${TEMP_DIR}/hermes.xcframework/ios-arm64_x86_64-simulator/dSYMs"
+
+    # Clean up leftover files from the archive.
+    rm -f "${TEMP_DIR}/dummy.txt"
+
+    # Atomically promote the temp directory to the final cache path.
+    mv "${TEMP_DIR}" "${CACHE_DIR}"
+    trap - EXIT
+fi
+
+# Copy cached contents into the project.
+if [[ -z "${FRAMEWORKS_DIR}" || "${FRAMEWORKS_DIR}" == "/" ]]; then
+    echo "Error: invalid frameworks directory: '${FRAMEWORKS_DIR}'" >&2
+    exit 1
+fi
+cp -a "${CACHE_DIR}" "${FRAMEWORKS_DIR}"
+
+echo "Gutenberg ${VERSION} setup complete."