如何更新Cocoapods官网已发布Pod的主页(README)?
解决CocoaPods Pod主页README更新不生效的问题
- 修正spec.readme的路径配置
CocoaPods不支持将spec.readme指向xcframework内部的嵌套文件,索引Pod时只会读取Pod根目录下的指定文件。你需要把目标README.md移到Pod的根目录,然后修改配置:
spec.readme = 'README.md'
若需明确文件类型,可使用完整写法:
spec.readme = { path: 'README.md', type: 'markdown' }
- 本地验证podspec合法性
修改后先在本地验证文件是否符合规范,避免推送失败:
pod spec lint YourPod.podspec
推送更新后的Pod
CocoaPods官网的主页内容仅在Pod版本推送时更新,有两种方式:- 推荐:更新Pod版本号(如从1.0.0升级为1.0.1),然后推送新版本:
pod trunk push YourPod.podspec - 若需更新现有版本的README(不推荐,可能影响已集成用户),需先删除旧版本再重新推送:
注意:删除版本需拥有Pod维护权限,且操作不可逆,请谨慎执行。pod trunk delete YourPod 1.0.0 pod trunk push YourPod.podspec
- 推荐:更新Pod版本号(如从1.0.0升级为1.0.1),然后推送新版本:
等待CDN缓存刷新
推送完成后,CocoaPods CDN需要几分钟到几小时的缓存刷新时间,之后再刷新官网页面即可看到更新后的README。
内容的提问来源于stack exchange,提问作者M.ahmed
相关产品推荐
相关产品推荐

