M1芯片Xcode编译模拟器遇到的坑

最新推荐文章于 2025-05-16 15:06:42 发布

CoderDCLiu

最新推荐文章于 2025-05-16 15:06:42 发布

阅读量6.4k

点赞数 1

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/CoderDCLiu/article/details/121795637

iOS 同时被 3 个专栏收录

10 篇文章

订阅专栏

Objective-C

9 篇文章

订阅专栏

macOS

2 篇文章

订阅专栏

在M1芯片的Mac上，使用Xcode12编译iPhone12 iOS14模拟器时遇到编译失败，原因是静态库缺少arm64架构。解决方案包括以Rosetta模式运行Xcode或使用XCFramework。通过XCFramework，可以合并不同指令集的库，解决M1机器上编译模拟器的问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

M1芯片Xcode编译模拟器遇到的坑

前言：公司最近换了M1的电脑，用真机调试的时候没发现问题，Xcode12用模拟器编译iPhone12(iOS14)的时候，编译无法通过，那问题是什么，如何解决呢

1.编译失败会出现如下问题

ld: warning: ignoring file YoupPth/Build/Products/Debug-iphonesimulator/FMDB/FMDB.framework/FMDB, 
building for iOS Simulator-x86_64 but attempting to link with file built for iOS Simulator-arm64
Undefined symbols for architecture x86_64:
  "_OBJC_CLASS_$_FMDatabaseQueue", referenced from:
      objc-class-ref in SqflitePlugin.o
ld: symbol(s) not found for architecture x86_64

这是因为项目中存在.a或者.framework静态库。以前在Intel芯片电脑上，静态库会打包出真机(arm64）和模拟器(x86_64)两种架构类型的库，真机会使用arm64架构的，模拟器会使用x86_64架构的，现在因为M1芯片用的是arm64架构，所以模拟器要使用arm64架构的，但是打包出来的真机arm64架构版本的无法给模拟器使用，所以就会出现以上的问题

2.如何解决

1.以Rosetta模式运行Xcode,在应用程序中找到Xcode,右键，点击显示简介，勾选“使用Rosetta打开”

请添加图片描述
2.选中项目工程project,找到Build Setting -> Architectures -> Exclude Architectures 添加 Any iOS Simulator 选项，设置为arm64

问题解决了，编译成功

3.问题后续

1.以Rosetta模式运行是M1机器上x86软件无法运行的解决方案，它会将x86指令转译成ARM指令运行，这种转译显然是存在性能损耗的，损耗大概在20%～30%
2.在intel机型上，模拟器本来就是以x86方式运行的，排除arm64毫无影响。但是在M1机型上，模拟器是以arm64方式运行的，排除了arm64反而能跑,请看下图模拟器的cpu使用M1芯片
模拟器上面的应用使用Intel芯片
所以，神奇的是，模拟器使用了M1芯片arm64架构，但是模拟器上的应用，使用的是Intel芯片x86_64架构

4.最优解

在我们创建静态库时，选择真机编译出来的包只包含arm64指令，选择模拟器编译出来的会同时包含arm64和x86_64指令。

2019年的WWDC，apple提供了一种新的框架封装格式XCFramework。简单理解就是以前使用lipo合并不同指令集的包，现在则使用新的指令合并成XCFramework格式。

XCFramework就是把两个不同指令集的framework放入了同一个文件夹(.xcframework)，并生成了一个配置文件Info.plist。这样生成的XCFramework就可以完美的解决M1机器无法编译模拟器的问题。

XCFramework的创建指令

# -- 针对.a --
# 指令：
xcodebuild -create-xcframework -library <path> [-headers <path>] [-library <path> [-headers <path>]...] -output <path>
# 样例：
xcodebuild -create-xcframework -library youpath/TestFramework.a -headers youpath/TestFramework -library youpath/TestFramework.a -headers youpath/TestFramework -output youpath/TestFramework.xcframework

# -- 针对.framework --
# 指令：
xcodebuild -create-xcframework -framework <path> [-framework <path>...] -output <path>
# 样例：
xcodebuild -create-xcframework -framework Release-iphoneos/TestFramework.framework -framework Release-iphonesimulator/TestFramework.framework -output TestFramework.xcframework

本文参考此篇文章