feat: add support for dynamic frameworks

.github/workflows/microsoft-build-rntester.yml

@@ -5,14 +5,15 @@ on:
 
 jobs:
   build-rntester:
-    name: "${{ matrix.platform }}, ${{ matrix.arch }}"
+    name: "${{ matrix.platform }}, ${{ matrix.arch }}, ${{ matrix.linkage }}"
     runs-on: macos-26
     timeout-minutes: 90
     strategy:
       fail-fast: false
       matrix:
         platform: [macos, ios, visionos]
         arch: [oldarch, newarch]
+        linkage: [static, dynamic]
         include:
           # Platform-specific properties
           - platform: macos
@@ -32,6 +33,11 @@ jobs:
             new_arch_enabled: '0'
           - arch: newarch
             new_arch_enabled: '1'
+          # Linkage-specific properties
+          - linkage: static
+            use_frameworks: ''
+          - linkage: dynamic
+            use_frameworks: 'dynamic'
 
     steps:
       - uses: actions/checkout@v4
@@ -51,14 +57,27 @@ jobs:
 
       - name: Install Pods
         working-directory: packages/rn-tester
+        # Dynamic frameworks are still a work in progress on this fork (see RCT-Folly /
+        # header plumbing). Run those jobs for coverage but don't let pod install / build
+        # failures fail the check; the real result is still visible in the step logs.
+        # Static builds stay strict/required.
+        continue-on-error: ${{ matrix.linkage == 'dynamic' }}
         env:
           RCT_NEW_ARCH_ENABLED: ${{ matrix.new_arch_enabled }}
+          USE_FRAMEWORKS: ${{ matrix.use_frameworks }}
         run: |
           set -eox pipefail
+          # USE_FRAMEWORKS is empty for static-library builds; unset it so the
+          # Podfile keeps its default (static libraries) instead of coercing an
+          # empty linkage value.
+          if [[ -z "$USE_FRAMEWORKS" ]]; then
+            unset USE_FRAMEWORKS
+          fi
           bundle install
           bundle exec pod install --verbose
 
       - name: Build ${{ matrix.scheme }}
+        continue-on-error: ${{ matrix.linkage == 'dynamic' }} # [macOS] Dynamic frameworks WIP; keep the check green while building for coverage
         env:
           USE_CCACHE: 0
         run: |

packages/react-native/Package.swift

@@ -365,7 +365,7 @@ let reactCore = RNTarget(
     "ReactCommon/react/runtime/platform/ios", // explicit header search path to break circular dependency. RCTHost imports `RCTDefines.h` in ReactCore, ReacCore needs to import RCTHost
   ],
   linkedFrameworks: ["CoreServices"],
-  excludedPaths: ["Fabric", "Tests", "Resources", "Runtime/RCTJscInstanceFactory.mm", "I18n/strings", "CxxBridge/JSCExecutorFactory.mm", "CoreModules", "RCTUIKit"], // [macOS]
+  excludedPaths: ["Fabric", "Tests", "Resources", "Runtime/RCTJscInstanceFactory.mm", "I18n/strings", "CxxBridge/JSCExecutorFactory.mm", "CoreModules", "RCTUIKit", "RCTUIKitForwarding"], // [macOS]
   dependencies: [.reactNativeDependencies, .reactCxxReact, .reactPerfLogger, .jsi, .reactJsiExecutor, .reactUtils, .reactFeatureFlags, .reactRuntimeScheduler, .yoga, .reactJsInspector, .reactJsiTooling, .rctDeprecation, .reactCoreRCTWebsocket, .reactRCTImage, .reactTurboModuleCore, .reactRCTText, .reactRCTBlob, .reactRCTAnimation, .reactRCTNetwork, .reactFabric, .hermesPrebuilt, .reactRCTUIKit], // [macOS]
   sources: [".", "Runtime/RCTHermesInstanceFactory.mm"]
 )

packages/react-native/React-RCTUIKit.podspec

@@ -29,7 +29,7 @@ Pod::Spec.new do |s|
                                ["React/RCTUIKit/*.{h,m}"],
                                "React/RCTUIKit/*.h")
   s.public_header_files    = "React/RCTUIKit/*.h"
