@rive-app/rive-nitro-react-native 0.2.6 does not work with Xcode 26+

[mfazekas]

During the iOS build, I have this error like @ethanneff

iOS errors

❌ (/Users/guillermo/Library/Developer/Xcode/DerivedData/EosCareDev-gfwjmymejapfotcymmokvbobpvfn/Build/Products/Debug-iphoneos/XCFrameworkIntermediates/RiveRuntime/RiveRuntime.framework/Headers/RiveRuntime-Swift.h:3603:62)

3601 | auto &consumedParamCopy_some = *(new(copyBuffer_consumedParamCopy_some) T_0_0(some_));
3602 | swift::_impl::ConsumedValueStorageDestroyer<T_0_0> storageGuard_consumedParamCopy_some(consumedParamCopy_some);
3603 | return swift::_impl::_impl_Optional<T_0_0>::returnNewValue([&](char * _Nonnull result) SWIFT_INLINE_THUNK_ATTRIBUTES {
| ^ '' has different definitions in different modules; first difference is definition in module 'RiveRuntime.Swift' found method 'operator()' with body
3604 | swift::_impl::$sSqyxSgxcfC(result, swift::_impl::getOpaquePointer(consumedParamCopy_some), swift::TypeMetadataTrait<T_0_0>::getTypeMetadata());
3605 | });
3606 | }

❌ (/Users/guillermo/Library/Developer/Xcode/DerivedData/EosCareDev-gfwjmymejapfotcymmokvbobpvfn/Build/Products/Debug-iphoneos/XCFrameworkIntermediates/RiveRuntime/RiveRuntime.framework/Headers/RiveRuntime-Swift.h:3596:78)

