expo-modules-autolinking 56.0.3 → 56.0.5

package/CHANGELOG.md

@@ -10,6 +10,16 @@
 
 ### 💡 Others
 
+## 56.0.5 — 2026-05-13
+
+### 🐛 Bug fixes
+
+[iOS] Added fallback to source for missing framework slice. ([#45664](https://github.com/expo/expo/pull/45664) by [@chrfalch](https://github.com/chrfalch))
+
+## 56.0.4 — 2026-05-11
+
+_This version does not introduce any user-facing changes._
+
 ## 56.0.3 — 2026-05-08
 
 ### 🐛 Bug fixes

package/android/expo-gradle-plugin/expo-autolinking-plugin/src/main/kotlin/expo/modules/plugin/ExpoRootProjectPlugin.kt

@@ -34,18 +34,27 @@ fun Project.defineDefaultProperties(versionCatalogs: Optional<VersionCatalog>) {
   val kotlin = extra.setIfNotExist("kotlinVersion") { versionCatalogs.getVersionOrDefault("kotlin", "2.0.21") }
   val ksp = extra.setIfNotExist("kspVersion") {
     versionCatalogs.getVersionOrDefault("ksp") {
-      try {
-        return@getVersionOrDefault KSPLookup.getValue(extra.get("kotlinVersion") as String)
-      } catch (e: Throwable) {
-        throw IllegalStateException(
-          "Can't find KSP version for Kotlin version '${extra.get("kotlinVersion")}'. You're probably using an unsupported version of Kotlin. Supported versions are: '${KSPLookup.keys.joinToString(", ")}'",
-          e
-        )
+      val kotlinVersion = extra.get("kotlinVersion") as String
+
+      KSPLookup[kotlinVersion]?.let { return@getVersionOrDefault it }
+      if (kotlinVersion >= "2.3.0") {
+        return@getVersionOrDefault latestKspVersion
       }
+
+      val minSupported = KSPLookup.keys.min()
+      throw IllegalStateException(
+        """
+        Kotlin $kotlinVersion is not supported by Expo modules.
+        The minimum supported Kotlin version is $minSupported. 
+        Update 'kotlinVersion' in your project's build.gradle to a supported version. 
+        Alternatively, you can set 'kspVersion' explicitly in build.gradle to bypass this check, but this is unsupported and may cause build failures.  
+        """.trimIndent()
+      )
     }
   }
 
-  project.logger.quiet("""
+  project.logger.quiet(
+    """
     ${"[ExpoRootProject]".withColor(Colors.GREEN)} Using the following versions:
       - buildTools:  ${buildTools.withColor(Colors.GREEN)}
       - minSdk:      ${minSdk.withColor(Colors.GREEN)}
@@ -54,7 +63,8 @@ fun Project.defineDefaultProperties(versionCatalogs: Optional<VersionCatalog>) {
       - ndk:         ${ndk.withColor(Colors.GREEN)}
       - kotlin:      ${kotlin.withColor(Colors.GREEN)}
       - ksp:         ${ksp.withColor(Colors.GREEN)}
-  """.trimIndent())
+  """.trimIndent()
+  )
 }
 
 inline fun ExtraPropertiesExtension.setIfNotExist(name: String, value: () -> Any): Any? {

package/android/expo-gradle-plugin/expo-autolinking-plugin/src/main/kotlin/expo/modules/plugin/KSPLookup.kt

@@ -1,20 +1,15 @@
 // Copyright 2015-present 650 Industries. All rights reserved.
-// Generated using './scripts/generateKSPLookUp.js'
 package expo.modules.plugin
 
+// Starting with KSP 2.3.0, KSP is no longer tied to a specific Kotlin version.
+const val latestKspVersion = "2.3.7"
+
+// For older Kotlin versions, KSP releases were tied to specific Kotlin versions.
 val KSPLookup = mapOf(
   "2.2.21" to "2.2.21-2.0.5",
-  "2.3.1" to "2.3.1",
-  "2.3.0" to "2.3.0",
   "2.2.20" to "2.2.20-2.0.4",
   "2.2.10" to "2.2.10-2.0.2",
   "2.2.0" to "2.2.0-2.0.2",
   "2.1.21" to "2.1.21-2.0.2",
-  "2.1.20" to "2.1.20-2.0.1",
-  "2.1.10" to "2.1.10-1.0.31",
-  "2.1.0" to "2.1.0-1.0.29",
-  "2.0.21" to "2.0.21-1.0.28",
-  "2.0.20" to "2.0.20-1.0.25",
-  "2.0.10" to "2.0.10-1.0.24",
-  "2.0.0" to "2.0.0-1.0.24"
+  "2.1.20" to "2.1.20-2.0.1"
 )

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-modules-autolinking",
-  "version": "56.0.3",
+  "version": "56.0.5",
   "description": "Scripts that autolink Expo modules.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -49,7 +49,7 @@
     "chalk": "^4.1.0",
     "commander": "^7.2.0"
   },
-  "gitHead": "a30353e69ca0d72b9fac5830abc631feda1ba3ae",
+  "gitHead": "40f0a6f6711d93762e0506b37e6e077e4bd9a541",
   "scripts": {
     "build": "expo-module build",
     "clean": "expo-module clean",

package/scripts/ios/autolinking_manager.rb

@@ -22,16 +22,18 @@ module Expo
 
       validate_target_definition()
 
-      # Clear stale CocoaPods download cache for precompiled pods.
-      Expo::PrecompiledModules.clear_cocoapods_cache
-
       resolve_result = resolve()
 
       Expo::PackagesConfig.instance.coreFeatures = resolve_result['coreFeatures']
 
-      # Pass buildFromSource configuration to PrecompiledModules
       configuration = resolve_result['configuration'] || {}
-      Expo::PrecompiledModules.build_from_source = configuration['buildFromSource'] || []
+      Expo::PrecompiledModules.configure(
+        target_platform: @target_definition.platform,
+        build_from_source: configuration['buildFromSource'] || []
+      )
+
+      # Clear stale CocoaPods download cache for precompiled pods.
+      Expo::PrecompiledModules.clear_cocoapods_cache
 
       @packages = resolve_result['modules'].map { |json_package| Package.new(json_package) }
       @extraPods = resolve_result['extraDependencies']

package/scripts/ios/precompiled_modules.rb

@@ -29,7 +29,9 @@
 require 'fileutils'
 require 'json'
 require 'net/http'
+require 'open3'
 require 'set'
+require 'tempfile'
 require 'uri'
 
 module Expo
@@ -76,6 +78,8 @@ module Expo
     @framework_owner_map = nil          # Hash: framework_name -> owning_pod_name
     @failed_remote_downloads = Set.new
     @warned_no_prebuilt_react = false
+    @target_platform = nil
+    @xcframework_slice_cache = nil
 
     class << self
       # Returns the build flavor (debug/release) for precompiled modules.
@@ -113,13 +117,26 @@ module Expo
         false
       end
 
-      # Sets the list of package name patterns that should be built from source
-      # instead of using precompiled xcframeworks. Patterns are treated as regexes
-      # (e.g., ".*" for all, "expo-audio" for exact match, "expo-.*" for prefix).
+      def configure(target_platform: nil, build_from_source: nil)
+        self.target_platform = target_platform unless target_platform.nil?
+        self.build_from_source = build_from_source unless build_from_source.nil?
+      end
+
       def build_from_source=(patterns)
         @build_from_source_patterns = (patterns || []).map { |p| Regexp.new("^#{p}$") }
       end
 
+      def target_platform=(platform)
+        normalized = normalize_xcframework_platform(platform)
+        return if @target_platform == normalized
+
+        @target_platform = normalized
+        @all_bundled_frameworks = nil
+        @claimed_vendored_frameworks = nil
+        @framework_owner_map = nil
+        @xcframework_slice_cache = nil
+      end
+
       # Checks if a pod is configured to be built from source via buildFromSource.
       # Matches against both the pod name and the npm package name.
       def build_from_source?(pod_name)
@@ -1785,6 +1802,7 @@ module Expo
         product_name = pod_info[:product_name] || pod_name
         tarball = resolve_prebuilt_tarball(pod_info, product_name, build_flavor, pod_name)
         return { available: false, reason: :missing_tarball, path: tarball } unless File.exist?(tarball)
+        return { available: false, reason: :missing_platform_slice, path: tarball } unless xcframework_supports_target_platform?(tarball)
 
         { available: true, resolved: [pod_info, product_name, tarball] }
       end
@@ -1842,6 +1860,74 @@ module Expo
         remote_tarball
       end
 
+      def normalize_xcframework_platform(platform)
+        name = platform.respond_to?(:name) ? platform.name : platform
+        name = name.string_name if name.respond_to?(:string_name)
+        normalized = name.to_s.downcase
+        normalized == 'osx' ? 'macos' : normalized
+      end
+
+      def xcframework_supports_target_platform?(path)
+        return true unless @target_platform
+
+        @xcframework_slice_cache ||= {}
+        cache_key = [path, @target_platform]
+        return @xcframework_slice_cache[cache_key] if @xcframework_slice_cache.key?(cache_key)
+
+        @xcframework_slice_cache[cache_key] = begin
+          info_plists = File.directory?(path) ? [read_plist(File.join(path, 'Info.plist'))] : read_xcframework_info_plists_from_tarball(path)
+          info_plists.any? && info_plists.all? { |info_plist| info_plist_supports_target_platform?(info_plist) }
+        end
+      end
+
+      def info_plist_supports_target_platform?(info_plist)
+        return false unless info_plist
+
+        available_libraries = info_plist['AvailableLibraries']
+        return false unless available_libraries.is_a?(Array)
+
+        available_libraries.any? do |library|
+          normalize_xcframework_platform(library['SupportedPlatform']) == @target_platform
+        end
+      end
+
+      def read_xcframework_info_plists_from_tarball(tarball)
+        entries_output, status = Open3.capture2e('tar', 'tzf', tarball)
+        unless status.success?
+          Pod::UI.warn "[Expo-precompiled] Failed to inspect #{File.basename(tarball)}: #{entries_output.strip}"
+          return []
+        end
+
+        entries = entries_output.lines.map(&:strip)
+        plist_entries = entries.select { |entry| entry.end_with?('.xcframework/Info.plist') }
+        Pod::UI.warn "[Expo-precompiled] No XCFramework Info.plist found in #{File.basename(tarball)}" if plist_entries.empty?
+
+        plist_entries.filter_map do |entry|
+          plist_data, plist_status = Open3.capture2e('tar', 'xOzf', tarball, entry)
+          unless plist_status.success?
+            Pod::UI.warn "[Expo-precompiled] Failed to extract #{entry} from #{File.basename(tarball)}: #{plist_data.strip}"
+            next
+          end
+
+          Tempfile.create(['expo-xcframework-info', '.plist']) do |file|
+            file.binmode
+            file.write(plist_data)
+            file.flush
+            read_plist(file.path)
+          end
+        end
+      rescue StandardError => e
+        Pod::UI.warn "[Expo-precompiled] Failed to inspect #{File.basename(tarball)}: #{e.message}"
+        []
+      end
+
+      def read_plist(path)
+        Xcodeproj::Plist.read_from_path(path)
+      rescue StandardError => e
+        Pod::UI.warn "[Expo-precompiled] Failed to read #{File.basename(path)}: #{e.message}"
+        nil
+      end
+
       def failed_remote_downloads
         @failed_remote_downloads ||= Set.new
       end
@@ -2120,6 +2206,8 @@ module Expo
           'prebuilt config not found'
         when :missing_tarball
           'prebuilt tarball not found'
+        when :missing_platform_slice
+          "prebuilt xcframework does not contain a slice for #{@target_platform}"
         when :dependency_unavailable
           reason = format_prebuilt_unavailable_reason(reason: info[:dependency_reason], path: info[:dependency_path])
           "dependency #{info[:dependency]} is not using prebuilt: #{reason}"

package/scripts/generateKSPLookup.js

@@ -1,101 +0,0 @@
-#!/usr/bin/env node
-const { execSync } = require('child_process');
-const fs = require('fs');
-
-const minKotlinVersion = '2.0.0';
-const maxKotlinVersion = '2.3.10';
-
-const groupId = 'com.google.devtools.ksp';
-const artifactId = 'symbol-processing-gradle-plugin';
-const path = require('path').resolve(
-  __dirname,
-  '../android/expo-gradle-plugin/expo-autolinking-plugin/src/main/kotlin/expo/modules/plugin/KSPLookup.kt'
-);
-
-const numberPerPage = 30;
-const githubApiPath = '/repos/google/ksp/releases';
-
-async function* fetchKSPReleases() {
-  let currentPage = 1;
-  while (true) {
-    const apiPath = `${githubApiPath}?per_page=${numberPerPage}&page=${currentPage}`;
-    console.log(`Fetching versions from: ${apiPath}...`);
-
-    const output = execSync(`gh api "${apiPath}"`, { encoding: 'utf-8' });
-    const data = JSON.parse(output);
-    const versions = data
-      .map((release) => release.tag_name)
-      // Filter out release candidates, beta and milestone versions
-      .filter((version) => !/(rc|beta|m1)/i.test(version));
-
-    yield versions;
-
-    currentPage += 1;
-  }
-}
-
-async function filterByKotinVersion(generator, minKotlinVersion, maxKotlinVersion) {
-  let hasMoreData = true;
-  const result = [];
-  while (hasMoreData) {
-    const { value } = await generator.next();
-    const versions = value.map((version) => {
-      const [kotlinVersion] = version.split('-');
-      return { kotlinVersion, version };
-    });
-
-    // If the version is lower than the minKotlinVersion, we can stop fetching more data
-    hasMoreData = !versions.some(({ kotlinVersion }) => kotlinVersion < minKotlinVersion);
-
-    result.push(
-      ...versions.filter(
-        ({ kotlinVersion }) =>
-          kotlinVersion >= minKotlinVersion && kotlinVersion <= maxKotlinVersion
-      )
-    );
-  }
-  return result;
-}
-
-// Group versions by kotlinVersion and return the most recent version for each kotlinVersion
-function groupByKotlinVersion(versions) {
-  const mostRecentVersions = {};
-
-  // Fill the mostRecentVersions object with the newest version of each kotlinVersion
-  versions.forEach(({ kotlinVersion, version }) => {
-    if (!mostRecentVersions[kotlinVersion] || mostRecentVersions[kotlinVersion] < version) {
-      mostRecentVersions[kotlinVersion] = version;
-    }
-  });
-
-  // Convert the results object back into an array
-  return Object.entries(mostRecentVersions).map(([kotlinVersion, version]) => ({
-    kotlinVersion,
-    version,
-  }));
-}
-
-async function generateKSPLookup() {
-  const versionsGenerator = fetchKSPReleases(groupId, artifactId, minKotlinVersion);
-  const versions = groupByKotlinVersion(
-    await filterByKotinVersion(versionsGenerator, minKotlinVersion, maxKotlinVersion)
-  );
-
-  console.log(`Found stable versions for ${groupId}:${artifactId}:`);
-  for (const { kotlinVersion, version } of versions) {
-    console.log(` ${kotlinVersion} => ${version}`);
-  }
-
-  console.log('Genereating KSP lookup file...');
-  const fileContent = `// Copyright 2015-present 650 Industries. All rights reserved.
-// Generated using './scripts/generateKSPLookUp.js'
-package expo.modules.plugin
-
-val KSPLookup = mapOf(
-${versions.map(({ kotlinVersion, version }) => `  "${kotlinVersion}" to "${version}"`).join(',\n')}
-)
-`;
-  fs.writeFileSync(path, fileContent, 'utf-8');
-}
-
-generateKSPLookup();