Azure Pipelines构建Ionic Capacitor应用Xcode报找不到Capacitor模块

云上老周

2026-8-28

问题原因

报错no such module 'Capacitor'由两处流水线配置错误直接导致：

Xcode构建任务的工作目录配置错误。当前Xcode任务的cwd指向ProjectName/MobileApp/ProjectName/ios/App/App，这个路径是存放iOS源码（包括AppDelegate.swift）的子目录，不是Xcode工程文件所在的目录。Capacitor生成的iOS项目中，CocoaPods安装完成后生成的.xcworkspace工作区文件存放在上一级的ProjectName/MobileApp/ProjectName/ios/App目录（也就是你执行pod install的目录），工作目录配置错误会导致Xcode无法加载Pods目录下的依赖。
Xcode任务未指定使用CocoaPods生成的工作区构建。执行pod install后必须通过.xcworkspace文件启动构建才能加载第三方依赖，默认直接找.xcodeproj构建时不会链接Pods下的Capacitor模块，必然触发模块找不到的错误。

修复方案

调整Xcode任务配置，修正工作目录并指定正确的构建目标：

将Xcode@5任务的cwd参数修改为和CocoaPods任务一致的路径：ProjectName/MobileApp/ProjectName/ios/App
补充xcWorkspacePath参数，指定使用CocoaPods生成的App.xcworkspace作为构建入口
补充scheme参数，指定构建Capacitor默认生成的App计划

修正后的Xcode任务配置如下：

- task: Xcode@5
  displayName: Xcode build
  inputs:
    signingOption: auto
    teamId: XXXXXXXX
    cwd: ProjectName/MobileApp/ProjectName/ios/App
    xcWorkspacePath: App.xcworkspace
    scheme: App

额外优化建议

不要在每次流水线执行时都运行npx cap add ios：如果仓库已经提交了生成好的ios目录，重复执行add会覆盖原有iOS项目配置；如果是流水线动态生成iOS目录，要确保npx cap sync ios执行完成、Podfile写入Capacitor依赖后再执行pod install操作。
如果修正配置后依然报错，可以在pod install步骤后增加一行ls Pods命令，检查Pods目录下是否存在Capacitor相关依赖目录，确认pod拉取依赖成功。