3594 | requires swift::isUsableInGenericContext<T_0_0>
3595 | #endif // cpp_concepts
3596 | SWIFT_INLINE_THUNK swift::Optional<T_0_0> Optional<T_0_0>::init(const T_0_0& some) {
| ^ 'swift::Optional::init' has different definitions in different modules; definition in module 'RiveRuntime.Swift' first difference is 1st parameter with name 'some'
3597 | #ifndef __cpp_concepts
3598 | static_assert(swift::isUsableInGenericContext<T_0_0>, "type cannot be used in a Swift generic context");
3599 | #endif // __cpp_concepts

❌ (/Users/guillermo/Library/Developer/Xcode/DerivedData/EosCareDev-gfwjmymejapfotcymmokvbobpvfn/Build/Products/Debug-iphoneos/NitroModules/Swift Compatibility Header/NitroModules-Swift.h:2177:29)

2175 | SWIFT_INLINE_THUNK swift::Int distanceFromTo(const String_Index& i, const String_Index& j) const SWIFT_SYMBOL("s:SS8UTF8ViewV8distance4from2toSiSS5IndexV_AGtF");
2176 | SWIFT_INLINE_THUNK uint8_t operator [](const String_Index& i) const SWIFT_SYMBOL("s:SS8UTF8ViewVys5UInt8VSS5IndexVcig");
2177 | SWIFT_INLINE_THUNK String getDescription() const SWIFT_SYMBOL("s:SS8UTF8ViewV11descriptionSSvp");
| ^ 'swift::UTF8View' has different definitions in different modules; first difference is definition in module 'NitroModules.Swift' found method 'getDescription'
2178 | SWIFT_INLINE_THUNK String getDebugDescription() const SWIFT_SYMBOL("s:SS8UTF8ViewV16debugDescriptionSSvp");
2179 | SWIFT_INLINE_THUNK swift::Int getCount() const SWIFT_SYMBOL("s:SS8UTF8ViewV5countSivp");
2180 | private:

❌ (/Users/guillermo/Library/Developer/Xcode/DerivedData/EosCareDev-gfwjmymejapfotcymmokvbobpvfn/Build/Products/Debug-iphoneos/NitroModules/Swift Compatibility Header/NitroModules-Swift.h:1984:37)

1982 | SWIFT_INLINE_THUNK void setCharacters(const String& newValue) SWIFT_SYMBOL("s:SS10charactersSSvp");
1983 | SWIFT_INLINE_THUNK swift::Int getHashValue() const SWIFT_SYMBOL("s:SS9hashValueSivp");
1984 | SWIFT_INLINE_THUNK Array<uint8_t> get_nfcCodeUnits() const SWIFT_SYMBOL("s:SS13_nfcCodeUnitsSays5UInt8VGvp");
| ^ 'swift::String' has different definitions in different modules; first difference is definition in module 'NitroModules.Swift' found method 'get_nfcCodeUnits'
1985 | /// Returns a lowercase version of the string.
1986 | /// Here’s an example of transforming a string to all lowercase letters.
1987 | /// \code

❌ (/Users/guillermo/Library/Developer/Xcode/DerivedData/EosCareDev-gfwjmymejapfotcymmokvbobpvfn/Build/Products/Debug-iphoneos/NitroModules/Swift Compatibility Header/NitroModules-Swift.h:1722:52)

1720 | SWIFT_INLINE_THUNK T_0_0 getUnsafelyUnwrapped() const SWIFT_SYMBOL("s:SqsRi0_zrlE17unsafelyUnwrappedxvp");
1721 | /// Creates an instance that stores the given value.
1722 | static SWIFT_INLINE_THUNK swift::Optional<T_0_0> init(const T_0_0& value) SWIFT_SYMBOL("s:SqsRi_zrlEyxSgxcfc");
| ^ 'swift::Optional' has different definitions in different modules; first difference is definition in module 'NitroModules.Swift' found method 'init' with 1st parameter named 'value'
1723 | #define SWIFT_CXX_INTEROP_OPTIONAL_MIXIN
1724 | #pragma clang diagnostic push
1725 | #pragma clang diagnostic ignored "-Wnon-modular-include-in-framework-module"

Originally posted by @martinezguillaume in #168

[mfazekas]

@martinezguillaume what is your react-native-nitro-modules and @rive-app/rive-nitro-react-native versions?!

yarn why react-native-nitro-modules
yarn why @rive-app/react-native
npm ls react-native-nitro-modules
npm ls @rive-app/react-native

[martinezguillaume]

Thanks to have created a new issue !
I'm using expo, following the doc, rive-nitro-react-native is not necessary (correct ?)

Here is my package

    "expo": "~55.0.5",
    "@rive-app/react-native": "^0.2.6",

[mfazekas]

Thanks! Could you share a bit more info:

1. Your Xcode version (xcodebuild -version)
2. Your react-native-nitro-modules version — yarn why react-native-nitro-modules or npm ls react-native-nitro-modules. react-native-nitro-modules is needed by @rive-app/react-native. So it's fine if it's not in package.json but will be installed in node_modules.
3. The relevant pod versions from your ios/Podfile.lock (especially NitroModules and RiveRuntime) if you don't have iOS that's fine.

[martinezguillaume]

Xcode 26.3
Build version 17C529

eosmobile@1.0.0 /Users/guillermo/Projects/user-mobile
├─┬ @rive-app/react-native@0.2.6 extraneous
│ └── react-native-nitro-modules@0.34.1 deduped
└── react-native-nitro-modules@0.34.1 extraneous

Deduped is weird, i'll try to clean my node_modules
EDIT: ok, after clean it's good

eosmobile@1.0.0 /Users/guillermo/Projects/user-mobile
└─┬ @rive-app/react-native@0.2.6
  └── react-native-nitro-modules@0.34.1

 - NitroModules (0.34.1):
 - RiveRuntime (6.15.2)

[ethanneff]

I don't think the problem is specific to react-native-nitro-modules@0.35.0.

@martinezguillaume is on react-native-nitro-modules@0.34.1 and I am on react-native-nitro-modules@0.33.9.

For me, @rive-app/react-native@0.2.5, @rive-app/react-native@0.2.6, and #172 generate the iOS build errors regardless of nitro version.

@rive-app/react-native@0.2.3 with react-native-nitro-modules@0.33.9 does work. However, @rive-app/react-native@0.2.3 crashes on production android <10 devices.

[mfazekas]

@ethanneff yeah it's an Xcode 26 incompatibility/build issue. We're working on a fix.

[mfazekas]

There is a PR, but we might fix it with new rive-os release.

In the meantime you can add this to your ios/Podfile post_install section to work around this issue:

 post_install do |installer|                                               
    # Xcode 26 workaround: strip .Swift submodule from RiveRuntime modulemaps                                                   
    # https://github.com/rive-app/rive-nitro-react-native/issues/173                                                            
    rive_dir = File.join(installer.sandbox.root.to_s, 'RiveRuntime')
    if Dir.exist?(rive_dir)
      Dir.glob(File.join(rive_dir, '**', 'module.modulemap')).each do |path|
        content = File.read(path)
        next unless content.include?('RiveRuntime.Swift')
        cleaned = content.gsub(/\nmodule RiveRuntime\.Swift \{[^}]*\}\n?/m, "\n")
        File.write(path, cleaned)
      end
    end
  end