-  s.header_dir             = "React"
+  s.header_dir             = "React_RCTUIKit" # [macOS] Own namespace so <React_RCTUIKit/...> resolves consistently (static + frameworks); React-Core vends <React/...> forwarding aliases
   s.module_name            = "React_RCTUIKit"
   s.pod_target_xcconfig    = {
                                "DEFINES_MODULE" => "YES",

packages/react-native/React/RCTUIKit/RCTUIActivityIndicatorView.h

@@ -11,7 +11,7 @@
 
 #include <TargetConditionals.h>
 
-#import <React/RCTUIKitCompat.h>
+#import <React_RCTUIKit/RCTUIKitCompat.h>
 
 #if !TARGET_OS_OSX
 @compatibility_alias RCTUIActivityIndicatorView UIActivityIndicatorView;

packages/react-native/React/RCTUIKit/RCTUIActivityIndicatorView.m

@@ -9,7 +9,7 @@
 
 #if TARGET_OS_OSX
 
-#import <React/RCTUIActivityIndicatorView.h>
+#import <React_RCTUIKit/RCTUIActivityIndicatorView.h>
 
 #import <CoreImage/CIFilter.h>
 #import <CoreImage/CIVector.h>

packages/react-native/React/RCTUIKit/RCTUIGraphics.m

@@ -9,7 +9,7 @@
 
 #if TARGET_OS_OSX
 
-#import <React/RCTUIGraphics.h>
+#import <React_RCTUIKit/RCTUIGraphics.h>
 
 #import <objc/runtime.h>
 

packages/react-native/React/RCTUIKit/RCTUIGraphicsImageRenderer.h

@@ -11,7 +11,7 @@
 
 #include <TargetConditionals.h>
 
-#import <React/RCTUIImage.h>
+#import <React_RCTUIKit/RCTUIImage.h>
 
 #if !TARGET_OS_OSX
 

packages/react-native/React/RCTUIKit/RCTUIGraphicsImageRenderer.m

@@ -9,8 +9,8 @@
 
 #if TARGET_OS_OSX
 
-#import <React/RCTUIGraphicsImageRenderer.h>
-#import <React/RCTUIImage.h>
+#import <React_RCTUIKit/RCTUIGraphicsImageRenderer.h>
+#import <React_RCTUIKit/RCTUIImage.h>
 
 @implementation RCTUIGraphicsImageRendererFormat
 

packages/react-native/React/RCTUIKit/RCTUIImage.h

@@ -11,7 +11,7 @@
 
 #include <TargetConditionals.h>
 
-#import <React/RCTUIKitCompat.h>
+#import <React_RCTUIKit/RCTUIKitCompat.h>
 
 #if !TARGET_OS_OSX
 #import <UIKit/UIKit.h>

packages/react-native/React/RCTUIKit/RCTUIImage.m

@@ -9,7 +9,7 @@
 
 #if TARGET_OS_OSX
 
-#import <React/RCTUIImage.h>
+#import <React_RCTUIKit/RCTUIImage.h>
 
 // UIImage
 

packages/react-native/React/RCTUIKit/RCTUIImageView.h

@@ -11,8 +11,8 @@
 
 #include <TargetConditionals.h>
 
-#import <React/RCTUIKitCompat.h>
-#import <React/RCTUIImage.h>
+#import <React_RCTUIKit/RCTUIKitCompat.h>
+#import <React_RCTUIKit/RCTUIImage.h>
 
 #if !TARGET_OS_OSX
 @compatibility_alias RCTUIImageView UIImageView;

packages/react-native/React/RCTUIKit/RCTUIImageView.m

@@ -9,7 +9,7 @@
 
 #if TARGET_OS_OSX
 
-#import <React/RCTUIImageView.h>
+#import <React_RCTUIKit/RCTUIImageView.h>
 
 #import <CoreImage/CIFilter.h>
 

packages/react-native/React/RCTUIKit/RCTUIKit.h

@@ -8,18 +8,18 @@
 // [macOS]
 // Umbrella header for RCTUIKit — the UIKit/AppKit compatibility layer.
 
-#import <React/RCTUIKitCompat.h>
-#import <React/RCTUIAccessibilityTraits.h>
-#import <React/RCTUIGeometry.h>
-#import <React/RCTUIGraphics.h>
-#import <React/RCTUIImage.h>
-#import <React/RCTUIView.h>
-#import <React/RCTUIScrollView.h>
-#import <React/RCTUISlider.h>
-#import <React/RCTUILabel.h>
-#import <React/RCTUISwitch.h>
-#import <React/RCTUIActivityIndicatorView.h>
-#import <React/RCTUITouch.h>
-#import <React/RCTUIImageView.h>
-#import <React/RCTUIGraphicsImageRenderer.h>
-#import <React/RCTPlatformDisplayLink.h>
+#import <React_RCTUIKit/RCTUIKitCompat.h>
+#import <React_RCTUIKit/RCTUIAccessibilityTraits.h>
+#import <React_RCTUIKit/RCTUIGeometry.h>
+#import <React_RCTUIKit/RCTUIGraphics.h>
+#import <React_RCTUIKit/RCTUIImage.h>
+#import <React_RCTUIKit/RCTUIView.h>
+#import <React_RCTUIKit/RCTUIScrollView.h>
+#import <React_RCTUIKit/RCTUISlider.h>
+#import <React_RCTUIKit/RCTUILabel.h>
+#import <React_RCTUIKit/RCTUISwitch.h>
+#import <React_RCTUIKit/RCTUIActivityIndicatorView.h>
+#import <React_RCTUIKit/RCTUITouch.h>
+#import <React_RCTUIKit/RCTUIImageView.h>
+#import <React_RCTUIKit/RCTUIGraphicsImageRenderer.h>
+#import <React_RCTUIKit/RCTPlatformDisplayLink.h>

packages/react-native/React/RCTUIKit/RCTUILabel.h

@@ -11,7 +11,7 @@
 
 #include <TargetConditionals.h>
 
-#import <React/RCTUIKitCompat.h>
+#import <React_RCTUIKit/RCTUIKitCompat.h>
 
 #if !TARGET_OS_OSX
 @compatibility_alias RCTUILabel UILabel;

packages/react-native/React/RCTUIKit/RCTUILabel.m

@@ -9,7 +9,7 @@
 
 #if TARGET_OS_OSX
 
-#import <React/RCTUILabel.h>
+#import <React_RCTUIKit/RCTUILabel.h>
 
 @implementation RCTUILabel {}
 

packages/react-native/React/RCTUIKit/RCTUIScrollView.h

@@ -11,7 +11,7 @@
 
 #include <TargetConditionals.h>
 
-#import <React/RCTUIKitCompat.h>
+#import <React_RCTUIKit/RCTUIKitCompat.h>
 
 #if !TARGET_OS_OSX
 

packages/react-native/React/RCTUIKit/RCTUIScrollView.m

@@ -9,7 +9,7 @@
 
 #if TARGET_OS_OSX
 
-#import <React/RCTUIScrollView.h>
+#import <React_RCTUIKit/RCTUIScrollView.h>
 
 // RCTUIScrollView
 

packages/react-native/React/RCTUIKit/RCTUISlider.h

@@ -11,7 +11,7 @@
 
 #include <TargetConditionals.h>
 
-#import <React/RCTUIKitCompat.h>
+#import <React_RCTUIKit/RCTUIKitCompat.h>
 
 #if !TARGET_OS_OSX
 @compatibility_alias RCTUISlider UISlider;

packages/react-native/React/RCTUIKit/RCTUISlider.m

@@ -9,7 +9,7 @@
 
 #if TARGET_OS_OSX
 
-#import <React/RCTUISlider.h>
+#import <React_RCTUIKit/RCTUISlider.h>
 
 @implementation RCTUISlider {}
 

packages/react-native/React/RCTUIKit/RCTUISwitch.h

@@ -11,7 +11,7 @@
 
 #include <TargetConditionals.h>
 
-#import <React/RCTUIKitCompat.h>
+#import <React_RCTUIKit/RCTUIKitCompat.h>
 
 #if !TARGET_OS_OSX
 @compatibility_alias RCTUISwitch UISwitch;

packages/react-native/React/RCTUIKit/RCTUISwitch.m

@@ -9,7 +9,7 @@
 
 #if TARGET_OS_OSX
 
-#import <React/RCTUISwitch.h>
+#import <React_RCTUIKit/RCTUISwitch.h>
 
 @implementation RCTUISwitch
 

packages/react-native/React/RCTUIKit/RCTUIView.h

@@ -11,7 +11,7 @@
 
 #include <TargetConditionals.h>
 
-#import <React/RCTUIKitCompat.h>
+#import <React_RCTUIKit/RCTUIKitCompat.h>
 
 #if !TARGET_OS_OSX
 #import <UIKit/UIKit.h>

packages/react-native/React/RCTUIKit/RCTUIView.m

@@ -10,7 +10,7 @@
 #if TARGET_OS_OSX
 
 #import <QuartzCore/QuartzCore.h>
-#import <React/RCTUIView.h>
+#import <React_RCTUIKit/RCTUIView.h>
 
 // UIView
 

packages/react-native/React/RCTUIKitForwarding/RCTPlatformDisplayLink.h

@@ -0,0 +1,12 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// [macOS] Forwarding header: RCTUIKit lives in the React-RCTUIKit pod (module
+// React_RCTUIKit), but is imported throughout as <React/RCTPlatformDisplayLink.h>. This alias keeps
+// those imports working under use_frameworks! by re-exporting the (modular)
+// React_RCTUIKit header. Under static libraries it resolves the same way.
+#import <React_RCTUIKit/RCTPlatformDisplayLink.h>

packages/react-native/React/RCTUIKitForwarding/RCTUIAccessibilityTraits.h

@@ -0,0 +1,12 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// [macOS] Forwarding header: RCTUIKit lives in the React-RCTUIKit pod (module
+// React_RCTUIKit), but is imported throughout as <React/RCTUIAccessibilityTraits.h>. This alias keeps
+// those imports working under use_frameworks! by re-exporting the (modular)
+// React_RCTUIKit header. Under static libraries it resolves the same way.
+#import <React_RCTUIKit/RCTUIAccessibilityTraits.h>

packages/react-native/React/RCTUIKitForwarding/RCTUIActivityIndicatorView.h

@@ -0,0 +1,12 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// [macOS] Forwarding header: RCTUIKit lives in the React-RCTUIKit pod (module
+// React_RCTUIKit), but is imported throughout as <React/RCTUIActivityIndicatorView.h>. This alias keeps
+// those imports working under use_frameworks! by re-exporting the (modular)
+// React_RCTUIKit header. Under static libraries it resolves the same way.
+#import <React_RCTUIKit/RCTUIActivityIndicatorView.h>

packages/react-native/React/RCTUIKitForwarding/RCTUIGeometry.h

@@ -0,0 +1,12 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// [macOS] Forwarding header: RCTUIKit lives in the React-RCTUIKit pod (module
+// React_RCTUIKit), but is imported throughout as <React/RCTUIGeometry.h>. This alias keeps
+// those imports working under use_frameworks! by re-exporting the (modular)
+// React_RCTUIKit header. Under static libraries it resolves the same way.
+#import <React_RCTUIKit/RCTUIGeometry.h>

packages/react-native/React/RCTUIKitForwarding/RCTUIGraphics.h

@@ -0,0 +1,12 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// [macOS] Forwarding header: RCTUIKit lives in the React-RCTUIKit pod (module
+// React_RCTUIKit), but is imported throughout as <React/RCTUIGraphics.h>. This alias keeps
+// those imports working under use_frameworks! by re-exporting the (modular)
+// React_RCTUIKit header. Under static libraries it resolves the same way.
+#import <React_RCTUIKit/RCTUIGraphics.h>

packages/react-native/React/RCTUIKitForwarding/RCTUIGraphicsImageRenderer.h

@@ -0,0 +1,12 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// [macOS] Forwarding header: RCTUIKit lives in the React-RCTUIKit pod (module
+// React_RCTUIKit), but is imported throughout as <React/RCTUIGraphicsImageRenderer.h>. This alias keeps
+// those imports working under use_frameworks! by re-exporting the (modular)
+// React_RCTUIKit header. Under static libraries it resolves the same way.
+#import <React_RCTUIKit/RCTUIGraphicsImageRenderer.h>

packages/react-native/React/RCTUIKitForwarding/RCTUIImage.h

@@ -0,0 +1,12 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// [macOS] Forwarding header: RCTUIKit lives in the React-RCTUIKit pod (module
+// React_RCTUIKit), but is imported throughout as <React/RCTUIImage.h>. This alias keeps
+// those imports working under use_frameworks! by re-exporting the (modular)
+// React_RCTUIKit header. Under static libraries it resolves the same way.
+#import <React_RCTUIKit/RCTUIImage.h>

packages/react-native/React/RCTUIKitForwarding/RCTUIImageView.h

@@ -0,0 +1,12 @@
+/*
+ * Copyright (c) Microsoft Corporation.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+// [macOS] Forwarding header: RCTUIKit lives in the React-RCTUIKit pod (module
+// React_RCTUIKit), but is imported throughout as <React/RCTUIImageView.h>. This alias keeps
+// those imports working under use_frameworks! by re-exporting the (modular)
+// React_RCTUIKit header. Under static libraries it resolves the same way.
+#import <React_RCTUIKit/RCTUIImageView.h>