Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages
Flutter and app store releases

React Native build or run fails on Flipper after an upgrade

ErrorUndefined symbol: _OBJC_CLASS_$_FlipperClient

Short answer

React Native 0.74 removed the native Flipper libraries and setup code from new projects, and Flipper is no longer supported. An upgraded app that still has Flipper code in the iOS or Android project then fails to build or connect. Remove the leftover Flipper lines using the Upgrade Helper diff, or add Flipper back by hand.

  • Applies to React Native 0.74 and later, Xcode 26
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Fix it fast

  1. 1Find out which cause you have

    Search the native projects for leftover Flipper setup code.

    grep -rni "flipper" ios/Podfile ios/*/AppDelegate* android/app/build.gradle android/app/src 2>/dev/null
  2. 2Match what you see, then jump to its fix

    1. 1The build or launch mentions Flipper classes in a project upgraded to 0.74 or laterFlipper setup code is left over after the upgradeFix
    2. 2You ignored the removal diff, and Flipper Desktop cannot get certificatesYou still want Flipper in the appFix

What does the error look like?

  • Undefined symbol: _OBJC_CLASS_$_FlipperClient
  • Desktop failed to provide certificates. Error from flipper desktop

Cause 1 of 2

Flipper setup code is left over after the upgrade

1Check

The 0.74 release notes say the native Flipper libraries and setup code were removed from new projects. The grep above shows where your project still refers to them.

grep -rni "flipper" ios android --include=Podfile --include=*.m --include=*.mm --include=*.java --include=*.kt --include=*.gradle

2Fix

Open the Upgrade Helper for your version change, apply the diff that removes Flipper from the native files, then reinstall pods.

cd ios && pod install && cd ..
npx react-native run-ios

3Verify

The app builds and launches without Flipper references.

npx react-native run-ios

Confirmed by reactnative.dev

Did this fix it?

Cause 2 of 2

You still want Flipper in the app

1Check

Flipper is unsupported in React Native from 0.74. The release notes say it can still be used as a standalone tool and be integrated manually following the Flipper docs.

grep -rni "flipper" ios/Podfile android/app/build.gradle

2Fix

Follow the Flipper getting-started guides for native Android and iOS, or switch to the recommended tools: the Hermes debugger for JavaScript, and Android Studio and Xcode for native debugging.

# see https://fbflipper.com/docs/getting-started/ios-native/

3Verify

Build again and connect the debugger of your choice.

npx react-native run-android

Confirmed by reactnative.dev

Did this fix it?

How do I stop it coming back?

  • Upgrade React Native by applying the Upgrade Helper diff completely, native files included.
  • Use the Hermes debugger instead of Flipper for JavaScript debugging.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Every cause above names the document that confirms it. I have not reproduced this fix on a machine of my own yet, so read it as documented guidance, not a test report. Found a mistake? Tell me.

Which stack is behind this page?

Projects of mine built on the same technologies:

Related fixes

Next step

Want this handled for good?

I look after servers, apps and releases end to end. Tell me what keeps breaking.