``

[IgorVanian]

@mfazekas

I added your snippet but still have an issue:

/node_modules/@rive-app/react-native/ios/DataSource.swift:27:34: error: cannot find type 'ArrayBufferHolder' in scope
  static func bytes(from buffer: ArrayBufferHolder) -> DataSource {
                                 ^~~~~~~~~~~~~~~~~
/node_modules/@rive-app/react-native/ios/HybridRiveFileFactory.swift:148:25: error: cannot find type 'ArrayBufferHolder' in scope
  func fromBytes(bytes: ArrayBufferHolder, loadCdn: Bool, referencedAssets: ReferencedAssetsType?)
                        ^~~~~~~~~~~~~~~~~
/node_modules/@rive-app/react-native/ios/HybridRiveImageFactory.swift:23:34: error: cannot find type 'ArrayBufferHolder' in scope
  func loadFromBytesAsync(bytes: ArrayBufferHolder) throws -> Promise<(any HybridRiveImageSpec)> {
                                 ^~~~~~~~~~~~~~~~~

[mfazekas]

@IgorVanian the workaround is confirmed working on Xcode 26.2 — the key is that you must run pod install after adding the snippet to your Podfile, since the post_install hook only runs during pod install.

Here's how to verify it's working:

1. Check the modulemap is broken BEFORE the fix (after a fresh pod install without the workaround):

find ios/Pods -path "*/RiveRuntime*" -name "module.modulemap" | head -1 | xargs cat

You should see a RiveRuntime.Swift submodule — this is the culprit:

framework module RiveRuntime {
  umbrella header "RiveRuntime.h"
  export *
  module * { export * }
}

module RiveRuntime.Swift {     # <-- this causes the ODR violations in Xcode 26
  header "RiveRuntime-Swift.h"
  requires objc
}

2. Add the workaround to your Podfile (inside the existing post_install block if there is one, don't create a second post_install):

post_install do |installer|
  # Xcode 26 workaround: strip .Swift submodule from RiveRuntime modulemaps
  # https://github.com/rive-app/rive-nitro-react-native/issues/173
  rive_dir = File.join(installer.sandbox.root.to_s, 'RiveRuntime')
  if Dir.exist?(rive_dir)
    Dir.glob(File.join(rive_dir, '**', 'module.modulemap')).each do |path|
      content = File.read(path)
      next unless content.include?('RiveRuntime.Swift')
      cleaned = content.gsub(/\nmodule RiveRuntime\.Swift \{[^}]*\}\n?/m, "\n")
      File.write(path, cleaned)
      puts "[RNRive] Stripped RiveRuntime.Swift from #{path}"
    end
  end
end

3. Re-run pod install:

cd ios && pod install

You should see [RNRive] Stripped RiveRuntime.Swift from ... printed for each slice (there are 8).

4. Verify the fix was applied:

find ios/Pods -path "*/RiveRuntime*" -name "module.modulemap" | head -1 | xargs cat

The RiveRuntime.Swift block should be gone:

framework module RiveRuntime {
  umbrella header "RiveRuntime.h"
  export *
  module * { export * }
}

Root cause: Xcode 26's clang re-parses RiveRuntime-Swift.h under both RiveRuntime.Swift (the explicit submodule) and the implicit Swift stdlib module, causing ODR (One Definition Rule) violations for swift::Optional, swift::String, swift::UTF8View, etc. Removing the explicit submodule declaration resolves this. The ArrayBufferHolder not in scope errors you saw are cascading failures from the same root cause — once the module is broken, all Swift types from NitroModules also appear as undefined.

We're tracking a permanent fix (either via a new rive-ios release or in the podspec itself).

[mfazekas]

/node_modules/@rive-app/react-native/ios/HybridRiveFileFactory.swift:148:25: error: cannot find type 'ArrayBufferHolder' in scope
  func fromBytes(bytes: ArrayBufferHolder, loadCdn: Bool, referencedAssets: ReferencedAssetsType?)

@IgorVanian actually it looks like you're error is not Xcode 26 related but nitro module incompatibility. Can you check you react-native-nitro-modules version?! We're not yet compatible with 0.35, so please downgrade to 0.34 to fix that issue.