react-native-tvos 0.87.1-1 → 0.88.0-0rc2

package/scripts/spm/spm-types.js

@@ -9,6 +9,7 @@
  */
 
 /*::
+import type {SwiftpmNameOutcome} from './swiftpm-config';
 export type SetupArgs = {
   action: 'add' | 'update' | 'deinit' | 'sync' | 'codegen' | 'download' | 'scaffold' | null,
   version: string | null,
@@ -66,6 +67,8 @@ export type AutolinkingArgs = {
   autolinkingJson: string | null,
   output: string | null,
   xcframeworksPath: string | null,
+  // Platform floor of every manifest this run writes; sanitized by parseArgs.
+  iosDeploymentTarget: string,
 };
 
 export type SpmTarget = {
@@ -143,13 +146,19 @@ export type AutolinkedDep = {
   name: string,
   root: string,
   platforms: {ios: AutolinkingIosPlatform, ...},
-  // Resolved Swift target / module / headers-subdir name. Defaults to
-  // toSwiftName(name) and is overridden by the dep's react-native.config.js
-  // `spm.name`. Populated by expandSpmDependencies — always present after
-  // expansion; optional in the type so caller-side construction stays simple.
+  // Resolved Swift target / module / headers-subdir name — the name the library
+  // declares in `swiftpmConfig`, else its podspec's (see resolveSwiftName).
+  // Populated by expandSpmDependencies — always present after expansion;
+  // optional in the type so caller-side construction stays simple.
   swiftName?: string,
-  // Populated by expandSpmDependencies from each dep's
-  // react-native.config.js `spm.dependencies` array.
+  // Where swiftName came from. Only a podspec-derived name is safe for the
+  // scaffolder to record in the library's package.json.
+  swiftNameSource?: 'config' | 'podspec' | 'npm',
+  // Which podspec field named it ('podspec' source only), so `spm scaffold` can
+  // report the choice it made between `header_dir` and `module_name`.
+  swiftNamePodspecKey?: 'header_dir' | 'module_name' | 'name',
+  // Populated by expandSpmDependencies from each dep's declared
+  // `dependencies` array.
   spmDependencies?: Array<string>,
   ...
 };
@@ -199,6 +208,7 @@ export type AggregatorInput = {
   // the aggregator's package deps + the AutolinkedAggregate target deps.
   pluginPackageDeps?: ReadonlyArray<PluginPackageDep>,
   pluginProductDeps?: ReadonlyArray<PluginProductDep>,
+  iosDeploymentTarget?: ?string,
 };
 
 // --- Autolinking plugins (PREVIEW / unstable contract) ---
@@ -370,6 +380,7 @@ export type SynthPackageSpec = {
   // `<react/renderer/components/safeareacontext/X.h>` resolve through the
   // dep's own `common/cpp/` subtree.
   headerSearchPaths?: ?Array<string>,
+  iosDeploymentTarget?: ?string,
 };
 
 
@@ -422,6 +433,10 @@ export type PodspecModel = {
   // physical source tree (SPM has no header_mappings_dir copy step).
   headerMappingsDirs: Array<string>,
   headerDir: ?string,
+  // What CocoaPods compiles the module as, and so what Swift and `@import`
+  // consumers spell (`s.module_name`). Defaults to the pod name in CocoaPods;
+  // null here when the podspec does not declare it.
+  moduleName: ?string,
   frameworks: Array<string>,
   weakFrameworks: Array<string>,
   libraries: Array<string>,
@@ -462,8 +477,7 @@ export type PodspecModel = {
 // Decouples podspec reading from SPM-specific shaping so each side can be
 // tested in isolation.
 export type SpmScaffoldSpec = {
-  // Swift target / module name. Default: toSwiftName(podspec.name); overridden
-  // by `header_dir` when present.
+  // Swift target / module name, as resolved by expandSpmDependencies.
   swiftName: string,
   // Source file paths relative to the dep root, ready for `sources: [...]`
   // emission after the `root/` wrapper-dir prefix is applied at emit time.
@@ -522,6 +536,9 @@ export type ScaffoldResult =
       // changed, --force, etc.); false on first-time scaffolds. The CLI
       // orchestrator prompts only for first-time scaffolds.
       previouslyExisted: boolean,
+      // What became of `swiftpmConfig.name` in the library's package.json.
+      // Absent when the name was not podspec-derived, so nothing was attempted.
+      swiftpmName?: SwiftpmNameOutcome,
     }
   | {
       depName: string,

package/scripts/spm/spm-utils.js

@@ -10,9 +10,9 @@
 
 'use strict';
 
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
 
 // The package and product names React Native's own generated manifests use. A
 // dependency whose Swift name lands on one of them surfaces as a duplicate-name
@@ -171,6 +171,29 @@ function toSwiftName(name /*: string */) /*: string */ {
     .join('');
 }
 
