仅在模拟器出现Undefined symbol: _OBJC_CLASS_$_bleconfigLibrary错误求助

问题现象 #

在模拟器运行代码时，执行handleRequest = [bleconfigLibrary alloc];触发错误：

Undefined symbol: _OBJC_CLASS_$_bleconfigLibrary

真机设备可正常运行，注释该代码段后模拟器也能正常运行。

原因分析 #

核心原因是**bleconfigLibrary的实现未被包含在模拟器编译环境中**，常见场景：

• 该类依赖蓝牙硬件相关的私有API或第三方库，这类库仅提供了真机架构（arm64/armv7）的编译版本，未包含模拟器所需的x86_64（Intel Mac）或arm64（Apple Silicon Mac）架构。
• 项目的Target配置不一致：真机Target的Build Phases中包含了bleconfigLibrary的实现文件/库，但模拟器Target未添加。

解决方案 #

1. 检查库的支持架构

如果bleconfigLibrary是静态库/Framework，打开终端执行以下命令查看支持的架构：

lipo -info /path/to/bleconfigLibrary.framework/bleconfigLibrary

若输出中没有x86_64或arm64，说明库不支持模拟器：

• 若为自研代码：修改项目Build Settings中的Architectures，确保包含模拟器架构；
• 若为第三方库：联系提供者获取支持全架构的版本，或自行合并真机与模拟器版本（使用lipo命令合并）。

2. 统一Target配置

• 选中bleconfigLibrary的实现文件（.m/.mm），查看右侧Target Membership，确保模拟器对应的Target被勾选；
• 进入项目的Build Phases > Link Binary With Libraries，检查模拟器Target是否添加了bleconfigLibrary相关库，保证真机与模拟器配置一致。

3. 条件编译规避模拟器执行

如果不需要在模拟器中测试蓝牙功能，可通过条件编译跳过初始化代码：

+ (void)initialize{
    #if TARGET_OS_IOS && !TARGET_OS_SIMULATOR
        handleRequest = [bleconfigLibrary alloc];
    #endif
}

此方案会让模拟器编译时跳过该代码段，既解决报错，又不影响真机逻辑。

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