feat(ios): add SPM dependency resolution support alongside CocoaPods

.github/workflows/tests_e2e_ios.yml

@@ -75,17 +75,21 @@ jobs:
             // we want to test debug and release - they generate different code
             let buildmode = ['debug', 'release'];
 
+            // Test both SPM and CocoaPods dependency resolution modes
+            let depResolution = ['spm', 'cocoapods'];
+
             return {
               "iteration": iterationArray,
-              "buildmode": buildmode
+              "buildmode": buildmode,
+              "dep-resolution": depResolution
             }
       - name: Debug Output
         run: echo "${{ steps.build-matrix.outputs.result }}"
 
   # This uses the matrix generated from the matrix-prep stage
   # it will run unit tests on whatever OS combinations are desired
   ios:
-    name: iOS (${{ matrix.buildmode }}, ${{ matrix.iteration }})
+    name: iOS (${{ matrix.buildmode }}, ${{ matrix.dep-resolution }}, ${{ matrix.iteration }})
     runs-on: macos-15
     needs: matrix_prep
     # TODO matrix across APIs, at least 11 and 15 (lowest to highest)
@@ -182,7 +186,7 @@ jobs:
       - uses: hendrikmuhs/ccache-action@v1
         name: Xcode Compile Cache
         with:
-          key: ${{ runner.os }}-${{ matrix.buildmode }}-ios-v3 # makes a unique key w/related restore key internally
+          key: ${{ runner.os }}-${{ matrix.buildmode }}-${{ matrix.dep-resolution }}-ios-v3 # makes a unique key w/related restore key internally
           save: "${{ github.ref == 'refs/heads/main' }}"
           create-symlink: true
           max-size: 1500M
@@ -214,8 +218,21 @@ jobs:
         continue-on-error: true
         with:
           path: tests/ios/Pods
-          key: ${{ runner.os }}-ios-pods-v3-${{ hashFiles('tests/ios/Podfile.lock') }}
-          restore-keys: ${{ runner.os }}-ios-pods-v3
+          key: ${{ runner.os }}-ios-pods-v3-${{ matrix.dep-resolution }}-${{ hashFiles('tests/ios/Podfile.lock') }}
+          restore-keys: ${{ runner.os }}-ios-pods-v3-${{ matrix.dep-resolution }}
+
+      - name: Configure Dependency Resolution Mode
+        run: |
+          if [[ "${{ matrix.dep-resolution }}" == "cocoapods" ]]; then
+            echo "Configuring CocoaPods-only mode (disabling SPM)"
+            cd tests/ios
+            sed -i '' "s/^linkage = 'dynamic'/linkage = 'static'/" Podfile
+            printf '%s\n' '$RNFirebaseDisableSPM = true' | cat - Podfile > Podfile.tmp && mv Podfile.tmp Podfile
+            sed -i '' "/SWIFT_ENABLE_EXPLICIT_MODULES/d" Podfile
+            echo "Podfile configured for CocoaPods-only mode"
+          else
+            echo "Using default SPM mode (dynamic linkage)"
+          fi
 
       - name: Pod Install
         uses: nick-fields/retry@v3

.github/workflows/tests_jest.yml

@@ -52,6 +52,8 @@ jobs:
           retry_wait_seconds: 60
           max_attempts: 3
           command: yarn
+      - name: Test Firebase SPM Helper
+        run: ruby packages/app/__tests__/firebase_spm_test.rb
       - name: Jest
         run: yarn tests:jest-coverage
       - uses: codecov/codecov-action@v5

docs/sidebar.yaml

@@ -9,6 +9,8 @@
   - '/migrating-to-v24'
 - - TypeScript
   - '/typescript'
+- - iOS SPM Support
+  - '/ios-spm'
 - - Platforms
   - '/platforms'
 - - Release Notes

packages/analytics/RNFBAnalytics.podspec

@@ -1,4 +1,5 @@
 require 'json'
+require '../app/firebase_spm'
 package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
 appPackage = JSON.parse(File.read(File.join('..', 'app', 'package.json')))
 