+// The charset a declared SwiftPM name must satisfy — permissive on purpose,
+// since it has to admit header-dir style (lowercase with hyphens) as well as
+// Swift identifiers.
+function isValidSwiftName(name /*: unknown */) /*: boolean */ {
+  return typeof name === 'string' && /^[A-Za-z_][A-Za-z0-9_-]*$/.test(name);
+}
+
+/**
+ * SwiftPM's `c99name` — the identifier a target's module is compiled under,
+ * with every character C99 rejects replaced by `_`. `react-native-svg` and
+ * `react_native_svg` share one, so they cannot both be targets.
+ */
+function toC99Name(name /*: string */) /*: string */ {
+  const mangled = name.replace(/[^A-Za-z0-9_]/g, '_');
+  return /^[0-9]/.test(mangled) ? `_${mangled}` : mangled;
+}
+
+// Collision key for a Swift target name: two names that share one collide, as a
+// module (punctuation) or as a headers directory (case).
+function swiftNameKey(name /*: string */) /*: string */ {
+  return toC99Name(name).toLowerCase();
+}
+
 /**
  * Derive a default app name from the raw package name and source path.
  * Prefers the source directory name when it's meaningful (e.g. "RNTester"),
@@ -671,7 +694,7 @@ function runCodegenAndInstallTemplate(
     return;
   }
   logger.log('Running codegen...');
-  const {execSync} = require('child_process');
+  const {execSync} = require('node:child_process');
   const codegenArgs =
     `node "${codegenScript}" -p "${projectRoot}" -t ios` +
     (projectRoot !== appRoot ? ` -o "${appRoot}"` : '');
@@ -743,6 +766,9 @@ module.exports = {
   sharedCacheDir,
   defaultCacheDir,
   toSwiftName,
+  toC99Name,
+  swiftNameKey,
+  isValidSwiftName,
   deriveAppName,
   readPackageJson,
   findProjectRoot,

package/scripts/spm/swiftpm-config.js

@@ -0,0 +1,245 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict-local
+ * @format
+ */
+
+'use strict';
+
+const {isValidSwiftName, makeLogger} = require('./spm-utils');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const {log, warn} = makeLogger('swiftpm-config');
+
+/**
+ * swiftpm-config.js — one reader for a package's SwiftPM settings.
+ *
+ * They live in `swiftpmConfig` in the package's package.json:
+ *
+ *   { "swiftpmConfig": { "name": "RNSVG" } }
+ *
+ * A library owns `name`, `dependencies`, `autolinkingPlugin` and `scaffold`;
+ * an app owns `modules` and `denyPlugins`. The `spm` block in
+ * react-native.config.js is the deprecated spelling of the same fields — still
+ * read so nothing breaks mid-migration, but package.json wins field by field.
+ */
+
+/*::
+export type SwiftpmNameOutcome =
+  | 'created'
+  | 'inserted'
+  | 'already-set'
+  | 'skipped'
+  | 'failed';
+// User-authored, so values stay unknown and are validated where consumed.
+export type SwiftpmConfig = {
+  readonly name?: unknown,
+  readonly dependencies?: unknown,
+  readonly autolinkingPlugin?: unknown,
+  readonly scaffold?: unknown,
+  readonly modules?: unknown,
+  readonly denyPlugins?: unknown,
+  ...
+};
+type RnConfig = {...};
+*/
+
+const SWIFTPM_FIELDS /*: ReadonlyArray<string> */ = [
+  'name',
+  'dependencies',
+  'autolinkingPlugin',
+  'scaffold',
+  'modules',
+  'denyPlugins',
+];
+
+// Config file paths already warned about, by kind of warning.
+const deprecationsReported /*: Set<string> */ = new Set();
+const unknownKeysReported /*: Set<string> */ = new Set();
+
+function readPackageJson(
+  root /*: string */,
+) /*: ?{readonly [string]: unknown} */ {
+  const pkgPath = path.join(root, 'package.json');
+  if (!fs.existsSync(pkgPath)) {
+    return null;
+  }
+  try {
+    const parsed = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+    return parsed != null && typeof parsed === 'object' ? parsed : null;
+  } catch (e) {
+    warn(
+      `Failed to read ${pkgPath}: ${e.message}. 'swiftpmConfig' is ignored.`,
+    );
+    return null;
+  }
+}
+
+// A settings object, or null for anything else the author may have written
+// there — an array included, since its indices are not fields.
+function objectField(
+  source /*: ?{readonly [string]: unknown} */,
+  key /*: string */,
+) /*: ?SwiftpmConfig */ {
+  const value = source?.[key];
+  return value != null && typeof value === 'object' && !Array.isArray(value)
+    ? value
+    : null;
+}
+
+function declaredFields(
+  config /*: ?{readonly [string]: unknown} */,
+) /*: Array<string> */ {
+  return config == null
+    ? []
+    : SWIFTPM_FIELDS.filter(field => config[field] !== undefined);
+}
+
+function stringList(value /*: unknown */) /*: Array<string> */ {
+  return Array.isArray(value) ? value.filter(v => typeof v === 'string') : [];
+}
+
+function reportDeprecation(
+  root /*: string */,
+  fields /*: Array<string> */,
+) /*: void */ {
+  const configPath = path.join(root, 'react-native.config.js');
+  if (deprecationsReported.has(configPath)) {
+    return;
+  }
+  deprecationsReported.add(configPath);
+  warn(
+    `${configPath} declares SwiftPM settings in the deprecated 'spm' block (${fields.join(', ')}). ` +
+      `Move them to 'swiftpmConfig' in the package's package.json — the 'spm' block still works, but will stop being read.`,
+  );
+}
+
+// A misspelled field would otherwise do nothing at all. Unknown keys are only
+// reported, never rejected: a library may declare a field a newer React Native
+// knows and this one does not.
+function reportUnknownKeys(
+  root /*: string */,
+  config /*: SwiftpmConfig */,
+) /*: void */ {
+  const pkgPath = path.join(root, 'package.json');
+  const unknown = Object.keys(config).filter(
+    key => !SWIFTPM_FIELDS.includes(key),
+  );
+  if (unknown.length === 0 || unknownKeysReported.has(pkgPath)) {
+    return;
+  }
+  unknownKeysReported.add(pkgPath);
+  warn(
+    `${pkgPath} declares 'swiftpmConfig' fields React Native does not know (${unknown.join(', ')}). ` +
+      `They are ignored — check the spelling against ${SWIFTPM_FIELDS.join(', ')}.`,
+  );
+}
+
+/**
+ * The SwiftPM settings that apply to the package at `root`: `swiftpmConfig`
+ * from its package.json over the deprecated `spm` block of its already-loaded
+ * react-native.config.js. Null when the package declares neither.
+ */
+function readSwiftpmConfig(
+  root /*: string */,
+  rnConfig /*: ?RnConfig */,
+) /*: ?SwiftpmConfig */ {
+  const fromPackageJson = objectField(readPackageJson(root), 'swiftpmConfig');
+  if (fromPackageJson != null) {
+    reportUnknownKeys(root, fromPackageJson);
+  }
+  const deprecated = objectField(rnConfig, 'spm');
+  const deprecatedFields = declaredFields(deprecated);
+  if (deprecatedFields.length > 0) {
+    reportDeprecation(root, deprecatedFields);
+  }
+  if (fromPackageJson == null) {
+    return deprecatedFields.length > 0 ? deprecated : null;
+  }
+  return {...deprecated, ...fromPackageJson};
+}
+
+// The file's own indentation, so writing a field back does not reformat it.
+function detectIndent(source /*: string */) /*: string */ {
+  return /\n([ \t]+)"/.exec(source)?.[1] ?? '  ';
+}
+
+/**
+ * Records `swiftName` as `swiftpmConfig.name` in the package's package.json —
+ * the scaffolder's migration step, which is what lets a library stop deriving
+ * its SwiftPM name from a podspec. A name the author already chose is never
+ * overwritten.
+ */
+function writeSwiftpmName(
+  root /*: string */,
+  swiftName /*: string */,
+  options /*:: ?: {dryRun?: boolean} */,
+) /*: SwiftpmNameOutcome */ {
+  if (!isValidSwiftName(swiftName)) {
+    return 'skipped';
+  }
+  const pkgPath = path.join(root, 'package.json');
+  let source;
+  let pkg;
+  try {
+    source = fs.readFileSync(pkgPath, 'utf8');
+    pkg = JSON.parse(source);
+  } catch {
+    return 'skipped';
+  }
+  if (pkg == null || typeof pkg !== 'object') {
+    return 'skipped';
+  }
+  const existing = objectField(pkg, 'swiftpmConfig');
+  if (existing == null && pkg.swiftpmConfig !== undefined) {
+    warn(
+      `${pkgPath} has a 'swiftpmConfig' that is not an object; leaving it alone. ` +
+        `React Native resolved the name '${swiftName}' from the podspec.`,
+    );
+    return 'skipped';
+  }
+  const declaredName = existing?.name;
+  if (declaredName === swiftName) {
+    return 'already-set';
+  }
+  if (declaredName != null) {
+    warn(
+      `${pkgPath} already sets 'swiftpmConfig.name' to '${String(declaredName)}'; leaving it. ` +
+        `React Native resolved '${swiftName}' from the podspec — set them to the same value to silence this.`,
+    );
+    return 'skipped';
+  }
+  const outcome = existing == null ? 'created' : 'inserted';
+  pkg.swiftpmConfig = {...existing, name: swiftName};
+  if (options?.dryRun === true) {
+    log(`Would set 'swiftpmConfig.name' to '${swiftName}' in ${pkgPath}`);
+    return outcome;
+  }
+  const serialized = JSON.stringify(pkg, null, detectIndent(source));
+  const content = source.endsWith('\n') ? `${serialized}\n` : serialized;
+  // Staged and renamed, so an interrupted or out-of-space write cannot leave a
+  // third-party package.json truncated.
+  const tmpPath = `${pkgPath}.${process.pid}.tmp`;
+  try {
+    fs.writeFileSync(tmpPath, content, 'utf8');
+    fs.renameSync(tmpPath, pkgPath);
+  } catch (e) {
+    fs.rmSync(tmpPath, {force: true});
+    warn(
+      `Could not record 'swiftpmConfig.name' in ${pkgPath}: ${e.message}. The manifest is written; the name is not.`,
+    );
+    return 'failed';
+  }
+  return outcome;
+}
+
+module.exports = {
+  readSwiftpmConfig,
+  stringList,
+  writeSwiftpmName,
+};

