React Native build or run fails on Flipper after an upgrade
Undefined symbol: _OBJC_CLASS_$_FlipperClientShort 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.
Fix it fast
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/null2Match what you see, then jump to its fix
What does the error look like?
Undefined symbol: _OBJC_CLASS_$_FlipperClientDesktop 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=*.gradle2Fix
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-ios3Verify
The app builds and launches without Flipper references.
npx react-native run-iosConfirmed by reactnative.dev
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.gradle2Fix
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-androidConfirmed by reactnative.dev
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:
- TaxiDexMy own multi-tenant taxi dispatch SaaS: API, dispatcher portal, driver and passenger apps, and the servers underneath.
- QistLockA NestJS and React SaaS driving an Android Device Owner agent that locks financed phones when payments lapse.
- TaskvareA task and project-management suite: React on the web, Flutter on mobile, TypeScript underneath.
Related fixes
Mobile apps
Running pod on a React Native project fails with can't find gem cocoapods
can't find gem cocoapods (>= 0.a) with executable pod
The pod command exists, but the Ruby that is running it has no CocoaPods gem.
3 causes, each with a fixMobile apps
Axios request works on iOS or in a browser but fails on Android with Network Error
AxiosError: Network Error
A React Native app has no CORS, so on Android a Network Error usually means the request never reached the server.
3 causes, each with a fixMobile apps
Axios returns Network Error in a React Native app on iPhone or the iOS Simulator
error.code is ERR_NETWORK and error.response is undefined
A Network Error means iOS stopped the request before any HTTP answer came back.
3 causes, each with a fixMobile apps
backgroundImage: url(...) does nothing in a React Native view
ImageBackground renders an empty area
In React Native the backgroundImage style draws linear and radial gradients, not pictures, so url(...) is ignored.
3 causes, each with a fixMobile apps
A custom font in React Native falls back to the system font
Unrecognized font family 'MyFont'
React Native does not report a missing font, it just draws the system font.
6 causes, each with a fixMobile apps
fetch fails with TypeError: Network request failed in React Native
Network request failed
Network request failed means the request never got an HTTP response, so there is no status code to read.
3 causes, each with a fix