@@ -45,24 +46,41 @@ Pod::Spec.new do |s|
   end
 
   # Firebase dependencies
-  s.dependency          'FirebaseAnalytics/Core', firebase_sdk_version
-  if defined?($RNFirebaseAnalyticsWithoutAdIdSupport) && ($RNFirebaseAnalyticsWithoutAdIdSupport == true)
-    Pod::UI.puts "#{s.name}: Not installing FirebaseAnalytics/IdentitySupport Pod, no IDFA will be collected."
+  # Analytics has conditional dependencies that vary between SPM and CocoaPods.
+  # SPM: use FirebaseAnalyticsWithoutAdIdSupport when $RNFirebaseAnalyticsWithoutAdIdSupport = true
+  #      to avoid GoogleAppMeasurement APM symbols that require FirebaseRemoteConfig (linker error).
+  # CocoaPods: IdentitySupport is a separate subspec controlled by $RNFirebaseAnalyticsWithoutAdIdSupport.
+  if defined?(spm_dependency) && !defined?($RNFirebaseDisableSPM) &&
+     defined?($RNFirebaseAnalyticsWithoutAdIdSupport) && $RNFirebaseAnalyticsWithoutAdIdSupport
+    # FirebaseAnalyticsCore uses GoogleAppMeasurementCore (no IDFA, no APM objects).
+    # FirebaseAnalytics uses GoogleAppMeasurement which has APMETaskManager/APMMeasurement
+    # cross-references that cause linker errors when FirebasePerformance is not linked.
+    Pod::UI.puts "#{s.name}: Using FirebaseAnalyticsCore SPM product (no IDFA, uses GoogleAppMeasurementCore)."
+    firebase_dependency(s, firebase_sdk_version, ['FirebaseAnalyticsCore'], 'FirebaseAnalytics/Core')
   else
-    if !defined?($RNFirebaseAnalyticsWithoutAdIdSupport)
-      Pod::UI.puts "#{s.name}: Using FirebaseAnalytics/IdentitySupport with Ad Ids. May require App Tracking Transparency. Not allowed for Kids apps."
-      Pod::UI.puts "#{s.name}: You may set variable `$RNFirebaseAnalyticsWithoutAdIdSupport=true` in Podfile to use analytics without ad ids."
-    end
-    s.dependency          'FirebaseAnalytics/IdentitySupport', firebase_sdk_version
+    firebase_dependency(s, firebase_sdk_version, ['FirebaseAnalytics'], 'FirebaseAnalytics/Core')
+  end
 
-    # Special pod for on-device conversion
-    if defined?($RNFirebaseAnalyticsEnableAdSupport) && ($RNFirebaseAnalyticsEnableAdSupport == true)
-      Pod::UI.puts "#{s.name}: Adding Apple AdSupport.framework dependency for optional analytics features"
-      s.frameworks =       'AdSupport'
+  unless defined?(spm_dependency)
+    # CocoaPods-only: conditional IdentitySupport subspec
+    if defined?($RNFirebaseAnalyticsWithoutAdIdSupport) && ($RNFirebaseAnalyticsWithoutAdIdSupport == true)
+      Pod::UI.puts "#{s.name}: Not installing FirebaseAnalytics/IdentitySupport Pod, no IDFA will be collected."
+    else
+      if !defined?($RNFirebaseAnalyticsWithoutAdIdSupport)
+        Pod::UI.puts "#{s.name}: Using FirebaseAnalytics/IdentitySupport with Ad Ids. May require App Tracking Transparency. Not allowed for Kids apps."
+        Pod::UI.puts "#{s.name}: You may set variable `$RNFirebaseAnalyticsWithoutAdIdSupport=true` in Podfile to use analytics without ad ids."
+      end
+      s.dependency          'FirebaseAnalytics/IdentitySupport', firebase_sdk_version
     end
   end
 
