React Native iOS集成SquareReaderSDK报错:Module 'SquareReaderSDK'未找到
解决SquareReaderSDK模块找不到的问题
- 检查框架嵌入配置:确认「Frameworks, Libraries, and Embedded Content」中SquareReaderSDK的嵌入选项为「Embed & Sign」,而非「Do Not Embed」——错误的嵌入模式会导致Xcode无法识别模块。
- 验证框架路径与搜索设置:
- 确保SquareReaderSDK框架的存放路径不含中文、空格或特殊字符,Xcode对这类路径兼容性较差。
- 在项目「Build Settings」中搜索「Framework Search Paths」,添加框架所在文件夹的路径,并设置为「Recursive」递归搜索。
- 重新处理Pod依赖:
- 进入项目iOS目录,执行
pod deintegrate清空现有Pod配置,再运行pod install重新安装依赖。确认Podfile中已正确声明react-native-square-reader-sdk,且平台版本设置为iOS 13.0及以上(Square Reader SDK最低要求)。
- 进入项目iOS目录,执行
- 适配模拟器架构:
- Square Reader SDK部分版本对模拟器架构支持有限,可尝试切换至真机测试;若需用模拟器,在项目「Build Settings」的「Excluded Architectures」中,为Debug模式添加
arm64架构。
- Square Reader SDK部分版本对模拟器架构支持有限,可尝试切换至真机测试;若需用模拟器,在项目「Build Settings」的「Excluded Architectures」中,为Debug模式添加
- 核对模块导入语法:
- Swift文件中确保使用
import SquareReaderSDK,Objective-C文件则用#import <SquareReaderSDK/SquareReaderSDK.h>,避免拼写错误。
- Swift文件中确保使用
- 确认版本兼容性:
- 检查react-native-square-reader-sdk 1.4.3与React Native 0.72.3的适配性,必要时升级或降级SDK版本以匹配RN版本。
内容的提问来源于stack exchange,提问作者Muneeb Qureshi
相关产品推荐
相关产品推荐

