Jazzy 无法找到 Xcode 的 swift 版本 2.2。 (运行时错误):Xcode7.3

Jazzy Unable to find an Xcode with swift version 2.2. (RuntimeError): Xcode7.3

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

我们在两台机器上都有完全相同的设置,如 Xcode、命令行工具、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 但这对我不起作用..:(

我们是否需要发送任何其他参数来消除此错误..?

问题是由于 jazzy 依赖 OS X 的聚光灯索引服务来找到 Xcode 实例正确的 Swift 版本。由于此服务在构建服务器上被禁用,因此无法找到任何 Xcode 个实例。

我们无法保证在构建服务器中启用 spotlight,我们需要确保即使禁用 spotlight jazzy 也能正常工作。 幸运的是,新版本的 jazzy (0.6.1) 解决了这个问题。如果没有明确指定 swift 版本 (https://github.com/realm/jazzy/pull/560),则此版本使用当前 selected Xcode(xcode-select 命令)。

我们需要确保只安装了一个版本的 Xcode 或者正确的 Xcode 版本(具有正确的 swift 版本) selected.

这可能是您执行的命令中的 spacing/formatting 问题。

建议尝试创建 .jazzy.yaml 文件并在其中详细配置以避免此类情况。

Post 只需在终端中输入 "jazzy" 即可生成文档。

$ jazzy

有关详细信息,请遵循此 link,这是一个循序渐进的指南以及一个示例 swift 项目:

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

希望对您有所帮助!!