-  # Special pod for on-device conversion
+  # AdSupport framework (works with both SPM and CocoaPods)
+  if defined?($RNFirebaseAnalyticsEnableAdSupport) && ($RNFirebaseAnalyticsEnableAdSupport == true)
+    Pod::UI.puts "#{s.name}: Adding Apple AdSupport.framework dependency for optional analytics features"
+    s.frameworks =       'AdSupport'
+  end
+
+  # GoogleAdsOnDeviceConversion (CocoaPods only, not available in firebase-ios-sdk SPM)
   if defined?($RNFirebaseAnalyticsGoogleAppMeasurementOnDeviceConversion) && ($RNFirebaseAnalyticsGoogleAppMeasurementOnDeviceConversion == true)
     Pod::UI.puts "#{s.name}: GoogleAdsOnDeviceConversion pod added"
     s.dependency          'GoogleAdsOnDeviceConversion'

packages/analytics/ios/RNFBAnalytics/RNFBAnalyticsModule.m

@@ -15,7 +15,12 @@
  *
  */
 
+#if __has_include(<Firebase/Firebase.h>)
 #import <Firebase/Firebase.h>
+#else
+@import FirebaseCore;
+@import FirebaseAnalytics;
+#endif
 #import <React/RCTUtils.h>
 
 #if __has_include(<RNFBAnalytics/RNFBAnalytics-Swift.h>)

packages/app-check/RNFBAppCheck.podspec

@@ -1,4 +1,5 @@
 require 'json'
+require '../app/firebase_spm'
 package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
 appPackage = JSON.parse(File.read(File.join('..', 'app', 'package.json')))
 
@@ -44,7 +45,7 @@ Pod::Spec.new do |s|
   end
 
   # Firebase dependencies
-  s.dependency          'Firebase/AppCheck', firebase_sdk_version
+  firebase_dependency(s, firebase_sdk_version, ['FirebaseAppCheck'], 'Firebase/AppCheck')
 
   if defined?($RNFirebaseAsStaticFramework)
     Pod::UI.puts "#{s.name}: Using overridden static_framework value of '#{$RNFirebaseAsStaticFramework}'"

packages/app-check/ios/RNFBAppCheck/RNFBAppCheckModule.m

@@ -15,8 +15,15 @@
  *
  */
 
+#if __has_include(<Firebase/Firebase.h>)
 #import <Firebase/Firebase.h>
-#import <FirebaseAppCheck/FIRAppCheck.h>
+#elif __has_include(<FirebaseAppCheck/FirebaseAppCheck.h>)
+#import <FirebaseAppCheck/FirebaseAppCheck.h>
+#import <FirebaseCore/FirebaseCore.h>
+#else
+@import FirebaseCore;
+@import FirebaseAppCheck;
+#endif
 
 #import <React/RCTUtils.h>
 