package/scripts/spm/sync-spm-autolinking.js

@@ -47,8 +47,8 @@ const {
   makeLogger,
   runCodegenAndInstallTemplate,
 } = require('./spm-utils');
-const fs = require('fs');
-const path = require('path');
+const fs = require('node:fs');
+const path = require('node:path');
 const yargs = require('yargs');
 
 const {log} = makeLogger('sync-spm-autolinking');
@@ -82,6 +82,10 @@ async function main(
       demandOption: true,
       describe: 'Path to react-native package root',
     })
+    .option('ios-deployment-target', {
+      type: 'string',
+      describe: 'Platform floor forwarded to the autolinker',
+    })
     .help()
     .parseSync();
 
@@ -115,12 +119,17 @@ async function main(
   deps.installSpmCodegenTemplate(appRoot, reactNativeRoot, {log});
 
   log('Re-generating build/generated/autolinking/Package.swift...');
-  deps.generateAutolinking([
+  const autolinkingArgv = [
     '--app-root',
     appRoot,
     '--react-native-root',
     reactNativeRoot,
-  ]);
+  ];
+  const iosDeploymentTarget = parsed['ios-deployment-target'];
+  if (iosDeploymentTarget != null) {
+    autolinkingArgv.push('--ios-deployment-target', iosDeploymentTarget);
+  }
+  deps.generateAutolinking(autolinkingArgv);
 
   // Rebuild the per-app generated-headers farm (vended as the ReactAppHeaders
   // SPM target inside the codegen package). React core headers need no trees

package/scripts/xcode/asset-catalog.sh

@@ -0,0 +1,102 @@
+#!/bin/bash
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+# Bundles packager image assets into a compiled asset catalog (RNAssets.bundle)
+# inside the app, where the native image loader resolves them by name. Sourced
+# by react-native-xcode.sh.
+#
+# The feature is opt-in via the RCTUseAssetCatalog key in the app's Info.plist,
+# which is the same key the native image loader reads, so bundling and runtime
+# cannot disagree on where image assets live. The catalog is fully owned by
+# these functions (staged in derived files, compiled with actool into the app's
+# resources next to the js bundle), so the app's Xcode project needs no
+# changes. Apps that have not migrated are unaffected.
+#
+# After changing the RCTUseAssetCatalog key, do a clean build: incremental
+# builds do not remove image assets a previous build placed in the app with the
+# other setting (they are unused but add dead weight).
+
+# Prints the directory the bundler should emit image assets into (via
+# --asset-catalog-dest), or nothing if the app has not opted into the asset
+# catalog with the RCTUseAssetCatalog Info.plist key.
+asset_catalog_staging_dir() {
+  [[ "$BUNDLE_PLATFORM" == "ios" && -n "$PRODUCT_SETTINGS_PATH" ]] || return 0
+
+  local use_asset_catalog
+  use_asset_catalog="$(/usr/libexec/PlistBuddy -c 'Print :RCTUseAssetCatalog' "$PRODUCT_SETTINGS_PATH" 2>/dev/null || true)"
+  # Accept the value forms NSBundle's boolValue treats as true, so this check
+  # cannot disagree with the native runtime check.
+  case "$(echo "$use_asset_catalog" | tr '[:upper:]' '[:lower:]')" in
+    true | yes | 1) ;;
+    *) return 0 ;;
+  esac
+
+  local staging_dir="${DERIVED_FILE_DIR:-$(mktemp -d)}/rn-assets"
+  rm -rf "$staging_dir"
+  mkdir -p "$staging_dir/RNAssets.xcassets"
+  printf '%s\n' "$staging_dir"
+}
+
+# Compiles the staging catalog ($1, as returned by asset_catalog_staging_dir)
+# into RNAssets.bundle inside the app. The compiled Assets.car resolves the
+# right scale by name at runtime, see
+# https://developer.apple.com/documentation/xcode/managing-assets-with-asset-catalogs
+asset_catalog_compile() {
+  local staging_dir="$1"
+  local rn_assets_bundle="$DEST/RNAssets.bundle"
+  # Always remove first so a stale bundle from a previous build does not ship
+  # when the app opts out or has no image assets.
+  rm -rf "$rn_assets_bundle"
+  [[ -n "$staging_dir" ]] || return 0
+  if [[ -z "$(find "$staging_dir/RNAssets.xcassets" -maxdepth 1 -name '*.imageset' -print -quit)" ]]; then
+    return 0
+  fi
+
+  mkdir -p "$rn_assets_bundle"
+  local actool_args=("--platform" "${PLATFORM_NAME:-iphoneos}")
+  # These are always iOS-family image assets (this runs only for BUNDLE_PLATFORM
+  # "ios", which includes Mac Catalyst), so the deployment target must be an iOS
+  # version. On Catalyst the platform is macosx but MACOSX_DEPLOYMENT_TARGET is a
+  # macOS version (e.g. 10.15); passing that as the target makes actool silently
+  # emit loose files instead of a compiled Assets.car, so it must not be used.
+  actool_args+=("--minimum-deployment-target" "${IPHONEOS_DEPLOYMENT_TARGET:-15.1}")
+  case "${TARGETED_DEVICE_FAMILY:-1}" in *1*) actool_args+=("--target-device" "iphone") ;; esac
+  case "${TARGETED_DEVICE_FAMILY:-1}" in *2*) actool_args+=("--target-device" "ipad") ;; esac
+  if [[ "${IS_MACCATALYST:-NO}" == "YES" ]]; then
+    actool_args+=("--ui-framework-family" "uikit")
+  fi
+
+  # Surface actool diagnostics in the build log: without these flags actool
+  # suppresses them entirely, and it exits 0 even when it drops an imageset.
+  local actool_output
+  actool_output="$(xcrun actool "$staging_dir/RNAssets.xcassets" \
+    --compile "$rn_assets_bundle" \
+    --output-format human-readable-text \
+    --errors --warnings --notices \
+    "${actool_args[@]}" 2>&1)" || true
+  echo "$actool_output"
+  if [[ ! -f "$rn_assets_bundle/Assets.car" ]]; then
+    echo "error: failed to compile image assets into RNAssets.bundle. See actool output above." >&2
+    exit 2
+  fi
+
+  cat > "$rn_assets_bundle/Info.plist" <<'RN_ASSETS_PLIST'
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleIdentifier</key>
+  <string>org.reactjs.RNAssets</string>
+  <key>CFBundleInfoDictionaryVersion</key>
+  <string>6.0</string>
+  <key>CFBundleName</key>
+  <string>RNAssets</string>
+  <key>CFBundlePackageType</key>
+  <string>BNDL</string>
+</dict>
+</plist>
+RN_ASSETS_PLIST
+}

