如何为Flutter插件添加私有CocoaPods库？

问题分析 #

你遇到的报错是因为依赖项目的Podfile默认仅加载官方CocoaPods源，私有Example库的spec不在这个源中，因此pod install无法找到对应的依赖。本地pod search能找到是因为你的本地CocoaPods repo已经添加了私有源，但其他环境（或其他用户）的Podfile不会自动包含这个私有源。

解决方案 #

方案1：直接在podspec中指定私有库的Git源（推荐） #

不需要依赖私有CocoaPods repo，直接在插件的example/ios/example.podspec中修改依赖配置，让CocoaPods直接从Git拉取私有库：

# 替换原来的s.dependency配置，移除多余的s.source（s.source是插件自身的源，不是依赖的源）
s.dependency 'Example', :git => 'https://github.com/example.git', :tag => '0.0.1'

这样配置后，依赖项目无需额外修改Podfile，只要在pubspec.yaml中引入你的插件，pod install会自动从指定Git地址拉取Example库，完全符合你想要的无额外配置的需求。

方案2：自动向依赖项目的Podfile添加私有源（适合必须用私有CocoaPods repo的场景） #

如果必须通过私有CocoaPods repo管理Example库，可以通过插件的podhelper.rb自动给依赖项目的Podfile添加私有源：

1. 在插件的ios目录下创建或修改podhelper.rb文件，添加以下代码：

def add_private_pod_source
  podfile_path = File.join(Dir.pwd, 'Podfile')
  return unless File.exist?(podfile_path)

  podfile_content = File.read(podfile_path)
  private_source = "source 'https://github.com/example.git'"
  official_source = "source 'https://cdn.cocoapods.org/'"

  # 避免重复添加私有源
  unless podfile_content.include?(private_source)
    if podfile_content.include?(official_source)
      # 在官方源前插入私有源（CocoaPods会按顺序查找源）
      new_content = podfile_content.gsub(official_source, "#{private_source}\n#{official_source}")
    else
      new_content = "#{private_source}\n#{podfile_content}"
    end
    File.write(podfile_path, new_content)
  end
end

add_private_pod_source

2. 插件的pubspec.yaml保持正常iOS配置即可，Flutter会自动执行这个podhelper.rb脚本，在pod install时自动修改依赖项目的Podfile，添加私有源。

注意事项 #

• 方案1更简洁，无需维护私有CocoaPods repo，适合大多数场景；
• 方案2会修改用户的Podfile，必须做好重复添加的判断，避免冗余配置；
• 不要在插件的example/ios/Podfile中直接添加源，那只是插件自身示例项目的配置，不会影响依赖该插件的外部项目。

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