@@ -53,7 +60,8 @@ + (instancetype)sharedInstance {
                   : (BOOL)isTokenAutoRefreshEnabled
                   : (RCTPromiseResolveBlock)resolve rejecter
                   : (RCTPromiseRejectBlock)reject) {
-  DLog(@"deprecated API, provider will be deviceCheck / token refresh %d for app %@",
+  DLog(@"deprecated API, provider will be deviceCheck / token refresh %d for "
+       @"app %@",
        isTokenAutoRefreshEnabled, firebaseApp.name);
   [[RNFBAppCheckModule sharedInstance].providerFactory configure:firebaseApp
                                                     providerName:@"deviceCheck"
@@ -86,8 +94,8 @@ + (instancetype)sharedInstance {
   appCheck.isTokenAutoRefreshEnabled = isTokenAutoRefreshEnabled;
 }
 
-// Not present in JS or Android - it is iOS-specific so we only call this in testing - it is not in
-// index.d.ts
+// Not present in JS or Android - it is iOS-specific so we only call this in
+// testing - it is not in index.d.ts
 RCT_EXPORT_METHOD(isTokenAutoRefreshEnabled
                   : (FIRApp *)firebaseApp
                   : (RCTPromiseResolveBlock)resolve rejecter
@@ -105,33 +113,36 @@ + (instancetype)sharedInstance {
                   : (RCTPromiseRejectBlock)reject) {
   FIRAppCheck *appCheck = [FIRAppCheck appCheckWithApp:firebaseApp];
   DLog(@"appName %@", firebaseApp.name);
-  [appCheck
-      tokenForcingRefresh:forceRefresh
-               completion:^(FIRAppCheckToken *_Nullable token, NSError *_Nullable error) {
-                 if (error != nil) {
-                   // Handle any errors if the token was not retrieved.
-                   DLog(@"RNFBAppCheck - getToken - Unable to retrieve App Check token: %@", error);
-                   [RNFBSharedUtils rejectPromiseWithUserInfo:reject
-                                                     userInfo:(NSMutableDictionary *)@{
-                                                       @"code" : @"token-error",
-                                                       @"message" : [error localizedDescription],
-                                                     }];
-                   return;
-                 }
-                 if (token == nil) {
-                   DLog(@"RNFBAppCheck - getToken - Unable to retrieve App Check token.");
-                   [RNFBSharedUtils rejectPromiseWithUserInfo:reject
-                                                     userInfo:(NSMutableDictionary *)@{
-                                                       @"code" : @"token-null",
-                                                       @"message" : @"no token fetched",
-                                                     }];
-                   return;
-                 }
-
-                 NSMutableDictionary *tokenResultDictionary = [NSMutableDictionary new];
-                 tokenResultDictionary[@"token"] = token.token;
-                 resolve(tokenResultDictionary);
-               }];
+  [appCheck tokenForcingRefresh:forceRefresh
+                     completion:^(FIRAppCheckToken *_Nullable token, NSError *_Nullable error) {
+                       if (error != nil) {
+                         // Handle any errors if the token was not retrieved.
+                         DLog(@"RNFBAppCheck - getToken - Unable to retrieve App "
+                              @"Check token: %@",
+                              error);
+                         [RNFBSharedUtils
+                             rejectPromiseWithUserInfo:reject
+                                              userInfo:(NSMutableDictionary *)@{
+                                                @"code" : @"token-error",
+                                                @"message" : [error localizedDescription],
+                                              }];
+                         return;
+                       }
+                       if (token == nil) {
+                         DLog(@"RNFBAppCheck - getToken - Unable to retrieve App "
+                              @"Check token.");
+                         [RNFBSharedUtils rejectPromiseWithUserInfo:reject
+                                                           userInfo:(NSMutableDictionary *)@{
+                                                             @"code" : @"token-null",
+                                                             @"message" : @"no token fetched",
+                                                           }];
+                         return;
+                       }
+
+                       NSMutableDictionary *tokenResultDictionary = [NSMutableDictionary new];
+                       tokenResultDictionary[@"token"] = token.token;
+                       resolve(tokenResultDictionary);
+                     }];
 }
 
 RCT_EXPORT_METHOD(getLimitedUseToken
@@ -140,32 +151,35 @@ + (instancetype)sharedInstance {
                   : (RCTPromiseRejectBlock)reject) {
   FIRAppCheck *appCheck = [FIRAppCheck appCheckWithApp:firebaseApp];
   DLog(@"appName %@", firebaseApp.name);
-  [appCheck limitedUseTokenWithCompletion:^(FIRAppCheckToken *_Nullable token,
-                                            NSError *_Nullable error) {
-    if (error != nil) {
-      // Handle any errors if the token was not retrieved.
-      DLog(@"RNFBAppCheck - getLimitedUseToken - Unable to retrieve App Check token: %@", error);
-      [RNFBSharedUtils rejectPromiseWithUserInfo:reject
-                                        userInfo:(NSMutableDictionary *)@{
-                                          @"code" : @"token-error",
-                                          @"message" : [error localizedDescription],
-                                        }];
-      return;
-    }
-    if (token == nil) {
-      DLog(@"RNFBAppCheck - getLimitedUseToken - Unable to retrieve App Check token.");
-      [RNFBSharedUtils rejectPromiseWithUserInfo:reject
-                                        userInfo:(NSMutableDictionary *)@{
-                                          @"code" : @"token-null",
-                                          @"message" : @"no token fetched",
-                                        }];
-      return;
-    }
-
-    NSMutableDictionary *tokenResultDictionary = [NSMutableDictionary new];
-    tokenResultDictionary[@"token"] = token.token;
-    resolve(tokenResultDictionary);
-  }];
+  [appCheck
+      limitedUseTokenWithCompletion:^(FIRAppCheckToken *_Nullable token, NSError *_Nullable error) {
+        if (error != nil) {
+          // Handle any errors if the token was not retrieved.
+          DLog(@"RNFBAppCheck - getLimitedUseToken - Unable to retrieve App Check "
+               @"token: %@",
+               error);
+          [RNFBSharedUtils rejectPromiseWithUserInfo:reject
+                                            userInfo:(NSMutableDictionary *)@{
+                                              @"code" : @"token-error",
+                                              @"message" : [error localizedDescription],
+                                            }];
+          return;
+        }
+        if (token == nil) {
+          DLog(@"RNFBAppCheck - getLimitedUseToken - Unable to retrieve App Check "
+               @"token.");
+          [RNFBSharedUtils rejectPromiseWithUserInfo:reject
+                                            userInfo:(NSMutableDictionary *)@{
+                                              @"code" : @"token-null",
+                                              @"message" : @"no token fetched",
+                                            }];
+          return;
+        }
+
+        NSMutableDictionary *tokenResultDictionary = [NSMutableDictionary new];
+        tokenResultDictionary[@"token"] = token.token;
+        resolve(tokenResultDictionary);
+      }];
 }
 
 @end

packages/app-check/ios/RNFBAppCheck/RNFBAppCheckProvider.h

@@ -15,8 +15,15 @@
  *
  */
 
+#if __has_include(<Firebase/Firebase.h>)
 #import <Firebase/Firebase.h>
-#import <FirebaseAppCheck/FIRAppCheck.h>
+#elif __has_include(<FirebaseAppCheck/FirebaseAppCheck.h>)
+#import <FirebaseAppCheck/FirebaseAppCheck.h>
+#import <FirebaseCore/FirebaseCore.h>
+#else
+@import FirebaseCore;
+@import FirebaseAppCheck;
+#endif
 
 @interface RNFBAppCheckProvider : NSObject <FIRAppCheckProvider>
 

packages/app-distribution/RNFBAppDistribution.podspec

@@ -1,4 +1,5 @@
 require 'json'
+require '../app/firebase_spm'
 package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
 appPackage = JSON.parse(File.read(File.join('..', 'app', 'package.json')))
 
@@ -42,7 +43,7 @@ Pod::Spec.new do |s|
   end
 
   # Firebase dependencies
-  s.dependency          'Firebase/AppDistribution', firebase_sdk_version
+  firebase_dependency(s, firebase_sdk_version, ['FirebaseAppDistribution-Beta'], 'Firebase/AppDistribution')
 
   if defined?($RNFirebaseAsStaticFramework)
     Pod::UI.puts "#{s.name}: Using overridden static_framework value of '#{$RNFirebaseAsStaticFramework}'"

packages/app-distribution/ios/RNFBAppDistribution/RNFBAppDistributionModule.m

@@ -15,7 +15,12 @@
  *
  */
 
+#if __has_include(<Firebase/Firebase.h>)
 #import <Firebase/Firebase.h>
+#else
+@import FirebaseCore;
+@import FirebaseAppDistribution;
+#endif
 #import <React/RCTUtils.h>
 
 #import "RNFBApp/RNFBSharedUtils.h"

packages/app/.npmignore

@@ -68,3 +68,6 @@ android/.settings
 type-test.ts
 scripts
 __tests__
+
+# Force include generated version file (needed for linking)
+!ios/RNFBApp/RNFBVersion.m