ARM macOS配置CocoaPods报错无法启动iPhone 12 Pro Max应用怎么办

报错信息 #

Error: To set up CocoaPods for ARM macOS, run:
arch -x86_64 sudo gem install ffi

Error running pod install
Error launching application on iPhone 12 Pro Max.

分步解决流程 #

1. 安装ARM架构适配所需的ffi依赖 #

打开终端直接执行报错提示的命令，输入开机密码时终端不会显示字符，正常输入完成后回车即可：
arch -x86_64 sudo gem install ffi

如果安装过程报权限错误，优先通过Homebrew安装独立版本Ruby，不要修改系统自带Ruby的目录权限，避免触发macOS SIP保护拦截。

2. 修复pod install执行失败问题 #

• 进入项目iOS目录，即和Podfile文件同层级的路径：cd 你的项目本地路径/ios
• 清理旧的缓存和残留依赖文件，依次执行以下命令：

pod deintegrate
pod cache clean --all
rm -rf Pods Podfile.lock build

• 以x86兼容模式执行依赖安装：arch -x86_64 pod install
• 如果安装时提示索引库过时，先执行pod repo update更新本地依赖索引后再重新执行安装命令。

3. 修复无法在iPhone 12 Pro Max模拟器启动应用问题 #

• 打开Xcode设置，进入Locations tab，确认Command Line Tools已选中当前安装的Xcode版本，不要留空。
• 通过iOS目录下的.xcworkspace文件打开项目（不要打开.xcodeproj后缀的文件），选中项目Target，进入Build Settings配置页，找到Excluded Architectures项，在Debug模式的Any iOS Simulator SDK选项下添加arm64，解决模拟器架构冲突问题。
• 清理Xcode缓存后重新选中对应模拟器启动项目即可。

优化配置（可选） #

如果不想每次执行pod命令都加arch -x86_64前缀，可以给终端开启Rosetta转译：

• 找到终端应用在访达中的位置，右键点「显示简介」，勾选「使用Rosetta打开」，重启终端后即可直接执行pod相关命令。

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