Jazzy无法找到具有快速版本2.2的Xcode。(RuntimeError)：Xcode7.3

Question

我们正在尝试使用Xcode7.3的Jazzy为Swift2.2生成文档。我们有两个环境:本地开发环境(Macbook)和用于中心构建的服务器机器。

我们在这两台机器上都设置了完全相同的设置，比如Xcode、CommandLine工具和Ruby，但是在服务器Jazzy中出现了以下错误：

jazzy-0.5.0/lib/jazzy/sourcekitten.rb:137:in `run_sourcekitten': Unable to find an Xcode with swift version 2.2. (RuntimeError)
from .../gems/jazzy-0.5.0/lib/jazzy/doc_builder.rb:57:in `block in build'
from .../gems/jazzy-0.5.0/lib/jazzy/doc_builder.rb:55:in `chdir'
from .../gems/jazzy-0.5.0/lib/jazzy/doc_builder.rb:55:in `build'
from .../gems/jazzy-0.5.0/bin/jazzy:15:in `<top (required)>'
from .../jazzy/bin/jazzy:23:in `load'
from .../jazzy/bin/jazzy:23:in `<main>'

许多人建议使用--swift-version 2.2，但这对我不起作用。:(

我们是否需要发送额外的参数来消除这个错误..？

Answer 1

造成这个问题的原因是，jazzy依赖OS的集中索引服务来找到一个具有适当Swift版本的Xcode实例。由于在构建服务器上禁用了此服务，因此未能找到任何Xcode实例。

我们不能保证在构建服务器中启用聚光灯，我们需要确保jazzy能够工作，即使聚光灯是禁用的。幸运的是，是jazzy (0.6.1)的新版本，它解决了问题。如果没有显式指定的快速版本(https://github.com/realm/jazzy/pull/560)，此版本将使用当前选择的Xcode (xcode-select命令)。

我们需要确保只安装了一个版本的Xcode，或者选择了正确的Xcode版本(带有适当的快速版本)。

Answer 2

这可能是您执行的命令中的间隔/格式问题。

建议通过创建.jazzy.yaml文件进行尝试，并将配置放在其中的细节中，以避免出现这种情况。

在终端中输入"jazzy“即可生成文档。

$ jazzy

有关详细信息，请遵循此链接，这是一个一步步的指南，以及一个示例快捷项目：

https://medium.com/@sumit16.kumar/document-generation-for-swift-projects-using-jazzy-e148efc72bca

希望这能帮上忙！