一、先说结论
老工程在 iPhone Duo 模拟器上跑不起来,通常不是代码问题,也不是 Xcode 装坏了,而是三件事叠在一起:
- Xcode 27.1 带的 iOS 27.1 模拟器运行时只有 arm64,不能跑 x86_64 模拟器包;
- 老工程当年为了兼容旧三方库,普遍写着「模拟器构建排除 arm64」,这条设置会让 Duo 直接从运行目标列表里消失;
- 依赖链里还有几个音视频、分享、崩溃上报类 SDK 只发布真机切片,放开 arm64 之后立刻变成链接失败。
对应的解法是三段:先让 Duo 成为可用的运行目标,再把只有真机切片的依赖从模拟器构建里摘出去,最后用同名替身库顶住大量调用点。真机包不受影响。
说明:下面的工程名、SDK 名均为虚构示例(MyApp、VideoKit、ShareKit),替换成自己的实际名字即可,思路完全一致。
二、典型现象,先对号入座
在 Xcode 27.1 上打开老工程,通常会依次撞到下面四种情况,每一种的原因完全不同:
- 现象一:运行目标选择器里根本没有 iPhone Duo,只有老的模拟器。
- 现象二:手动选上之后,编译阶段报找不到模块、找不到某个类型的 Swift 声明。
- 现象三:编译过了,链接阶段报「为模拟器构建,却链接了为真机构建的目标文件」。
- 现象四:链接也过了,装进模拟器一启动就退出,日志里是动态库加载失败、内存映射错误。
先把运行目标列出来看一眼,比在 Xcode 界面里反复点更可靠:
xcodebuild -workspace MyApp.xcworkspace -scheme MyApp -showdestinations
如果这是唯一一台只支持 arm64 的设备、且它不在列表里,基本就锁定下一节的架构排除问题了。
三、第一步:确认这是 arm64-only 的运行时
判断依据要看运行时本身,而不是工程配置:
xcrun simctl list runtimes
找到运行时目录后,直接看里面的动态链接器:
arduino
lipo -info "/Library/Developer/CoreSimulator/Profiles/Runtimes/iOS 27.1.simruntime/Contents/Resources/RuntimeRoot/usr/lib/dyld_sim"
输出只有 arm64,说明这个运行时只能加载 arm64 的模拟器程序,x86_64 包再怎么配也起不来。
因此凡是历史上「用 x86_64 模拟器包跑老库」的方案,在 Duo 上全部失效。这一步确认完,后面所有配置都围绕 arm64 模拟器构建展开。
四、第二步:让 Duo 重新出现在运行目标列表里
现象一的根因几乎都是架构排除设置。老工程里常见这一行:
css
EXCLUDED_ARCHS[sdk=iphonesimulator*] = arm64
它当年解决的是「某些老库没有 arm64 模拟器切片」的问题。但在 arm64-only 的运行时上,这行设置等于把所有 arm64 模拟器设备从列表里摘掉。
修改要点有两个:
- 只在真机配置下保留这条排除规则,模拟器配置下必须删掉;
- 不能手改生成出来的配置文件,因为每次安装依赖都会被重写。要写进依赖安装的后置钩子里:
ruby
# Podfile
SIM_BUILD = ENV['SIM_BUILD'] == '1'
post_install do |installer|
Dir.glob(File.join(installer.sandbox.root, 'Target Support Files',
'Pods-MyApp', 'Pods-MyApp.*.xcconfig')).each do |path|
content = File.read(path)
# 先清掉旧规则,再按配置写回,避免重复和残留
content = content.gsub(/^EXCLUDED_ARCHS\[sdk=iphonesimulator\*\] = .*\n/, '')
content += "EXCLUDED_ARCHS[sdk=iphonesimulator*] = arm64\n" unless SIM_BUILD
File.write(path, content)
end
end
改完再跑一次 -showdestinations,Duo 应该就出现了。这时候先别急着跑,大概率会撞到现象二或现象三。
五、第三步:分清哪个依赖卡在哪一层
这是整件事最费时间的部分,不要凭经验猜,按三个判据逐个确认。
1. 编译阶段失败:看 Swift 模块目录
带 Swift 接口的 SDK,产物里会有按「架构-平台」组织的模块目录:
bash
ls Pods/VideoKit/VideoKit.framework/Modules/VideoKit.swiftmodule
如果只有 arm64-apple-ios(真机),没有 arm64-apple-ios-simulator(模拟器),Swift 侧就会报找不到该类型声明,而 Objective-C 侧可能一切正常,很容易误判成业务代码问题。
2. 链接阶段失败:别看架构列表,看平台标记
sql
lipo -info Pods/ShareKit/ShareKit.framework/ShareKit
vtool -show-build Pods/ShareKit/ShareKit.framework/ShareKit
架构里列出 arm64,不代表能用在模拟器上。vtool 里的平台字段才决定归属:IOS 是真机,IOSSIMULATOR 是模拟器,链接器只认平台。
老工程的坑在于:有些老库的静态产物里,arm64 反而是真机对象,x86_64 才是模拟器对象。一旦模拟器构建放开 arm64,链接器就会拉到真机对象然后报错。
3. 加载阶段失败:确认切片是不是坏的
还有一种更隐蔽的情况:厂商确实提供了模拟器切片,但二进制本身有问题。对比段表即可判断:
perl
otool -l Pods/VideoKit/VideoKit.framework/VideoKit | grep -A4 LC_SEGMENT_64
正常情况,段的 fileoff 与 vmaddr 之间满足页对齐关系,相邻段的文件区间连续。如果出现「下一段的起始偏移比上一段末尾多出几个字节」这种错位,加载时就会内存映射失败(errno=22)。
这种问题换任何运行时、任何设备都一样报错,跟系统版本无关,唯一正确的处理方式是判定该切片不可用。
一个必须避开的假阳性
静态库和静态框架只有在符号真正被引用时才会被拉进链接。拿一个空工程去试链接,经常「成功」,但真实工程一链接就报错。
结论一定要用真实构建验证,或者加 -force_load / -ObjC 强制全量加载后再试。
六、第四步:在依赖清单上开一个开关
确认完阻塞项,开始动手。在 Podfile 里加一个环境变量开关:
ruby
# 不传环境变量 = 真机配置;SIM_BUILD=1 = 模拟器配置
SIM_BUILD = ENV['SIM_BUILD'] == '1'
target 'MyApp' do
use_frameworks!
# 普通依赖不受影响
pod 'NetworkKit', '4.0.1'
if SIM_BUILD
# 只有真机切片的 SDK,换成同名的本地替身
pod 'VideoKit', :path => './Stubs/VideoKit'
pod 'ShareKit', :path => './Stubs/ShareKit'
else
pod 'VideoKit', '~> 7.6'
pod 'ShareKit', '~> 6.11'
end
end
用法就两条命令,Podfile 不用改:
ini
pod install # 真机配置
SIM_BUILD=1 pod install # 模拟器配置
这样隔离得很干净:模拟器包怎么改,都不会影响真机链路。
还有一个细节:开关切换会重写依赖锁文件,必须保证随时能回到真机基线。要么把锁文件纳入版本库,要么单独留一份真机版本,切回来先恢复再安装,避免版本被被动升级。
七、第五步:调用点按数量排序,先易后难
依赖被剔除之后,调用它的代码就编不过了。排序原则很朴素:按调用点数量从少到多。
只有一两个文件引用的能力,直接在文件里加编译条件:
objc
#if !TARGET_OS_SIMULATOR
#import <VideoKit/VideoKit.h>
#endif
入口处给一个明确的占位,而不是静默失败:
objc
#if TARGET_OS_SIMULATOR
UILabel *tip = [[UILabel alloc] init];
tip.text = @"当前环境不支持该功能";
tip.textColor = UIColor.secondaryLabelColor;
[tip sizeToFit];
tip.center = CGPointMake(CGRectGetMidX(self.view.bounds),
CGRectGetMidY(self.view.bounds));
[self.view addSubview:tip];
#else
[self setupPlayer];
#endif
三条底线:真机分支代码保持原样、不动顺手重构;模拟器分支要有可见反馈;编译条件只包住真正依赖该 SDK 的代码。
如果 SDK 的能力有明确入口(比如崩溃上报),入口处直接短路即可,连占位都不需要。
八、第六步:用同名替身库顶住大量调用点
被十几个文件引用的 SDK,逐个加编译条件成本极高,而且会让业务代码里到处是平台判断。
更省成本的做法是在依赖边界做一个替身:名字和原库一致、头文件路径一致、实现全空。
先从原库复制公开头文件到替身目录,目录结构大致是:
makefile
Stubs/VideoKit/
├── VideoKit.podspec
├── VideoKitStub.m
└── include/VideoKit/*.h
podspec 关键就几行:
ruby
Pod::Spec.new do |s|
s.name = 'VideoKit'
s.version = '7.6.0-sim'
s.source_files = 'VideoKitStub.m', 'include/VideoKit/*.h'
s.public_header_files = 'include/VideoKit/*.h'
s.header_mappings_dir = 'include' # 保持 <VideoKit/xxx.h> 的引用路径不变
s.frameworks = 'AVFoundation', 'UIKit'
end
实现先从空方法起步:
objc
#import <VideoKit/VideoKit.h>
@implementation VideoPlayer
+ (instancetype)player {
return [[self alloc] init];
}
- (void)prepare {}
- (void)play {}
- (void)pause {}
- (void)stop {}
- (void)destroy {}
- (void)seekToTime:(int64_t)time {}
@end
空实现不等于运行安全
空实现能过编译、过链接,但运行时只要业务代码给替身对象发一条「头文件里有、实现里没有」的消息,就会崩在方法未实现上。播放器、分享这类被到处调用的对象尤其明显:首页能起来,一进详情页就闪退。
所以先用日志把漏掉的调用点捞出来:
objc
- (void)doesNotRecognizeSelector:(SEL)aSelector {
NSLog(@"[VideoKitStub] 未实现的接口:%@", NSStringFromSelector(aSelector));
}
补接口时有个省力的规律:头文件里声明过的属性会自动生成存取器,真正要手写的是普通方法------构造、播放控制、配置读写、上一首下一首这类。
还有一条必须记住:兜底只适合兜「没有返回值」的调用。有返回值的接口漏掉,调用方拿到的是未定义值,返回对象时后续一发消息就会崩。所以有返回值的接口必须逐条实现,比如配置读取:
objc
- (PlayerConfig *)getConfig {
if (!_config) {
_config = [[PlayerConfig alloc] init];
}
return _config;
}
原则一句话:替身负责不崩,不负责能用。崩溃和「功能没反应」必须能区分开,否则适配时会一直在排假故障。
九、第七步:把「暂时没有」的能力写清楚
替身方案本质是拿功能换进度,边界必须提前说明:
- 依赖音视频 SDK 的实时通话与播放:模拟器不可用;
- 依赖第三方登录、分享 SDK 的平台分享:模拟器不可用;
- 崩溃上报、日志上报:模拟器不上报,本地日志仍然可看;
- 其余纯 UI、网络、缓存能力:完全正常。
写在项目使用说明里,比写在提交记录里有效得多。
十、验收:四关都过了才算完
xml
# 1. 模拟器包能装、能起
xcrun simctl install <UDID> build/Debug-iphonesimulator/MyApp.app
xcrun simctl launch <UDID> com.example.myapp
- 主要页面逐个进入,没有「方法不存在」导致的崩溃;
- 切回真机配置后重新安装依赖,真机构建通过,功能与改动前一致;
- 依赖锁文件里的版本与改动前一致,没有被动升级。
第 3、4 条最容易被忽略。替身和条件编译一旦漏掉真机分支,问题往往要拖到发版前才暴露。
十一、适用边界
适用:新机型模拟器刚上线,核心 SDK 短期不会提供对应切片,但团队需要先把界面和交互在新尺寸、新形态上跑起来。
不适用:需要验证真实音视频链路、支付、推送到达率等强依赖厂商 SDK 的场景,这些只能在真机上验证。
如果暂时没有真机,用模拟器做布局适配是可行的,但要清楚这是「近似验证」:尺寸和分屏形态接近,性能、账号链路、大量系统能力仍然缺失。最终确认仍然要在真机上做。
十二、一句话总结
老的配置把 Duo 挡在了运行目标之外,老的依赖把 arm64 模拟器构建挡在了链接阶段。
解法不是等厂商,而是:脚本里管住架构排除规则,依赖清单上加开关,代码里做最小桩,依赖边界上做同名替身。让模拟器包能跑界面,让真机包保持原样。