在Xcode 8中宣布的新功能中,我们可以看到
“自动生成快速帮助文档”:
就像我们可以从NSHipster上学习本文一样,手动代码文档到此结束了吗?
有人可以概述此新功能的优缺点吗?它会取代Jazzy之类的工具吗?
我找不到有关新功能的更多信息。
在Xcode 8中宣布的新功能中,我们可以看到
“自动生成快速帮助文档”:
就像我们可以从NSHipster上学习本文一样,手动代码文档到此结束了吗?
有人可以概述此新功能的优缺点吗?它会取代Jazzy之类的工具吗?
我找不到有关新功能的更多信息。
Answers:
这指的是Xcode 8(及更高版本)功能,您可以在其中选择如下方法:
func foo(bar: Int) -> String { ... }
...,然后按⌘+ option+ /(或从Xcode的“编辑器”菜单中选择“结构”»“添加文档”),它将为您生成以下注释模板:
/// <#Description#>
///
/// - parameter bar: <#bar description#>
///
/// - returns: <#return value description#>
它只是有助于快速帮助文档的编写。
请注意,尽管这种行为随着时间的流逝有所改变,但是Xcode可能会特别说明您在尝试执行此操作时光标必须位于的位置。例如,foo
在我上面的示例中,游标必须位于函数名称中的某个位置才能起作用。或者只需双击函数名称,然后按⌘+ option+/
@IBAction
方法混淆。但是它与Objective-C和Swift都可以使用。如果您仍然遇到问题,并且尝试了通常的me脚程序来重新启动Xcode和/或重新启动计算机,则可能只想在此Beta版软件上发布错误报告。
sudo /usr/libexec/xpccachectl
在Terminal中运行并重新启动Mac ,然后再运行Mac或任何其他Xcode Extensions。工作。请参阅Xcode 8发行说明。
这很可能与以下事实有关:如果您的键盘需要按shift键才能使用,则所有带有'/'的热键在当前的XCode 8版本中均不起作用。
即在德语键盘上,“ /”为shift + 7,按alt + cmd + shift-7则无济于事。如果您指定cmd + shift + opt + d,则效果很好。
不幸的是,快捷方式“ ///”目前也无法使用,可能是由于旧的XCode插件VVDocumenter完全使用了此快捷方式。
很棒的功能,在苹果方面糟糕的质量检查。