arm64架构编译时libNDPlayer.a出现Undefined symbols报错如何解决

对应报错截图：

定位步骤 #

• 校验静态库架构支持情况
  执行命令 lipo -info libNDPlayer.a，确认输出中是否包含arm64，如果没有说明该库未适配arm64架构，是符号缺失的常见原因
• 确认符号在arm64切片中的存在状态
  执行命令 nm -arch arm64 libNDPlayer.a | grep "_CODE_Decoder"，根据输出结果判断问题类型：
  • 无输出：arm64架构下该符号确实不存在，属于库本身功能缺失
  • 输出前缀为U：该符号在libNDPlayer.a中未定义，需要依赖外部其他库提供实现
  • 输出前缀为T：符号在库中正常存在，属于链接参数配置错误
• 排查链接参数配置
  检查编译脚本或者IDE的链接配置，确认libNDPlayer.a是否已被正确加入链接列表，以及其所依赖的编解码相关框架、子库是否完整引入

修复方案 #

库架构/符号缺失场景 #

• 优先联系libNDPlayer.a的提供方索要适配arm64架构、且包含完整摄像头编解码功能的版本，是最稳妥的解决方案
• 若无法获取适配版本，且项目无强制arm64运行要求，可以在项目构建设置的Architectures字段中移除arm64，仅保留该库支持的架构编译，该方案不适用于需要上架应用商店的移动端项目
• 检查库的集成文档，确认摄像头功能是否需要额外引入对应的子库，如果有遗漏补全对应子库的链接配置

链接配置错误场景 #

• 调整静态库链接顺序，将libNDPlayer.a放在所有依赖它的源文件、其他静态库的后方，链接器按传入顺序解析符号，被依赖方放在后方才能被正常检索
• 补全依赖的系统框架，若该符号对应硬解码实现，iOS端需要补充链接VideoToolbox、CoreMedia、CoreVideo等系统多媒体框架，Linux端需要确认是否已经引入ffmpeg、v4l2等相关编解码依赖库

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