React-native-maps因版本不匹配在iOS模拟器启动失败

Hey there! Let's get that map working for you. The core issue here is a version compatibility conflict between react-native-maps and your React Native project, plus a mismatch between your JavaScript and Native RN versions (0.54.4 vs 0.55.2)—that's exactly what's triggering the error you're seeing. Here are the most straightforward fixes based on your setup:

Solution 1: Use Expo's Compatible Maps Install (Best for Create-React-Native-App Users) #

Since you started with create-react-native-app, your project is likely using Expo under the hood. Using npm install for react-native-maps can pull a version that doesn't play nice with Expo's managed React Native version. Instead:

1. Uninstall the current maps package:

   npm uninstall react-native-maps --save
   

2. Install the Expo-approved compatible version (this automatically picks a version that matches your project's RN setup):

   expo install react-native-maps
   

3. Rebuild and run your app:

   npm run ios
   

Solution 2: Align React Native Versions & Install Compatible Maps (For Bare/Ejected Projects) #

If you've ejected your project (moved away from Expo), you'll need to fix the RN version mismatch first, then install a maps version that supports your setup:

Step 1: Fix RN Version Mismatch #

Align your JavaScript and Native RN versions to 0.54.4 (since react-native-maps requires RN 0.52-0.54):

npm uninstall react-native --save
npm install react-native@0.54.4 --save

Step 2: Install Compatible Maps Version #

Install a version of react-native-maps that works with RN 0.54.x:

npm install react-native-maps@0.21.0 --save

Step 3: Link Native Dependencies #

For bare RN projects, you need to link the maps library to iOS:

react-native link react-native-maps

Step 4: Rebuild iOS Project #

Update CocoaPods and rebuild your app:

cd ios && pod install && cd ..
npm run ios

Bonus Note on Parallels #

Your Parallels VM setup isn't the culprit here—since the app ran fine without maps, the problem is definitely version-related, not environment-based.

Once you follow these steps, your map should load correctly in the iOS simulator!

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