Cómo generar comentarios javadoc en Android Studio

204

¿Puedo usar teclas de acceso directo en el estudio de Android para generar comentarios de javadoc?

Si no, ¿cuál es la forma más fácil de generar comentarios javadoc?

qinxianyuzou
fuente
Esta pregunta es 50/50. Usted está buscando bloques javadoc individuales para generar javadoc en todo el documento. Cual es
K - La toxicidad en SO está creciendo.
ALTR + ENTER muestra la vista en la que puede generar el comentario de los métodos ya declarados.
Zala Janaksinh
Es posible que deba agregar una plantilla Live (estudio de Android - configuración - editor - Plantillas Live - agregar) para ello. En el campo de texto de la plantilla, agregue el siguiente texto. / ** * $ comentario $ * /
Johnett Mathew

Respuestas:

388

No puedo encontrar ningún acceso directo para generar comentarios javadoc. Pero si escribe /**antes de la declaración del método y presiona Enter, el bloque de comentarios javadoc se generará automáticamente.

Lea esto para más información.

DouO
fuente
77
Es una pena que esto tampoco funcione para generar comentarios javadoc para clases, campos, etc. Sería aún mejor si generara javadoc a partir de una plantilla personalizable.
Ted Hopp
23
por supuesto que tiene acceso directo: posición en el método / nombre del constructor y presione alt + enter, elija generar javadoc del menú
Ewoks
consulte esto más sobre la solución anterior
Pritesh Vishwakarma
110

Para generar comentarios, escriba la /**tecla antes de la declaración del método y presione Enter. Generará el comentario de javadoc.

Ejemplo:

/**
* @param a
* @param b
*/

public void add(int a, int b) {
    //code here
}

Para obtener más información, consulte el enlace https://www.jetbrains.com/idea/features/javadoc.html

Amey Haldankar
fuente
44
@satheeshwaran - ¿en serio? Es la misma respuesta que la de DouO (respuesta original), excepto que tiene un ejemplo. Incluso el enlace es una copia. El ejemplo debería haberse agregado a la respuesta original.
CJBS
3
@satheeshwaran: por lo que vale, puedo ver que solo ver el ejemplo de los comentarios (en la respuesta) es útil, cuando uno quiere una respuesta rápida ;-)
CJBS
En realidad, el ejemplo carece de un * antes del último /
Maximiliano Ambrosini
35

Aquí hay un ejemplo de un comentario JavaDoc de Oracle :

/**
 * Returns an Image object that can then be painted on the screen. 
 * The url argument must specify an absolute {@link URL}. The name
 * argument is a specifier that is relative to the url argument. 
 * <p>
 * This method always returns immediately, whether or not the 
 * image exists. When this applet attempts to draw the image on
 * the screen, the data will be loaded. The graphics primitives 
 * that draw the image will incrementally paint on the screen. 
 *
 * @param  url  an absolute URL giving the base location of the image
 * @param  name the location of the image, relative to the url argument
 * @return      the image at the specified URL
 * @see         Image
 */
 public Image getImage(URL url, String name) {
        try {
            return getImage(new URL(url, name));
        } catch (MalformedURLException e) {
            return null;
        }
 }

El formato básico se puede generar automáticamente de cualquiera de las siguientes maneras:

  • Coloque el cursor sobre el método y escriba /**+Enter
  • Coloque el cursor sobre el nombre del método y presione Alt+ Enter> haga clic en Agregar JavaDoc ingrese la descripción de la imagen aquí
Suragch
fuente
17

Puede instalar el complemento JavaDoc desde Configuración-> Complemento-> Examinar repositorios.

obtener documentación del complemento desde el siguiente enlace

Documento de complemento JavaDoc

ingrese la descripción de la imagen aquí

Darwin
fuente
Esto funciona muy bien. Instale el complemento JavaDoc (como arriba), luego presione CNTL + SHIFT + ALT + G.
Alan Nelson
10

Puede usar el estilo eclipse de generación de comentarios JavaDoc a través de "Fix doc comment". Abra "Preferencia" -> "Mapa de teclas" y asigne la acción "Reparar comentario de documento" a la tecla que desee.

Kohei Mikami
fuente
9

Aquí podemos hacer algo como esto. Y en lugar de usar cualquier atajo, podemos escribir comentarios "predeterminados" a nivel de clase / paquete / proyecto. Y modificar según requerimiento

   *** Install JavaDoc Plugin ***



     1.Press shift twice and  Go to Plugins.
     2. search for JavaDocs plugin
     3. Install it. 
     4. Restart Android Studio.
     5. Now, rightclick on Java file/package and goto 
        JavaDocs >> create javadocs for all elements
        It will  generate all default comments.

La ventaja es que puede crear un bloque de comentarios para all the methods at a time.

Mr.India
fuente
9

Los comentarios de Javadoc se pueden agregar automáticamente mediante el uso de la función de autocompletar de su IDE. Intente escribir /**y golpear Enterpara generar un comentario Javadoc de muestra.

 /**
 *
 * @param action          The action to execute.
 * @param args            The exec() arguments.
 * @param callbackContext The callback context used when calling back into JavaScript.
 * @return
 * @throws JSONException
 */
