Comment générer des commentaires javadoc dans Android Studio

Puis-je utiliser les touches de raccourci dans Android studio pour générer des commentaires javadoc?

Sinon, quel est le moyen le plus simple de générer des commentaires javadoc?

157
demandé sur Hitesh Sahu 2013-06-25 11:42:37

15 réponses

Je ne trouve aucun raccourci pour générer des commentaires javadoc. Mais si vous tapez /** avant la déclaration de méthode et appuyez sur Entrée, le bloc de commentaires javadoc sera généré automatiquement.

Lire CE pour plus d'informations.

317
répondu DouO 2018-02-05 10:35:44

Pour générer des commentaires, tapez /** clé avant la déclaration de méthode et appuyez sur Enter. Il générera un commentaire javadoc.

Exemple:

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

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

Pour plus d'informations, consultez le lien https://www.jetbrains.com/idea/features/javadoc.html

96
répondu Amey Haldankar 2018-02-05 11:59:30

Voici un exemple de commentaire JavaDoc D'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;
        }
 }

Le format de base peut être généré automatiquement de l'une des manières suivantes:

  • Positionnez le curseur au-dessus de la méthode et du type /** + entrez
  • Positionnez le curseur sur le nom de la méthode et appuyez sur Alt + entrez > Cliquez sur Ajouter JavaDoc entrez la description de l'image ici
25
répondu Suragch 2017-09-14 08:23:36

Vous pouvez installer le plugin JavaDoc à partir de paramètres - > Plugin- > parcourir les dépôts.

Obtenir la documentation du plugin à partir du lien ci-dessous

JavaDoc plugin document

entrez la description de l'image ici

14
répondu darwin 2016-04-19 11:28:24

Vous pouvez utiliser le style eclipse de la génération de commentaires JavaDoc via "Fix Doc comment". Ouvrez "Preference" - > "Keymap" et affectez l'action "Fix Doc comment" à une clé que vous voulez.

10
répondu Kohei Mikami 2015-03-27 20:14:53

Ici, nous pouvons quelque chose comme ça. Et au lieu d'utiliser n'importe quel raccourci, nous pouvons écrire des commentaires "par défaut" au niveau de la classe/ du paquet /du projet. Et modifier selon l'exigence

   *** 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.

L'avantage est que vous pouvez créer un bloc de COMMENTAIRES POUR all the methods at a time.

7
répondu Mr.India 2016-04-14 14:29:29

Dans Android Studio, vous n'avez pas besoin de le brancher. Sur un Mac, ouvrez simplement Android Studio - > cliquez sur Android Studio dans la barre supérieure - > cliquez sur Préfrences - > trouver des modèles de fichiers et de Code dans la liste -> sélectionnez includes - > construisez-le et sera persistant dans tout votre projet

5
répondu Robert Warren 2014-06-03 20:43:38

Sélectionnez simplement (c'est-à-dire cliquez sur) le nom de la méthode, puis utilisez la combinaison de touches Alt + Entrée, sélectionnez "Ajouter JavaDoc"

Cela suppose que vous n'avez pas déjà ajouté de commentaires au-dessus de la méthode, sinon l'option "Ajouter JavaDoc" n'apparaîtra pas.

2
répondu Jim Robbins 2016-09-01 19:10:52
  • Une autre façon d'ajouter un commentaire java docs est la presse: Ctrl + Maj + A > > afficher un popup >> type : Ajouter javadocs >> entrée .

  • Ctrl + Chemise + A: recherche de commande (nom de la commande de saisie semi-automatique)

entrez la description de l'image ici

1
répondu huu duy 2016-03-17 17:13:30

Dans Android studio, nous avons peu de façons de générer automatiquement des commentaires:

  • Méthode I:

En tapant / * * puis en appuyant sur Entrée, vous pouvez générer la ligne de commentaire suivante et générer automatiquement les paramètres, etc. mais quand vous avez besoin de la touche de raccourci pour cette méthode de vérification II ci-dessous.

  • **Méthode II: * *

1-Goto topMenu

2-Fichier > Paramètres

3-Sélectionnez Keymap dans Paramètres

4 - dans la barre de recherche en haut à droite rechercher "Fix Doc"

5-Sélectionnez le "fix doc comment" dans les résultats et double-cliquez dessus

6-sélectionnez Ajouter un raccourci clavier dans la liste déroulante ouverte après double-cliquez sur

7-Appuyez sur les touches de raccourci du clavier

8-aller à votre code et où vous voulez ajouter un commentaire appuyez sur la touche de raccourci

9 - profitez-en!

1
répondu Noir 2018-03-01 08:50:16

Je ne suis pas sûr de comprendre complètement la question, mais une liste de raccourcis clavier peut être trouvée ici - J'espère que cela aide!

0
répondu LokiSinclair 2013-06-25 07:49:58

Sélectionnez simplement la version Eclipse du keycap dans les paramètres Keymap. Un Keymap Eclipse est inclus dans Android Studio.

0
répondu Brill Pappin 2014-02-11 17:03:42

Android Studio - > Préférences - > Éditeur - > Intentions - > Java - > Déclaration - > Activer "Ajouter JavaDoc"

Et, lors de la sélection des méthodes à implémenter (Ctrl/Cmd + i), en bas à gauche, vous devriez voir la case à cocher pour activer Copy JavaDoc.

0
répondu sayaMahi 2018-05-31 08:18:34

Les commentaires Javadoc peuvent être ajoutés automatiquement en utilisant la fonction de saisie semi-automatique de votre IDE. Essayez de taper /** et appuyez sur Entrez pour générer un exemple de commentaire Javadoc.

 /**
 *
 * @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
 */
0
répondu kuldeep kumar 2018-09-08 18:49:26

ALT+décalage+G créera les commentaires générés automatiquement pour votre méthode (placez le curseur à la position de départ de votre méthode).

-4
répondu Dinesh IT 2015-04-09 20:10:55