我们正在尝试使用Jazzy和Xcode7.3生成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
,但这对我不起作用。
我们是否需要发送任何其他参数来消除此错误..?
2条答案
按热度按时间k5ifujac1#
这个问题是由于jazzy依赖OS X的spotlight索引服务来找到正确Swift版本的Xcode示例。由于该服务在构建服务器上被禁用,因此无法找到任何Xcode示例。
我们不能保证在构建服务器中启用spotlight,我们需要确保即使spotlight被禁用,jazzy也能正常工作。幸运的是,jazzy的新版本(0.6.1)修复了这个问题。如果没有明确指定swift版本(https://github.com/realm/jazzy/pull/560),这个版本将使用当前选择的Xcode(xcode-select命令)。
voase2hg2#
这可能是您执行的命令中的间距/格式问题。
建议通过创建.jazzy.yaml文件进行尝试,并将配置放在详细信息中,以避免出现此类情况。
只要在终端中输入“jazzy”,它就会生成文档。
$爵士乐
有关详细信息,请点击以下链接,这是一个循序渐进的指南,沿着一个样本swift项目相同:
https://medium.com/@sumit16.kumar/document-generation-for-swift-projects-using-jazzy-e148efc72bca
希望这对你有帮助!