React Native新项目用react-native-maps，iOS模拟器报AIRMap组件不存在错误

Hey there, I’ve hit this exact error multiple times when setting up react-native-maps in fresh React Native projects—don’t worry, it’s almost always a setup step that got missed. Let’s walk through the most common fixes, in order of how likely they are to resolve your issue:

• Double-check your dependency installation
  First, make sure you actually installed the library properly. Run this in your project root:

  npm install react-native-maps --save
  # Or if you use Yarn:
  yarn add react-native-maps
  

  Also, confirm that your React Native version is compatible with the version of react-native-maps you installed (check the library’s docs for version compatibility notes).

• Reinstall iOS Pods
  For React Native 0.60+, auto-linking should handle most setup, but sometimes the Pods don’t install correctly. Head to your project’s ios directory and run:

  pod deintegrate
  pod install --repo-update
  

  Wait for the Pods to finish installing, then close and reopen Xcode (or your simulator) to make sure the changes take effect.

• Clear React Native’s cache
  Cached old builds are a frequent culprit here. Reset the cache and restart the Metro bundler with:

  npx react-native start --reset-cache
  

  While you’re at it, delete the app from your iOS simulator entirely, then rebuild and re-run the app with npx react-native run-ios.

• Verify your component import and usage
  Make sure you’re using the correct component from the library in your App.js. You should be importing and using MapView, not the internal AIRMap component directly:

  import MapView from 'react-native-maps';
  
  // In your component:
  <MapView
    style={{ flex: 1 }}
    initialRegion={{
      latitude: 37.78825,
      longitude: -122.4324,
      latitudeDelta: 0.0922,
      longitudeDelta: 0.0421,
    }}
  />
  

  Using AIRMap directly will throw this error because it’s the native-backed component that MapView wraps.

• Check manual linking (for older RN versions)
  If you’re using a React Native version older than 0.60 (though you said it’s a fresh project, so this is less likely), you’ll need to manually link the library:

  npx react-native link react-native-maps
  

  After linking, re-run pod install in the ios directory and rebuild your app.

• Verify Xcode project setup
  If none of the above works, open your project in Xcode and check:

  • In your target’s Build Phases > Link Binary With Libraries, ensure libAIRMap.a is listed.
  • Make sure the react-native-maps native files are included in your project (they should be added automatically via linking/Pods, but sometimes they get missed).

Go through these steps one by one, and I’d bet one of them fixes your error. Most of the time, it’s either a Pod installation issue or a cached build causing problems.

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