Xcode构建iOS应用报错：'Debug-iphoneos/AmplifyRTNCore/AmplifyRTNCore.modulemap'未找到

环境配置 #

• MacBook Pro [Apple M1 Pro] [Sonoma 14.1]
• Xcode 15.2
• 设备：iPhone 15 Pro [17.3.1]
• react [18.2.0]
• react-native [0.73.4]
• aws-amplify [6.0.17]
• npm [10.5.0]
• node [21.7.1]
• gem [3.5.6]
• bundler [2.5.6]

问题情况 #

按官方文档完成React Native环境搭建后，执行npm run ios可在模拟器和真机上成功构建，但通过Xcode直接构建时，报错：

Compile app_vers.c(arm64) 0.1 seconds
'Debug-iphoneos/AmplifyRTNCore/AmplifyRTNCore.modulemap' not found

已尝试的方案 #

• 删除node_modules，重新执行npm i → cd ios → bundle exec pod install → cd .. → npx pod-install
• 在Rosetta模式下运行VSCode和终端（无法对Xcode操作）
• 将min_ios_version_supported更新为11.0和13.0
• 删除~/Library/Developer/Xcode/DerivedData及其他网上常见方案

可行解决步骤 #

1. 修正Podfile配置 #

在iOS目录的Podfile中添加以下配置，确保Amplify相关组件以正确方式构建：

pre_install do |installer|
  installer.pod_targets.each do |pod|
    if pod.name.eql?('AmplifyRTNCore') || pod.name.start_with?('Amplify')
      pod.build_configurations.each do |config|
        config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
      end
    end
  end
end

2. 彻底清理依赖与缓存 #

执行以下命令完成全量清理后重新安装依赖：

# 清理Node端依赖
rm -rf node_modules package-lock.json
npm install

# 清理iOS端Pod依赖
cd ios
rm -rf Pods Podfile.lock
bundle exec pod deintegrate
bundle exec pod install --repo-update
cd ..

# 清理Xcode构建缓存
rm -rf ~/Library/Developer/Xcode/DerivedData

3. 调整Xcode项目构建路径 #

打开Xcode，进入项目的Build Settings：

• 搜索Framework Search Paths，确保包含$(inherited)和$(PROJECT_DIR)/Pods/AmplifyRTNCore
• 搜索Module Map Search Paths，添加$(BUILT_PRODUCTS_DIR)/AmplifyRTNCore

4. 验证Amplify版本兼容性 #

尝试升级Amplify到最新稳定版，确保与React Native版本匹配：

npm update aws-amplify @aws-amplify/react-native

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