向已有Ionic 5项目添加iOS端时报错：找不到对应package的podspec文件

1. 校验插件package.json的Capacitor配置 #

Capacitor通过package.json中的capacitor节点读取iOS端配置，需确保配置与你的文件路径完全匹配：

{
  "name": "test1",
  "capacitor": {
    "ios": {
      "src": "./", // podspec放在根目录填./，放在ios文件夹填ios
      "podspecName": "Test1.podspec" // 与实际podspec文件名完全一致，区分大小写
    }
  }
}

2. 检查podspec文件合法性 #

• 确认podspec文件内的name字段值与报错提示的Test1完全匹配，大小写无差异
• 在插件根目录执行以下命令校验podspec语法和配置正确性，按输出提示修复问题：
  pod spec lint Test1.podspec

3. 确认npm发布包含对应文件 #

• 检查插件根目录的.npmignore文件，确保没有排除podspec文件和ios目录
• 也可直接在package.json中通过files字段声明需要发布的资源：

{
  "files": [
    "ios/",
    "Test1.podspec",
    "dist/"
  ]
}

• 执行npm pack命令生成发布包，解压后确认内部文件路径、名称和配置一致

4. 本地测试验证 #

修复后无需反复发布npm，可通过软连接本地测试：

• 在插件根目录执行npm link
• 在Ionic项目目录执行npm link test1
• 执行ionic cap sync ios验证问题是否解决，验证通过后再发布新版到npm

临时解决方案 #

如果需要快速调试，可手动修改Ionic项目中ios/App/Podfile，新增一行配置指定pod路径：

pod 'Test1', :path => '../../node_modules/test1'

之后进入ios/App目录执行pod install即可正常编译。

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