0

我们正在尝试使用 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但这对我不起作用.. :(

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

4

2 回答 2

0

问题是由于jazzy 依赖 OS X 的 Spotlight 索引服务来查找具有正确 Swift 版本的 Xcode 实例这一事实引起的。由于此服务在构建服务器上被禁用，因此无法找到任何 Xcode 实例。

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

我们需要确保只安装了一个 Xcode 版本，或者选择了正确的 Xcode 版本（带有正确的 swift 版本）。

于 2017-03-26T00:56:08.043 回答
0

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

建议尝试通过创建 .jazzy.yaml 文件并将配置放入其中详细信息以避免此类情况。

发布只需在终端中键入“jazzy”即可生成文档。

$爵士乐

有关详细信息，请点击此链接，这是一个分步指南以及一个示例 swift 项目：

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

希望这可以帮助！！

于 2019-09-22T09:19:30.270 回答