Как генерировать комментарии javadoc в Android Studio

можно ли использовать сочетания клавиш в Android studio для создания комментариев javadoc?

Если нет, то каков самый простой способ создания комментариев javadoc?

15 ответов


Я не могу найти ярлык для создания javadoc комментарии. Но если вы наберете /** перед объявлением метода и нажмите Enter, блок комментариев javadoc будет создан автоматически.

читать этой для получения дополнительной информации.


В generatae комментарии типа /** клавиша перед объявлением метода и нажмите Enter. Это generage комментария javadoc.

пример:

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

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

для получения дополнительной информации, проверьте ссылку https://www.jetbrains.com/idea/features/javadoc.html


здесь пример комментария JavaDoc от 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;
        }
 }

основной формат может быть автоматически сгенерирован одним из следующих способов:

  • поместите курсор над методом и введите /** + Enter
  • поместите курсор на имя метода и нажмите Alt + Enter > нажмите Добавить JavaDoc enter image description here

вы можете установить плагин JavaDoc из настроек - > плагин - >обзор репозиториев.

получить документацию плагина из приведенной ниже ссылки

документ плагина JavaDoc

enter image description here


вы можете использовать стиль eclipse генерации комментариев JavaDoc через "Fix doc comment". Откройте "Preference" - > " Keymap "и назначьте действие" Fix doc comment " нужному ключу.


здесь мы можем что-нибудь вроде этого. И вместо использования любого ярлыка мы можем писать комментарии "по умолчанию" на уровне класса/ пакета /проекта. И доработайте согласно требованию

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

преимущество в том, что вы можете создать блок комментариев для all the methods at a time.


В Android Studio вам не нужен плагин. На Mac просто откройте Android Studio - > нажмите Android Studio в верхней панели - > нажмите Prefrences - > найти шаблоны файлов и кодов в списке - > выберите включает - > построить его и будет постоянным во всем вашем проекте


просто выберите (т. е. нажмите) имя метода, затем используйте комбинацию клавиш Alt + Enter, выберите "Добавить JavaDoc"

Это предполагает, что вы еще не добавили комментарии выше метода, иначе опция "добавить JavaDoc" не появится.


  • другой способ добавить комментарий к java docs-нажать:Ctrl + Shift + A > > показать всплывающее окно > > тип: добавить javadocs > > Enter .

  • Ctrl + Shirt + A: поиск команды (имя команды автозаполнения)

enter image description here


В Android studio у нас есть несколько способов автоматического создания комментариев:

  • Метод I:

набрав /**, а затем нажав Enter, вы можете сгенерировать следующую строку комментария,и она автоматически сгенерирует параметры и т. д. но когда вам нужна горячая клавиша для этого метода проверки II ниже.

  • **II способ: **

1 - Гото topMenu

2 - Файл > Параметры

3-Выберите Keymap из настройки

4 - в верхней правой строке поиска найдите "Fix Doc"

5-Выберите "fix doc comment" из результатов и дважды щелкните по нему

6-выберите Добавить сочетание клавиш из открытого раскрывающегося списка после двойного щелчка

7-Нажмите клавиши быстрого доступа на клавиатуре

8-Goto ваш код и где вы хотите добавить комментарий нажмите клавишу быстрого доступа

9 - наслаждайтесь!


Я не уверен, что полностью понимаю вопрос, но список коротких сокращений клавиатуры можно найти здесь - надеюсь, это поможет!


просто выберите версию Eclipse keycap в настройках Keymap. Eclipse Keymap включен в Android Studio.


Android Studio - > Настройки - > Редактор - > Намерения - > Java - > Объявление - > Включить "Добавить JavaDoc"

и, выбирая методы для реализации (Ctrl / Cmd + i), в левом нижнем углу вы должны увидеть флажок, чтобы включить копирование JavaDoc.


комментарии Javadoc могут быть автоматически добавлены с помощью функции автозаполнения IDE. Попробуйте ввести /** и наезд Enter для создания примера комментария 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
 */

ALT+ SHIFT+G создаст автоматически сгенерированные комментарии для вашего метода (поместите курсор в исходное положение вашего метода).