Kuldeep Kumar
fuente
5

En Android Studio no necesita el complemento. En una Mac, simplemente abra Android Studio -> haga clic en Android Studio en la barra superior -> haga clic en Preferencias -> busque plantillas de archivos y códigos en la lista -> seleccione incluye -> compílelo y será persistente en todo su proyecto

Robert Warren
fuente
2
  • Otra forma de agregar comentarios de java docs es presionar: Ctrl + Shift + A >> mostrar una ventana emergente >> tipo: Agregar javadocs >> Enter.

  • Ctrl + Camisa + A: búsqueda de comandos (nombre del comando de autocompletar)

ingrese la descripción de la imagen aquí

huu duy
fuente
2

Simplemente seleccione (es decir, haga clic) el nombre del método, luego use la combinación de teclas Alt + Intro, seleccione "Agregar JavaDoc"

Esto supone que aún no ha agregado comentarios sobre el método; de lo contrario, la opción "Agregar JavaDoc" no aparecerá.

Jim Robbins
fuente
2

En Android Studio tenemos pocas formas de generar comentarios automáticamente:

  • Método I:

Al escribir / ** y luego presionar Intro, puede generar la siguiente línea de comentarios y generará automáticamente los parámetros, etc. pero cuando necesite la tecla de acceso rápido para este método de verificación II a continuación.

  • ** Método II: **

1 - Ir a topMenu

2 - Archivo> Configuración

3 - Seleccione Keymap de la configuración

4 - En la barra de búsqueda superior derecha, busque "Fix Doc"

5 - Seleccione el "arreglo del comentario del documento" de los resultados y haga doble clic en él

6 - Seleccione Agregar atajo de teclado del menú desplegable abierto después de hacer doble clic

7 - Presione las teclas de acceso directo en el teclado

8 - Pase a su código y dónde desea agregar algún comentario presione la tecla de acceso directo

9 - ¡Disfruta!

Noir
fuente
La forma más convincente de agregar documentos. Por ejemplo, he asignado "'" e Intro como acceso directo
CodeToLife
1

Simplemente seleccione la versión Eclipse de la tecla en la configuración de Keymap. Se incluye un mapa de teclas de Eclipse en Android Studio.

Brill Pappin
fuente
0

No estoy seguro de entender completamente la pregunta, pero aquí se puede encontrar una lista de atajos de teclado . ¡Espero que esto ayude!

fantasiosamente bestial
fuente
2
En eclipse para agregar comentarios de javadoc, presione Alt + shift + j, pero en AndroidStudio pero no sé cómo hacerlo
qinxianyuzou
Si recuerdo, ese acceso directo solo funcionaba si tenía el complemento 'jautodoc' instalado y habilitado.
Matt
0

Android Studio -> Preferencias -> Editor -> Intenciones -> Java -> Declaración -> Habilitar "Agregar JavaDoc"

Y, mientras selecciona Métodos para implementar (Ctrl / Cmd + i), en la parte inferior izquierda, debería ver la casilla de verificación para habilitar Copiar JavaDoc.

Mahi
fuente
0

Yo recomendé a Dokka para generar Javadoc con comentarios y más

Yudi Karma
fuente
-5

ALT+ SHIFT+ Gcreará los comentarios generados automáticamente para su método (coloque el cursor en la posición inicial de su método).

Dinesh IT
fuente
public void hideKeyboard () debe colocar el cursor delante de public e intentarlo o compruebe si instaló el java doc en su estudio.
Dinesh IT
A mí tampoco me funciona. Tal vez, está trabajando en algún mapa de teclas especial. El mapa de teclas se puede configurar en Preferencias> Mapa de teclas. O el mapa de teclas ha sido editado.
Oliver Kranz