夜雨聆风学习资料网

ARTICLE · 1394713

CocoaPods 谢幕:一个救过 iOS 的工具,正式被宣判只读

CocoaPods 谢幕:一个救过 iOS 的工具,正式被宣判只读

QUOTE

一个工具真正落幕的方式,从来不是停止运转,而是停止长大。

—— 10年iOSer

2026 年 12 月 2 日,一个给 iOS 生态扛了整整 15 年的工具,会被永久宣判只读。这件事,比一个工具的下线,要值得说得多。

本文看点

01

它当年救活了什么

02

SwiftPM 为什么接棒

03

项目该怎么为 AI 重设计

01

READ ONLY

一个用了 15 年的工具,被宣判「只读」

2026 年 12 月 2 日,CocoaPods 的 trunk 仓库会永久进入只读模式。

从那天起,任何人都没法再往上面提交一个新的 podspec,也没法给已有库推送一个新版本。官方会把 GitHub 上的 CocoaPods/Specs 仓库标记成Archived。

注意,不是「下线」,是「只读」。

这两件事差别很大。下线意味着现有的构建会崩,只读意味着,你手上那个项目,只要依赖的版本都已经发布过了,pod install 照样能跑,CI 照样能过,app 照样能上架。Specs 仓库和 CDN 会一直活着,只要 GitHub 和 jsDelivr 还活着,这俩基本不会倒。

真正停掉的,是新血的流动。

你项目里那个还在发版本的库,从这天起,它发到 CocoaPods 上的更新你再也收不到了,包括安全补丁。

这不是突然的决定。CocoaPods 的维护者 orta 其实在很早就写了博客,把时间线摊开给所有人看。2025 年 5 月,先封掉 Podspec 里那个被安全研究员反复拿来搞事情的 prepare_command 字段。2026 年 11 月 2 号到 6 号,做一次试运行,拒绝接收新 podspec,让那些自动化发布的东西提前炸掉、提前修。然后才是 12 月 2 号,正式、永久地关上门。

我算了下,离那天只剩11 天。

— 散落锈蚀的齿轮,象征旧生态的碎片化

一个给 iOS 生态扛了整整 15 年的工具,就这样被宣判了。你说它死了吗?没有,它还在。但它已经不会再长大了。

这件事本身,比一个工具的下线,要值得说得多。

02

HISTORY

它当年救活的,是一整个荒蛮的生态

现在的新 iOS 开发者可能很难想象,在 CocoaPods 出现之前,往项目里加一个第三方库是件多原始的事。

2011 年前后,你要用一个库,得自己去 GitHub 把源码下下来,手动拖进 Xcode 项目里,然后处理一堆乱七八糟的编译设置,链接标志、头文件搜索路径、资源文件。库更新了,你再手动替换一遍。不同库之间版本冲突了,你自己去人肉排。

— 机械臂把零散积木精准码放,象征从混乱到秩序

orta 在博客里回忆过那段日子,他管那个年代叫 fragmented islets,碎片化的小岛。ASIHTTPRequest、Three20、SBJson、SSToolkit、iCarousel,一个个孤零零的库,各自一套升级指令,各自一套复杂的构建配置。你每接一个,都是独立的一场小型战役。

然后 Eloy Durán 和 Fabio Pelosin 在 2011 年 8 月动手,9 月 1 号发了第一个公开版。这俩人参考的是 Ruby 世界的 RubyGems 和 Bundler,思路很朴素,Ruby 社区能这么优雅地管依赖,凭什么 Objective-C 不能?

「CocoaPods 干的事,说穿了就一句,把「手动复制源码」变成「写一行声明,剩下的它来」。」

它定义了 podspec,一种描述一个库该怎么被编译、怎么被集成的格式。它建了中央的 specs 仓库,让所有人都能往里提交自己库的元数据。它用 Podfile 声明依赖,用 Molinillo 做依赖解析,最后生成一个 .xcworkspace,把第三方代码和你的 app 代码焊在一起。

到 2016 年发 1.0 的时候,官方博客晒过一组数字。4 年半的时间,大约 400 个开发者,攒了差不多 2 万个 commit,关掉了 2 万多个 issue,积累到大概 1.9 万个 pod、8.6 万个版本。那时候它已经被用来集成了约2.85 亿个 pod进约 85 万个 Xcode target。

