CocoaPods 性能加速插件 — 专为 150+ Pod 依赖的大型项目优化 pod install。
在使用 CocoaPods 管理 150+ 甚至更多 Pod 依赖的大型项目中，pod install 第3步（Generating Pods project） 和 第4步（Integrating client project） 是主要瓶颈。本插件通过多补丁协同工作，显著降低这些步骤的耗时。
测试环境：150 pods · 26源文件+3资源/pod · ObjC+Swift混编 · 6 targets · Apple M3 · v0.1.11
| 方案 | 插件来源 | Podfile plugin | 首次安装 | 增量安装 | 相对无插件加速 |
|---|---|---|---|---|---|
| A | 本地路径 | ✅ | 7.06s | 1.67s | +76.8% 🚀 |
| B | 无 | ❌ | 7.14s | 7.19s | 基准 |
| C | 生产 gem | ✅ | 7.24s | 1.70s | +76.4% 🚀 |
对比脚本见
example/compare.sh，包含 A/B/C 三方对照及增量/首轮双维度对比。
gem install cocoapods-podgenerate要求 Ruby >= 3.0、CocoaPods >= 1.10.0。
plugin 'cocoapods-podgenerate'pod install插件会自动激活并输出性能报告。
COCOAPODS_PODGENERATE_DEBUG=1 pod install输出示例：
[cocoapods-podgenerate] Performance Report:
Resolve dependencies 0.35s (2.5%)
Download dependencies 0.01s (0.0%)
Create and save projects 4.34s (30.8%)
Generate Pods project 4.38s (31.1%)
Integrate user project 0.02s (0.1%)
Write lockfiles 0.04s (0.3%)
Total install! 4.96s (35.2%)
PodGenerate/
├── cocoapods-podgenerate.gemspec # Gem 规范
├── Gemfile
├── lib/
│ ├── cocoapods_plugin.rb # CLAide 插件发现入口
│ └── cocoapods-podgenerate/
│ ├── cocoapods-podgenerate.rb # 入口，激活所有补丁
│ ├── command.rb # pod podgenerate CLI 命令
│ ├── hooks.rb # :pre_install hook
│ ├── patches/
│ │ ├── installer_patch.rb # 强制增量 + 跳过 + 并行集成 + 并行 schemes
│ │ ├── multi_project_generator_patch.rb # 并行 PodTargetInstaller (v0.1.2)
│ │ ├── project_patch.rb # pod_group 哈希缓存
│ │ ├── project_writer_patch.rb # 增量写入 + 并行 cleanup/schemes/save
│ │ ├── analyzer_patch.rb # 依赖解析缓存
│ │ ├── cache_analyzer_patch.rb # 并行 cache key 计算 (v0.1.2)
│ │ └── user_integrator_patch.rb# 多 target 并行集成 + 并行 xcconfig 警告
│ ├── parallel/
│ │ ├── thread_pool.rb # 线程池封装
│ │ └── batch_processor.rb # 批处理工具
│ └── benchmark/
│ └── profiler.rb # 性能分析器（含子步骤计时）
└── example/ # 性能测试框架
├── compare.sh # A/B/C 三方对比（首轮 + 增量）
├── enhance_pods.rb # 增强 pod 模板
├── generate_podfile.rb # 生成 150 个测试 pod
├── multi_target_test.rb # 多 target 场景测试
├── complex_podfile_test.rb # 复杂 Podfile 兼容性测试（abstract_target + inherit! + test_spec）
├── run_complex_test.rb # 复杂 Podfile 测试运行器
├── run_flutter_test.rb # Flutter 兼容性测试（内联 + load podhelper.rb 双模式）
├── run_flutter_integration_test.rb # Flutter Add-to-App 集成测试
├── run_with_plugin.rb # 手动加载插件运行（调试用）
├── Gemfile # ExampleA/C 的 Gemfile
├── ExampleA/ # 本地路径插件工程
├── ExampleB/ # 纯原生 CocoaPods 基准工程
└── ExampleC/ # 生产 gem 插件工程
项目包含完整的性能测试框架，支持三种方案的横向对比：
| 方案 | 说明 | 运行方式 |
|---|---|---|
| ExampleA | 本地路径插件 + Podfile plugin 声明 |
bundle exec pod install |
| ExampleB | 纯原生 CocoaPods（无插件）基准 | pod install |
| ExampleC | 生产 gem 插件 + Podfile plugin 声明 |
bundle exec pod install |
cd example
# 增强 pod 模板（添加更多源文件和资源）
ruby enhance_pods.rb
# 生成 150 个测试 pod
ruby generate_podfile.rb
# A/B/C 三方对比测试（首次干净安装 + 增量安装 + 性能表格）
bash compare.sh
# 手动调试：在指定 Example 目录运行
cd ExampleC && bundle exec pod install --verbose
# 多 target 场景测试（6 个 target）
ruby ../multi_target_test.rb
# 复杂 Podfile 兼容性测试（abstract_target + inherit! + test_spec 等）
ruby ../complex_podfile_test.rb
# Flutter 兼容性测试（内联 depends_on_flutter / load podhelper.rb）
ruby ../run_flutter_test.rb # Mode A: 内联
ruby ../run_flutter_test.rb --b # Mode B: load podhelper.rb
# Flutter Add-to-App 完整集成测试
ruby ../run_flutter_integration_test.rb注意：
compare.sh会自动管理系统 gem 的安装/卸载，确保 ExampleB 不被插件影响。运行过程中会临时卸载 cocoapods-podgenerate gem，运行完 B 后重新安装。
- CocoaPods: >= 1.10.0（已验证 1.16.2）
- Ruby: >= 3.0
- Platform: macOS（Xcode 项目集成）
- Flutter: ≥ v0.1.9 完全兼容 Flutter Add-to-App
load podhelper.rb集成模式 - Xcode 动态刷新: ≥ v0.1.12 每次
pod install都会更新 Pods 项目文件修改时间，触发 Xcode Dynamic Project Reloading（项目树自动刷新） - 不影响 Xcode 编译产物，仅优化
pod install过程
本插件强制启用 generate_multiple_pod_projects，这会导致 Xcodeproj 无法解析跨项目的 PBXTargetDependency 引用（dependency.target 返回 nil）。Flutter 的 depends_on_flutter 递归遍历依赖链时会因此崩溃。
v0.1.9+ 在 post-install hooks 执行前自动解析全部项目的跨项目依赖引用，确保 depends_on_flutter 递归遍历不会遇到 nil。如果你在 Flutter 项目中使用此插件，请使用 ≥ v0.1.11 版本（含 nil 保护）。
| 补丁 | 优化目标 | 步骤 | 引入版本 |
|---|---|---|---|
installer_patch.rb |
强制增量模式 + 跳过无变更生成 + 并行 integrate + 并行 configure_schemes | 3/4 | v0.1.1 |
project_patch.rb |
pod_group O(n) → O(1) 哈希缓存 | 3 | v0.1.1 |
project_writer_patch.rb |
SHA256 摘要比对 + 并行 cleanup/schemes/save | 3 | v0.1.1 |
analyzer_patch.rb |
依赖解析结果缓存 | 1 | v0.1.1 |
user_integrator_patch.rb |
多 target 并行集成 + 并行保存 + 并行 xcconfig 警告 | 4 | v0.1.1 |
multi_project_generator_patch.rb |
并行化 PodTargetInstaller（150 pod 同时安装） | 3 | v0.1.2 |
cache_analyzer_patch.rb |
并行 cache key MD5 计算 | 3 | v0.1.2 |
profiler.rb |
子步骤计时分析（调试） | 调试 | v0.1.2 |
| 版本 | 变更 |
|---|---|
| v0.1.0 | 初始版本 |
| v0.1.1 | 增量安装从 4.22s → 1.52s（+64%）；跳过无变更项目生成；并行集成 |
| v0.1.2 | 并行化 PodTargetInstaller + cache key + schemes；子步骤计时分析 |
| v0.1.3 | Bug fixes from audit |
| v0.1.4 | Comprehensive bug fix（包含 CocoaPods 1.16.2 ResolverSpecification 兼容修复） |
| v0.1.5 | （内部版本） |
| v0.1.6 | 正式发布 CocoaPods 1.16.2 兼容修复；增加 A/B/C 三方对比测试框架 |
| v0.1.7 | 修复 3 个并发 bug：pool.post rescue 绑定错误 + 线程异常裸传播 + analyzer_patch 缩进 |
| v0.1.8 | Flutter 兼容性：resolve_cross_project_dependencies + 跳过路径 @pods_project=nil 修复 |
| v0.1.9 | Flutter 兼容性加强：跨项目依赖解析扩展到全部 generated_projects |
| v0.1.10 | 代码审查改进：调试日志 + 统一 Flutter 测试脚本 |
| v0.1.11 | nil 保护：@pods_project 为 nil 时创建空项目降级，防止 post-install hook 崩溃 |
| v0.1.12 | Xcode 动态刷新修复：touch pbxproj 更新时间戳，确保增量安装后 Xcode 项目树刷新 |
MIT