Cache Gutenberg XCFramework downloads on disk

[jkmassel]

Summary

We're not quite done with Gutenberg Mobile yet, and we'll still have Aztec around for the foreseeable future. Using worktrees, it's annoying having to redownload 160MB every time, so I wanted to improve the situation.

This PR moves the logic to Bash to make it pretty much dependency-free, but for folks with rake muscle memory everything still works properly.

• Replace Ruby download/extract logic in Rakefile with a bash script (Scripts/download-gutenberg-xcframeworks.sh) that uses curl --progress-bar for visible download feedback
• Cache extracted XCFrameworks in ~/Library/Caches/WordPress-iOS/Gutenberg/<version>/ so subsequent runs just cp -a from cache instead of re-downloading
• Add a Makefile with a dependencies target as a lightweight alternative to rake dependencies:gutenberg_xcframeworks
• Remove now-unused open-uri, rubygems/package, and zlib requires from Rakefile

Test plan

• rm -rf WordPress/Frameworks ~/Library/Caches/WordPress-iOS/Gutenberg then bundle exec rake dependencies:gutenberg_xcframeworks — should download with progress and complete successfully
• Run the same rake task again — should print "Using cached" and skip the download
• rm -rf WordPress/Frameworks then make dependencies — should restore frameworks from cache without downloading
• Verify the app builds after running the script

🤖 Generated with Claude Code

[wpmobilebot]

🤖 Build Failure Analysis

This build has failures. Claude has analyzed them - check the build annotations for details.

[wpmobilebot]

📲 You can test the changes from this Pull Request in Jetpack by scanning the QR code below to install the corresponding build.

	App Name	Jetpack
	Configuration	Release-Alpha
	Build Number	31373
	Version	PR #25352
	Bundle ID	com.jetpack.alpha
	Commit	8b12843
	Installation URL	6eggpdtd3s3t0

Automatticians: You can use our internal self-serve MC tool to give yourself access to those builds if needed.

[wpmobilebot]

📲 You can test the changes from this Pull Request in WordPress by scanning the QR code below to install the corresponding build.

	App Name	WordPress
	Configuration	Release-Alpha
	Build Number	31373
	Version	PR #25352
	Bundle ID	org.wordpress.alpha
	Commit	8b12843
	Installation URL	22uedglfba7b8

Automatticians: You can use our internal self-serve MC tool to give yourself access to those builds if needed.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[dcalhoun]

Script looks good and tested well for me. I also smoke tested the Gutenberg mobile editor. My comments suggestions, nothing more. Merge when ready. 🚀

[dcalhoun]

We might add a default help target to improve discoverability.

diff --git a/Makefile b/Makefile
index ec8f8b3bec..3539ae12d1 100644
--- a/Makefile
+++ b/Makefile
@@ -1,4 +1,7 @@
-.PHONY: dependencies
+.PHONY: help dependencies
 
-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

[dcalhoun]

The likelihood of someone mistakenly passing / as an argument feels quite low, but given the severe repercussions of doing so, it may be worth guarding as Claude suggested. 😅

Suggested change

	rm -rf "${FRAMEWORKS_DIR}"
	if [[ -z "${FRAMEWORKS_DIR}" || "${FRAMEWORKS_DIR}" == "/" ]]; then
	echo "Error: invalid frameworks directory: '${FRAMEWORKS_DIR}'" >&2
	exit 1
	fi

[dcalhoun]

TIL about trap. Cool!

[mokagio]

Nitpick: Apps Infra recently started moving toward a more portable shebang

Suggested change

	#!/bin/bash
	set -euo pipefail
	#!/usr/bin/env bash
	set -euo pipefail

[mokagio]

What do you think of making the version an input with fallback, too?

[mokagio]

Actually... maybe we would be better served by extracting the version in a dedicated file? It's currently duplicated.

➜ g grep v1.121.0
Rakefile:GUTENBERG_VERSION = 'v1.121.0'
fastlane/lanes/localization.rb:GUTENBERG_TAG = 'v1.121.0'

[mokagio]

Nitpick.

I love that this is can be changed at call time. Nice UX. But neither rake nor make leverages this capability.

Did you consider exposing it? If not, is there value in having it configurable here?

FWIW, I think this is not an issue and we shouldn't get distracted with exposing the config. But maybe there's a good use case for it that I'm not aware of, so I thought I'd call it out.