这组数字放到今天看依然吓人。它不是一个「挺好用的工具」,它是那十年里 iOS 代码得以流动、复用的地基。

没有它,AFNetworking 不可能那么快铺开,Objective-C 那波开源浪潮也不会滚得那么顺。它是真真正正,把一个生态从蛮荒带进了有秩序的时代。

03

SHERLOCKED

宿命循环:官方永远会来收编证明过价值的路

CocoaPods 的故事,真正有意思的其实不是它多伟大,而是它死的方式。

它不是被后起之秀打败的。它是被「官方」Sherlock 掉的。

Sherlock 这个词,苹果用户都懂。当年苹果出了个叫 Sherlock 的搜索软件,把第三方开发者做的一堆功能直接内置进系统,那批独立开发者一夜之间没了活路。后来这个词就成了专有名词,专指「官方下场,把第三方辛辛苦苦做出来的东西,变成系统的原生功能」。

— 小木屋被玻璃罩罩住,边界被整齐切断

CocoaPods 被 Sherlock 的时间点,是2015 年。

那一年苹果在 WWDC 上发布了 Swift Package Manager,自己的第一方依赖管理器。orta 在博客里写得很直白,2015 年苹果宣布要自己做包管理器,这一步 effectively took all the wind out of the sails,直接把 CocoaPods 的帆里的风全抽走了。

道理也简单。在苹果自己的地盘上跟苹果抢饭吃,从来不是一场值得志愿者搭上业余时间硬打的仗。CocoaPods 是志愿者项目,维护者靠的是热情。热情这东西,最怕「官方已经下场了」这句话。

所以从 2015 年之后,CocoaPods 就慢慢滑进了维护模式。不是没人用了,是没人再有动力去做大改进了。修修安全漏洞,跟一下新 Xcode 的兼容性,就这样吊着一口气。

「第三方先探路,官方后收编,这是一条反复重演的规律。」

浏览器扩展被收进系统功能,剪贴板管理器被收进操作系统,输入法里的很多功能被收进原生键盘。CocoaPods 只是这条长名单上,最新一个、也是体量最大的一个名字。

我这么讲,不是要替谁鸣不平。恰恰相反,我觉得这事挺公平的。

第三方证明了需求,官方用原生能力把体验做顺,对开发者整体是好事。SwiftPM 内建在 Xcode 里,不用装 Ruby,不用折腾环境,不用理解 .xcworkspace 那套弯弯绕,这是实打实的进步。

CocoaPods 的历史使命,其实在 SwiftPM 成熟的那一刻,就已经完成了。

04

MIGRATION

SPM 不是简单替代,是一场结构性迁移

那接下来呢?很多人的第一反应是,那就把 Podfile 换成 Package.swift 呗。

问题没这么轻巧。

— 旧山路旁,崭新的高速公路正在修建

先说个背景。这事已经不是「你愿不愿意迁」了,是外部世界在推着你迁。Flutter 官方已经宣布,从 3.44 开始,SwiftPM 取代 CocoaPods,成为 iOS 和 macOS 应用的默认依赖管理器。Google 那边更直接,11 月 6 号发了公告,12 月 2 号之后,Google Mobile Ads SDK 和它的中介适配器,不再向 CocoaPods 发布任何新版本,往后只走 SwiftPM 和手动下载。Firebase 也早就说了,Firebase 12 是发到 CocoaPods 的最后一个大版本,2026 年 10 月起就停了。

等于说,几个最重量的 SDK 供应商,都在用行动告诉你,CocoaPods 这条路到头了。

但迁移的坑,比想象的多。

第一,你项目里那些小众库,可能压根没有 SwiftPM 支持。Flutter 自己给的数据是,Top 100 的 iOS 插件里,也才 61% 迁完。剩下的怎么办?Flutter 会给个临时回退,没迁的插件暂时还是走 CocoaPods,但这个回退早晚会彻底拔掉。真遇到这种库,你的选项就三条,换个有 SPM 支持的替代品,把它的源码 vendoring 进自己项目,或者自己维护一个私有源。

