Entre las nuevas funciones anunciadas en Xcode 8 , podemos ver
"Generar automáticamente documentación de ayuda rápida":
¿Es este el final de la documentación del código manual como podemos aprender en este artículo de NSHipster ?
¿Alguien puede describir los pros y los contras de esta nueva función? ¿Reemplaza herramientas como Jazzy ?
No pude encontrar más información sobre la nueva función.
Respuestas:
Esto se refiere a la función Xcode 8 (y posterior), donde puede seleccionar un método como este:
func foo(bar: Int) -> String { ... }
... y luego presione ⌘+ option+ /(o elija “Estructura” »“ Agregar documentación ”del menú“ Editor ”de Xcode) y generará la siguiente plantilla de comentarios para usted:
/// <#Description#>
///
/// - parameter bar: <#bar description#>
///
/// - returns: <#return value description#>
Simplemente facilita la redacción de documentación para la Ayuda rápida.
Tenga en cuenta que, aunque este comportamiento ha cambiado un poco con el tiempo, Xcode puede ser particular sobre dónde debe estar el cursor cuando intenta hacer esto. Por ejemplo, el cursor tiene que estar en algún lugar del nombre de la función, fooen mi ejemplo anterior, para que esto funcione. O simplemente haga doble clic en el nombre de la función y luego presione ⌘+ option+/
@IBActionmétodos. Pero funciona bien con Objective-C y Swift. Si todavía tiene problemas y ha probado el procedimiento poco convincente habitual de reiniciar Xcode y / o reiniciar su máquina, es posible que solo desee publicar un informe de error en este software beta.
sudo /usr/libexec/xpccachectlen Terminal y reiniciar su Mac antes de que lo haga o cualquier otra extensión de Xcode. trabajo. Consulte las notas de la versión de Xcode 8.
Lo más probable es que esto esté relacionado con el hecho de que TODAS las teclas de acceso rápido con '/' no funcionan en la versión actual de XCode 8, si su teclado requiere presionar Mayús para obtenerlo.
Es decir, en el teclado alemán, la '/' es shift + 7, presionar alt + cmd + shift-7 no hace nada. Si asigna, por ejemplo, cmd + shift + opt + d, funciona bien.
El acceso directo '///', que lamentablemente tampoco funciona en este momento, probablemente se deba al antiguo complemento de XCode VVDocumenter, que utilizaba exactamente este acceso directo.
Gran característica, pésimo control de calidad en el lado de Apple.