CocoaPods

本文是系列第三篇，基于 CocoaPods 1.16.2 源码。上一篇我们停在 Analyzer 产出 AnalysisResult，本文继续走完 download_dependencies → validate_targets → generate_pods_project → integrate_user_project → write_lockfiles 这五个阶段。 上一篇：从命令到依赖求解 · 首篇：架构总览 一、全景：从 spec 到可编译的工程 先把本文要走的流程重新放一遍，让你带着地图读代码： flowchart TB A[AnalysisResult] --> B[download_dependencies] B -->|per pod| B1[PodSourceDownloader] B1 -->|命中| C1[Downloader::Cache] B1 -->|未命中| C2[cocoapods-downloaderGit/HTTP/SVN/...] C2 --> C3[rsync → Pods/<name>/] B -->|per pod| B2[PodSourceInstaller] B2 --> B3[PodSourcePreparerprepare_command] B2 --> B4[PodDirCleaner按 spec.source_files 裁剪] B --> D[validate_targetsTargetValidator#validate!] D --> E[generate_pods_project] E --> E1[ProjectCacheAnalyzer增量识别要重生成的 target] E --> E2[SinglePodsProjectGenerator#generate!] E2 --> E21[FileReferencesInstaller] E2 --> E22[PodTargetInstaller] E2 --> E23[AggregateTargetInstaller] E2 --> E24[xcconfig / modulemap / umbrella / info.plist / dummy.m] E --> E3[PodsProjectWriter#write!写盘前触发 Podfile post_install] E --> F[integrate_user_project] F --> F1[create_workspace写 .xcworkspace] F --> F2[deintegrate_removed_targets] F --> F3[TargetIntegrator#integrate!xcconfig / frameworks / scripts] F --> G[write_lockfiles] G --> G1[Podfile.lock] G --> G2[Pods/Manifest.lock] G --> H[perform_post_install_actionsplugin post_install hook] 对应的 Installer#install! 片段： ...

本文是系列第二篇，基于 CocoaPods 1.16.2 源码。我们从 bin/pod 进场，走完 CLAide 的命令分发、Podfile 的 DSL 求值、Analyzer 的七步分析、Resolver + Molinillo 的回溯求解，最后交付 AggregateTarget/PodTarget 给下一篇讲的下载与集成。 上一篇：架构总览 · 下一篇：从下载到工程集成 运行示例贯穿全文：pod install --repo-update 一、bin/pod：16 行的入口 CocoaPods 的可执行文件非常薄，核心逻辑全在 require 'cocoapods' 之后的 Pod::Command.run： # CocoaPods/bin/pod : 24 if $PROGRAM_NAME == __FILE__ && !ENV['COCOAPODS_NO_BUNDLER'] ENV['BUNDLE_GEMFILE'] = File.expand_path('../../Gemfile', __FILE__) require 'rubygems' require 'bundler/setup' $LOAD_PATH.unshift File.expand_path('../../lib', __FILE__) elsif ENV['COCOAPODS_NO_BUNDLER'] require 'rubygems' gem 'cocoapods' end STDOUT.sync = true if ENV['CP_STDOUT_SYNC'] == 'TRUE' require 'cocoapods' if profile_filename = ENV['COCOAPODS_PROFILE'] # 开 ruby-prof 做性能剖析 # ... reporter.new(RubyProf.profile { Pod::Command.run(ARGV) }).print(io) else Pod::Command.run(ARGV) end 这里有两个工程化细节值得留意： ...

本系列基于 CocoaPods 1.16.2（2026 年 4 月）源码进行分析。源码仓库由 15 个 Ruby Gem 组成，本文先从整体架构与职责拆分讲起，再以 pod install --repo-update 为主线绘制全景执行图，串起后续两篇专题的切入点。 系列目录： 架构总览（本文） 从命令到依赖求解 从下载到工程集成 一、CocoaPods 不是单一仓库 很多人以为 CocoaPods 就是一个 Ruby 项目，其实官方仓库 CocoaPods/CocoaPods 只是入口，真正的能力被拆成 15 个独立 gem，每个 gem 只做一件事。用 gem dependency cocoapods 会看到这样的依赖拓扑： graph TB subgraph "入口" A["bin/pod(CocoaPods gem)"] end subgraph "命令行框架" B["CLAideCommand/Arg/Option DSL"] end subgraph "领域模型" C["CorePodfile/Podspec/Source/Lockfile"] end subgraph "依赖求解" D["Molinillo回溯式 SAT 求解器"] end subgraph "下载" E["cocoapods-downloaderGit/HTTP/SVN/Hg/SCP"] end subgraph "Xcode 工程读写" F["Xcodeprojpbxproj/xcconfig/workspace"] G["NanaimoASCII plist 解析"] end subgraph "插件与子命令" H["cocoapods-plugins"] I["cocoapods-trunkcocoapods-searchcocoapods-trycocoapods-deintegrate"] end subgraph "辅助" J["cork彩色输出"] K["nap轻量 HTTP 客户端"] end A --> B A --> C A --> D A --> E A --> F F --> G A -.加载.-> H H -.调用.-> I A --> J I --> K 各 gem 的一句话职责： ...