什么因素控制CocoaPods点击Pod时展示落地页还是直接跳转Git仓库?
CocoaPods Pod 专属落地页不展示的排查解决思路
CocoaPods 官方的带 README、CHANGELOG、版本列表的专属落地页,由 Trunk 服务在你推送正式版 Pod 时自动生成,未生成时可按以下顺序排查:
- 检查
podspec字段完整性,除常规必填字段外,必须配置CocoaPods可识别的license类型,且对应 Git 仓库根目录下存在命名匹配的 LICENSE 文件(如 LICENSE、LICENSE.md),缺失有效 license 会直接跳过落地页生成流程。 - 检查推送的版本是否符合 语义化版本规范(X.Y.Z,三段纯数字格式),带
beta、rc、dev等预览后缀、使用 commit hash 作为版本号的非正版本,不会触发落地页生成。 - 检查 README、CHANGELOG 文件的命名和存放位置:二者必须放在 Git 仓库根目录,命名需匹配
README*(支持.md、.markdown 等后缀)、CHANGELOG*格式,存放在子目录或命名不匹配会导致 Trunk 服务抓取失败,直接跳转 Git 仓库地址。 - 刚推送的新版本最多等待 24 小时的 Trunk 服务缓存同步周期,未完成内容抓取和渲染的版本会临时跳转 Git 仓库。
- 检查
podspec中是否配置了deprecated、deprecated_in_favor_of废弃标记,标记为废弃的 Pod 不会展示完整落地页。 - 以上排查无问题时,可以推送一个版本号尾号+1的小迭代版本,触发 Trunk 服务重新抓取仓库内容生成落地页。
内容的提问来源于stack exchange,提问作者Travis Prescott
相关产品推荐
相关产品推荐

