iOS项目中自定义框架集成外部库后运行时加载失败的解决方案咨询

嗨，我之前也踩过这个一模一样的坑！自定义框架里集成了SocketIO，测试APP编译明明成功了，结果一运行就报找不到框架的错误，折腾了好一阵才搞定，给你几个亲测有效的解决办法：

方案一：调整自定义框架的Podfile配置 #

先从最基础的配置入手，确保依赖是动态链接的：

• 打开自定义框架项目的Podfile，把原来的use_frameworks!改成use_frameworks! :linkage => :dynamic，这样SocketIO会被编译成动态框架，能被宿主APP正确识别
• 先执行pod deintegrate清理旧的依赖，再重新pod install，让配置生效

方案二：用Podspec管理自定义框架的依赖（推荐长期复用） #

如果你的自定义框架是要给其他项目用的，用Podspec管理依赖是最省心的方式，宿主APP引入时会自动拉取所需的第三方库：

• 在自定义框架的根目录新建一个MyCustomFramework.podspec文件，内容参考下面的模板：

Pod::Spec.new do |s|
  s.name         = "MyCustomFramework"
  s.version      = "1.0.0"
  s.summary      = "你的自定义框架的简短描述"
  s.license      = "MIT"
  s.author       = { "你的名字" => "你的联系邮箱" }
  s.platform     = :ios, "16.0"
  s.source       = { :path => "." }
  # 指定框架的源码文件路径
  s.source_files = "MyCustomFramework/**/*.{swift,h,m}"
  # 声明对SocketIO的依赖，版本和你之前用的保持一致
  s.dependency "Socket.IO-Client-Swift", "~> 16.1.1"
  s.swift_version = "5.0"
end

• 然后修改测试APP的Podfile，把原来手动引入框架的方式改成通过CocoaPods引用：

platform :ios, '16.0'
use_frameworks!

target '你的测试APP名称' do
  pod 'MyCustomFramework', :path => '../你的自定义框架项目的相对路径'
end

• 执行pod install，这样测试APP会自动安装SocketIO依赖，运行时就不会再报错了

方案三：手动给测试APP添加SocketIO框架（临时测试用） #

如果只是临时测试不想折腾Podspec，也可以手动把SocketIO框架加到测试APP里：

• 打开自定义框架项目，找到Pods/Frameworks下的SocketIO.framework
• 把这个框架拖拽到测试APP的Frameworks, Libraries, and Embedded Content列表中，选择Embed & Sign的嵌入类型
• 检查测试APP的Build Settings，确保Runpath Search Paths包含@executable_path/Frameworks和@loader_path/Frameworks（默认配置一般都有，保险起见确认一下）

最后再检查这几个点 #

• 确认自定义框架的Build Settings里，Mach-O Type设置为Dynamic Library
• 测试APP的Build Settings里，Always Embed Swift Standard Libraries设为YES
• 清理整个项目（快捷键Command+Shift+K），重新构建后再运行

内容来源于stack exchange