使用Xcode构建React Native应用时遇'React/RCTAnimationType.h'文件未找到错误求助

Hey there, let's break down why you're hitting this error and what you might have missed during your OneSignal integration:

Key Reasons for the Error #

1. Version Compatibility Mismatch
   OneSignal v5.0 is a modern SDK built to support newer React Native versions (typically 0.60+). Your React Native 0.54.2 is quite outdated—released back in 2018—and the SDK’s assumptions about file structure, dependency linking, and React Native’s core modules don’t align with this old version. The RCTAnimationType.h file does exist in RN 0.54.2, but OneSignal v5.0’s integration logic might be looking for it in a path that doesn’t exist in your setup.

2. Missing RCTAnimation Subspec in CocoaPods
   Older React Native versions (pre-0.60) rely heavily on CocoaPods subspecs to link core modules. If your Podfile doesn’t explicitly include the RCTAnimation subspec, Xcode won’t be able to find the header file when building OneSignal’s code.

3. Incorrect Header Search Paths
   Xcode might not be configured to look in the right directories for React Native’s core headers, including those from the animation library.

Steps to Fix the Issue #

1. Downgrade OneSignal to a Compatible Version #

Since OneSignal v5.0 doesn’t support RN 0.54.2, you’ll need to switch to an older version of the SDK built for legacy RN setups. Versions like OneSignal React Native SDK v3.x or v4.x are known to work with RN 0.54.x.

• Uninstall the current version: npm uninstall react-native-onesignal
• Install a compatible version: npm install react-native-onesignal@3.9.3 (or a later v3/v4 release that fits your needs)

2. Fix Your CocoaPods Configuration #

In your project’s ios/Podfile, ensure you’re explicitly including the RCTAnimation subspec for React:

pod 'React', :path => '../node_modules/react-native', :subspecs => [
  'Core',
  'RCTAnimation', # This line is critical for accessing RCTAnimationType.h
  'RCTNetwork',
  # Add other subspecs your project needs
]

Then, clean and reinstall pods:

cd ios
rm -rf Pods Podfile.lock
pod install

3. Verify Header Search Paths in Xcode #

Open your Xcode project, select your main target, and navigate to Build Settings > Header Search Paths. Make sure these paths are present and set to recursive:

• $(SRCROOT)/../node_modules/react-native/React
• $(SRCROOT)/../node_modules/react-native/Libraries/NativeAnimation

4. Clean Build Caches #

Old build artifacts can cause unexpected issues, so clear them out:

• Delete Xcode’s Derived Data: Go to Xcode > Preferences > Locations > Derived Data, click the folder icon, and delete your project’s folder.
• Run react-native clean from your project root.
• Rebuild your project in Xcode.

内容的提问来源于stack exchange，提问作者Mizlul