package/sdks/.hermesv1version

@@ -1 +1 @@
-hermes-v250829098.0.17
+hermes-v260318099.0.2

package/sdks/hermes-engine/hermes-engine.podspec

@@ -88,7 +88,7 @@ Pod::Spec.new do |spec|
     # We ignore this if we provide a specific tarball: the assumption here is that if you are providing a tarball, is because you want to
     # test something specific for that tarball.
     if source_type == HermesEngineSourceType::DOWNLOAD_PREBUILD_RELEASE_TARBALL
-      spec.script_phase = {
+      script_phase = {
         :name => "[Hermes] Replace Hermes for the right configuration, if needed",
         :execution_position => :before_compile,
         :script => <<-EOS
@@ -102,6 +102,15 @@ Pod::Spec.new do |spec|
         "$NODE_BINARY" "$REACT_NATIVE_PATH/sdks/hermes-engine/utils/replace_hermes_version.js" -c "$CONFIG" -r "#{version}" -p "$PODS_ROOT"
         EOS
       }
+
+
+      # :always_out_of_date is only available in CocoaPods 1.13.0 and later
+      if Gem::Version.new(Pod::VERSION) >= Gem::Version.new('1.13.0')
+        # always run the script without warning
+        script_phase[:always_out_of_date] = "1"
+      end
+
+      spec.script_phase = script_phase
     end
 
   elsif HermesEngineSourceType::isFromSource(source_type) then

package/sdks/hermes-engine/hermes-utils.rb

@@ -8,6 +8,16 @@ require 'digest'
 
 HERMES_GITHUB_URL = "https://github.com/facebook/hermes.git"
 ENV_BUILD_FROM_SOURCE = "RCT_BUILD_HERMES_FROM_SOURCE"
+MAVEN_CENTRAL_REPOSITORY = "https://repo1.maven.org/maven2"
+REACT_NATIVE_MAVEN_MIRROR_REPOSITORY = "https://repo.reactnative.dev/maven2"
+
+# Memoized results of requests to the Maven repositories (mirror or central).
+# hermes-engine.podspec is evaluated several times during a single
+# `pod install`, and every evaluation re-resolves the artifact source from
+# scratch; without memoization that re-issues identical artifact existence
+# probes. The answers should not change within one install, so each request
+# is issued at most once per process.
+HERMES_ARTIFACT_EXISTS_CACHE = {}
 
 module HermesEngineSourceType
     LOCAL_PREBUILT_TARBALL = :local_prebuilt_tarball
@@ -94,7 +104,7 @@ def force_build_from_stable_branch(react_native_path)
 end
 
 def release_artifact_exists(version)
-    return hermes_artifact_exists(release_tarball_url(version, :debug))
+    return release_tarball_urls(version, :debug).any? { |url| hermes_artifact_exists(url) }
 end
 
 # Computes the core release version on which this TV release version is based
@@ -201,17 +211,41 @@ def hermestag_file(react_native_path)
 end
 
 def release_tarball_url(version, build_type)
+    candidates = release_tarball_urls(version, build_type)
+    return candidates.find { |url| hermes_artifact_exists(url) } || candidates.first
+end
+
+def release_tarball_urls(version, build_type)
+    namespace = "com/facebook/hermes"
+    return maven_repository_urls().map { |maven_repo_url|
+        # Sample url from Maven:
+        # https://repo1.maven.org/maven2/com/facebook/hermes/hermes-ios/0.14.0/hermes-ios-0.14.0-hermes-ios-debug.tar.gz
+
+        # Sample url from mirror server:
+        # https://repo.reactnative.dev/maven2/com/facebook/hermes/hermes-ios/0.14.0/hermes-ios-0.14.0-hermes-ios-debug.tar.gz
+        "#{maven_repo_url}/#{namespace}/hermes-ios/#{version}/hermes-ios-#{version}-hermes-ios-#{build_type.to_s}.tar.gz"
+    }
+end
+
+def maven_repository_urls()
     ## You can use the `ENTERPRISE_REPOSITORY` variable to customise the base url from which artifacts will be downloaded.
     ## The mirror's structure must be the same of the Maven repo the react-native core team publishes on Maven Central.
-    maven_repo_url =
-        ENV['ENTERPRISE_REPOSITORY'] != nil && ENV['ENTERPRISE_REPOSITORY'] != "" ?
-        ENV['ENTERPRISE_REPOSITORY'] :
-        "https://repo1.maven.org/maven2"
+    if ENV['ENTERPRISE_REPOSITORY'] != nil && ENV['ENTERPRISE_REPOSITORY'] != ""
+        return [ENV['ENTERPRISE_REPOSITORY'].sub(/\/+$/, "")]
+    end
 
-    namespace = "com/facebook/hermes"
-    # Sample url from Maven:
-    # https://repo1.maven.org/maven2/com/facebook/hermes/hermes-ios/0.14.0/hermes-ios-0.14.0-hermes-ios-debug.tar.gz
-    return "#{maven_repo_url}/#{namespace}/hermes-ios/#{version}/hermes-ios-#{version}-hermes-ios-#{build_type.to_s}.tar.gz"
+    # Keep the React Native Maven mirror before Maven Central so cached artifacts are tried first
+    # and Maven Central remains the fallback.
+    return react_native_maven_mirror_enabled? ?
+        [REACT_NATIVE_MAVEN_MIRROR_REPOSITORY, MAVEN_CENTRAL_REPOSITORY] :
+        [MAVEN_CENTRAL_REPOSITORY]
+end
+
+def react_native_maven_mirror_enabled?()
+    value = ENV['RCT_REACT_NATIVE_MAVEN_MIRROR_ENABLED']
+    return true if value == nil || value == ""
+
+    value.downcase != "false" && value != "0"
 end
 
 def download_stable_hermes(react_native_path, version, configuration)
@@ -324,17 +358,26 @@ end
 
 # This function checks that Hermes artifact exists.
 # As of now it should check it on the Maven repo.
+# The probe is memoized, so repeated podspec evaluations in one `pod install`
+# don't re-request the same URL. Only conclusive answers are cached: if curl
+# never got an HTTP status (DNS failure, no route, ...) the probe is left
+# uncached so a transient hiccup doesn't permanently mark the artifact as
+# missing.
 #
 # Parameters
-# - version: the version of React Native
-# - build_type: debug or release
+# - tarball_url: the URL of the Hermes artifact to probe
 def hermes_artifact_exists(tarball_url)
     if tarball_url.start_with?("file:") == true
       return true
     end
-    # -L is used to follow redirects, useful for the nightlies
-    # I also needed to wrap the url in quotes to avoid escaping & and ?.
-    return (`curl -o /dev/null --silent -Iw '%{http_code}' -L "#{tarball_url}"` == "200")
+    unless HERMES_ARTIFACT_EXISTS_CACHE.key?(tarball_url)
+        # -L is used to follow redirects, useful for the nightlies
+        # I also needed to wrap the url in quotes to avoid escaping & and ?.
+        http_code = `curl -o /dev/null --silent -Iw '%{http_code}' -L "#{tarball_url}"`
+        return false if !$?.success? || http_code == "000"
+        HERMES_ARTIFACT_EXISTS_CACHE[tarball_url] = (http_code == "200")
+    end
+    return HERMES_ARTIFACT_EXISTS_CACHE[tarball_url]
 end
 
 def hermes_log(message, level = :warning)

package/sdks/hermes-engine/version.properties

@@ -1 +1 @@
-HERMES_VERSION_NAME=250829098.0.17
+HERMES_VERSION_NAME=260318099.0.4