第二,别在同一个 target 里混用 CocoaPods 和 SwiftPM。Firebase 官方专门提醒过这一点,混用容易出诡异的问题。要迁就迁干净,一个 target 要么纯 pod,要么纯 SPM。

第三,私有依赖是个真问题。很多公司内部用私有 specs 仓库管组件,这套东西不会因为 trunk 只读就坏掉,它照样能跑。但如果你本来就打算往 SPM 迁,私有包的 Package.swift 也得跟着补起来,这活儿不轻。

实操顺序:先拉出 Podfile 和 Podfile.lock,把每个 pod 分成「还在维护 / 已死 / 私有」三堆,再在 Swift Package Index 上逐个查有没有 SPM 版本,最后在分支上动刀,跑 pod deintegrate 后重新加依赖,Package.resolved 记得提交。

这事急不得,但也拖不得。12 月 2 号不是末日,可那些还在靠 CocoaPods 拿更新的库,从那天起就真的开始停更了。

∞

THE END

下一个问题:为 AI 编程重设计项目结构

聊到这,我得说一个我真正想说的东西了。

工具从 CocoaPods 换成 SwiftPM,这其实是表层。真正的变化,是 iOS 项目正在被两股力量同时拉扯,一股是编译器,一股是 AI。

而这两股力量,对项目结构的要求,正在罕见地指向同一个方向。

先想一件事,为什么 AI 写代码、维护代码,对老项目那么费劲?

因为老 iOS 项目对 AI 极不友好。一个 .xcodeproj 文件,本质是一坨 pbxproj 的文本,结构是给 Xcode 的图形界面设计的,不是给人、更不是给 AI 读的。AI 想搞清楚这个项目有哪些模块、依赖了谁、编译顺序是什么,得去啃一份几千行、几乎没有可读性的工程文件。这里面隐藏的信息,是项目结构最大的黑箱。

— 透明的水晶立方体,内部模块清晰有序

SwiftPM 天生解决了这个问题。Package.swift 是一个纯 Swift 文件,声明式的,人读得懂,AI 也读得懂。依赖关系、模块划分、target 结构,全写在一个能被程序化解析的文件里。这恰恰是AI 最舒服的形态。

所以我的判断是,迁移到 SPM,真正的红利不是「不用装 Ruby」那点体验提升,而是它把你的项目从一个 AI 读不懂的黑箱,变成了一个AI 能精确建模的、结构透明的工程。

顺着这个思路,未来的 iOS 项目该怎么设计,我掏点我自己的看法。

1

让 Package.swift 成为单一真相源。模块边界、依赖关系、构建配置,尽量收敛到这一个文件里,别让关键信息散落在 pbxproj、脚本、文档三个地方。

2

模块化,要显式的那种。把大而全的 App target 拆成职责清晰的小 target,让 AI 能在一个受限的上下文里干活,出错率会低不少。

3

锁文件提交,构建可复现。Package.resolved 一定要进版本控制,AI 排查问题时最需要一个确定的、能复现的环境。

4

单一依赖来源。别又 Podfile 又 Package.swift 又手动拖 framework,来源越单一,AI 越容易建模。

5

为 AI 留「为什么」注释。写清楚「为什么这么设计」而不是「这行代码在干什么」,AI 需要的不是解释语法,而是设计意图。

我知道,这些听起来有点理想化。我自己也还在摸索,没跑通的地方一堆。

但方向我觉得是对的。CocoaPods 谢幕这件事,说到底就是一个信号。它告诉你,iOS 开发那套靠人工、靠黑箱、靠「只有老手才搞得定」的旧秩序,正在被两件事联手拆掉。

一件是官方下场,把依赖管理变成透明、原生、可解析的标准。

一件是 AI 进场,它要求你的项目足够透明,透明到它能读懂、能推理、能替你维护。

「一个不再靠人的记忆和玄学经验撑起来的、真正可被程序理解和维护的 iOS 项目,才是 CocoaPods 这场谢幕,真正要告诉我们的下一章。」

END

我是克劳德Code,热衷于分享 AI 观察与干货。

如果你觉得今天这篇有收获,欢迎点赞、在看、转发三连,我们下篇见。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料