Entre os novos recursos anunciados no Xcode 8 , podemos ver
"Gerar documentação de ajuda rápida automaticamente":
Este é o fim da documentação do código manual como podemos aprender neste artigo do NSHipster ?
Alguém pode descrever os prós e os contras desse novo recurso? Ele substitui ferramentas como o Jazzy ?
Não consegui encontrar mais informações sobre o novo recurso.
Respostas:
Isso se refere ao recurso Xcode 8 (e posterior), onde você pode selecionar um método como este:
func foo(bar: Int) -> String { ... }
... e então pressione ⌘+ option+ /(ou escolha “Estrutura” »“ Adicionar documentação ”do menu“ Editor ”do Xcode) e ele irá gerar o seguinte modelo de comentários para você:
/// <#Description#>
///
/// - parameter bar: <#bar description#>
///
/// - returns: <#return value description#>
Isso apenas facilita a redação de documentação para Ajuda Rápida.
Observe que, embora esse comportamento tenha mudado um pouco com o tempo, o Xcode pode ser específico sobre onde o cursor deve estar quando você tenta fazer isso. Por exemplo, o cursor deve estar em algum lugar no nome da função, foono meu exemplo acima, para que isso funcione. Ou apenas clique duas vezes no nome da função e pressione ⌘+ option+/
@IBActionmétodos. Mas funciona bem com Objective-C e Swift. Se você ainda está tendo problemas e tentou o procedimento usual de reiniciar o Xcode e / ou reinicializar sua máquina, você pode apenas postar um relatório de bug neste software beta.
sudo /usr/libexec/xpccachectlno Terminal e reiniciar seu Mac antes que ele ou qualquer outra extensão Xcode irá trabalhos. Consulte as notas de versão do Xcode 8.
Isso provavelmente está relacionado ao fato de que TODAS as teclas de atalho com um '/' não funcionam na compilação atual do XCode 8, se o seu teclado exigir que você pressione shift para obtê-lo.
Ou seja, no teclado alemão o '/' é shift + 7, pressionando alt + cmd + shift-7 não faz nada. Se você atribuir, por exemplo, cmd + shift + opt + d, funcionará perfeitamente.
O atalho '///', que infelizmente também não funciona agora, provavelmente se deve ao antigo plugin do XCode VVDocumenter, que usava exatamente esse atalho.
Excelente recurso, péssimo controle de qualidade do lado da Apple.