Expo裸工作流iOS应用构建报错：ld: library not found for -lAnalytics

核心排查步骤 #

• 区分npm安装与pod安装的流程差异
  你提到已运行npx install安装依赖，但这个命令仅会拉取node_modules下的JS依赖，不会触发iOS目录下的CocoaPods配置流程。需要手动进入项目的ios/目录，执行pod install完成原生依赖的拉取与配置注入，且安装完成后必须通过.xcworkspace文件启动Xcode，而非直接打开旧的.xcodeproj项目文件——后者不会加载CocoaPods注入的链接器搜索路径与库关联配置，即便Podfile.lock中存在Analytics依赖条目，也会出现链接阶段找不到库的问题。
• 校验项目导航中Library目录的Target绑定状态
  你观察到项目Library文件夹下已存在Analytics目录，但如果拖入目录时没有勾选对应Target的成员资格，也没有将库文件加入Link Binary With Libraries分组，这个目录仅会作为静态文件存在于项目导航中，不会参与编译、链接流程。

  注意：如果Analytics是通过CocoaPods安装的依赖，不需要手动将库文件拖入Link Binary With Libraries分组，手动添加的冗余条目反而会引发重复链接的冲突，遇到这类情况需要先删除所有手动添加的Analytics相关库条目，让CocoaPods自动完成链接配置。

• 清理错误缓存与残留路径配置
  1. 触发Xcode深度清理：按住Option键，在Xcode菜单栏选择Product > Clean Build Folder，清除旧的构建缓存。
  2. 删除iOS目录下的Pods/文件夹与旧Podfile.lock，重新执行pod install，排除旧配置残留导致的路径错配。
  3. 检查项目Build Settings中的Library Search Paths配置项：确认没有残留的、指向旧版本Analytics路径的硬编码绝对路径，CocoaPods生成的搜索路径应该是$(inherited)开头的相对引用，多余的错误硬编码路径会直接导致链接器找不到目标库。
• 专项校验Expo/UniModules的配置完整性
  1. 确认安装的Expo Segment包版本与当前项目的Expo SDK版本匹配，版本不兼容时对应的podspec不会正确声明库的链接规则，会触发链接找不到的问题。
  2. 重新执行npx expo prebuild --clean，重新生成原生项目的配置文件，避免eject流程中漏注入Segment模块的链接配置。

内容的提问来源于stack exchange，提问作者Tevon Strand-Brown