xcode methods comments

Auto generar comentario de método en XCode



methods comments (4)

¿Hay alguna forma en Xcode para generar comentarios de métodos automáticamente similar a lo que haces en Eclipse para comentarios de javadoc?

Por ejemplo presionar, puede presionar / ** una fila antes de que una declaración de método y eclipse genere automáticamente el esqueleto de los comentarios del método.

  1. Seleccione su código para el que desea generar comentarios y presione la tecla de método abreviado

    CMD + ALT + /

  2. El comentario se autogenerará para el método seleccionado.

Puede usar el atajo para crear el documento del encabezado:

⌘ + ⌥ + /

dónde
⌘ = Comando
⌥ = alt

Puede usar la biblioteca de fragmentos de código para esto. No generará automáticamente marcadores de posición para cada parámetro, pero de todos modos es bastante útil. Esto es lo que haces:

  1. Escriba un bloque de comentario de ejemplo en su código en alguna parte.
  2. Inserta <#xyz#> donde quieras que aparezca un marcador de posición llamado ''xyz''. (Estos son como marcadores de posición de finalización de parámetros, por lo que puede tabular entre ellos y sobrescribirlos).

Por ejemplo:

/** * Method name: <#name#> * Description: <#description#> * Parameters: <#parameters#> */

  1. Abre la barra lateral de la derecha. En el panel inferior, haga clic en el icono de dos llaves para mostrar la biblioteca de fragmentos.
  2. Seleccione y arrastre su texto a la biblioteca de fragmentos de código.
  3. Creará uno nuevo. Haga doble clic en él, haga clic en editar en la ventana emergente y asígnele un atajo de finalización (por ejemplo, comblk para el bloque de comentarios).

Ahora, cuando escribe ''comblk'' en cualquier lugar de sus editores, aparece la ventana emergente de autocompletar y puede presionar regresar para pegar el fragmento. Se seleccionará el primer marcador de posición y podrá comenzar a escribir el nombre del método. Pulse la pestaña para cambiar a la descripción, y así sucesivamente.

No es ideal, pero es mejor que nada. Los fragmentos son una buena idea que Apple aún no ha terminado de implementar.