https://github.com/lengain/cocoapods-podgenerate
CocoaPods Performance Acceleration Plugin
https://github.com/lengain/cocoapods-podgenerate
cocoapods-plugin
Last synced: 13 days ago
JSON representation
CocoaPods Performance Acceleration Plugin
- Host: GitHub
- URL: https://github.com/lengain/cocoapods-podgenerate
- Owner: lengain
- Created: 2026-06-13T12:23:09.000Z (20 days ago)
- Default Branch: main
- Last Pushed: 2026-06-17T15:22:08.000Z (16 days ago)
- Last Synced: 2026-06-18T09:25:45.115Z (15 days ago)
- Topics: cocoapods-plugin
- Language: Objective-C
- Homepage:
- Size: 302 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# cocoapods-podgenerate 🚀
**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 三方对照及增量/首轮双维度对比。
---
---
## 使用方式
### 安装
```bash
gem install cocoapods-podgenerate
```
要求 Ruby >= 3.0、CocoaPods >= 1.10.0。
### 在 Podfile 中启用
```ruby
plugin 'cocoapods-podgenerate'
```
### 执行
```bash
pod install
```
插件会自动激活并输出性能报告。
### 调试模式
```bash
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` |
```bash
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` 过程
### Flutter 集成注意
本插件强制启用 `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 项目树刷新** |
## License
MIT