2015 年 3 月 23 日
关注 @ortaTL;DR: CocoaDocs.org 刚刚获得 Jazzy 支持,变得更加稳定,现在正在向我们的状态页面发送统计信息。
历史。
CocoaDocs 是一款生成 CocoaPods 文档的服务器。它最初通过托管在 Mac 上的 appledoc 生成符合 Apple 标准的 DocSets,然后将结果发送到 Amazon 的 S3,在那里以静态方式提供服务。
成熟过程
Appledoc 很棒,但它不会很快支持 Swift。自 2014 年新年以来,CocoaPods 一直支持 Swift Pods,我们也希望能够为这些 Pods 提供托管文档。Sam Giddins 在这里采取了主动,通过 Realm 的 Jazzy 添加了对 Swift Pods 的 早期支持。您可以在此处看到一些 Pods:Observable、Moya、JSONJoy 和 QRReader.swift。目前还没有花哨的设计工作,我们以后会做。
鉴于 Swift 还不成熟,这是一个有趣的问题,因为 CocoaDocs 服务器无法确定您的库支持哪个版本的 Swift。目前,仅支持稳定的 Xcode 版本即可解决此问题。将来,为每个版本的 podspec 添加一系列受支持的 Swift 版本可能是合理的。
在 2014 年底,CocoaDocs 服务器开始出现一些实际问题,生成器会宕机数天,并且尝试 ssh
登录会失败。事实证明,我们使用的共享 VPS 在一段时间后会宕机,可能是因为内存不足。为了让服务器重新启动并运行,我不得不提交一张支持票,让其他人重新启动它。
大约在这个时候,Button 联系我,询问这是否是他们可以帮助解决的问题。鉴于到目前为止我一直自己支付 CocoaDocs 的费用,我已尽一切努力对其进行优化以减轻我的经济负担。(CocoaDocs 每年花费我大约 450 美元。)因此,我们抓住了这个机会,把它做好。CocoaDocs 现在在 macminicolo.net 上运行,使用 ssh 或 Screen Share.app 登录简直就是梦想。非常感谢 Button!
在 迁移 过程中,我添加了一项功能。我们现在将数据发送到 CocoaPods 状态 页面,说明过去 24 小时内记录了多少个 Pods。希望这能带来一些有用的见解,即“它是否正常工作?”,并了解它做了多少工作。