Android Studio JavaDocs не генерирует

Сегодня я запустил студию Android (2.1.2), и при попытке добавить комментарии к блоку с помощью /** + enter он не генерирует весь блок с параметрами и оператором возврата.

Я не уверен, что вызывает это.

Я попытался погуглить проблему. Но я не могу исправить на данный момент с решениями там.

Пожалуйста, помогите мне решить эту проблему.


person sha    schedule 29.06.2016    source источник
comment
это помогает?   -  person Sufian    schedule 29.06.2016
comment
Теперь он работает без каких-либо исправлений .. Странно .. Чертова студия .. не знаю почему .. Извините, ребята .. Спасибо @Sufian за ваш ответ ..   -  person sha    schedule 29.06.2016


Ответы (1)


Это ошибка в студии Android.

Если это последний метод в классе и под ним есть несколько комментарных комментариев к блоку, то вы не можете генерировать комментарии к блоку.

Что-то вроде этого:

{
  ......

    // You can't do a /** + enter here;
    // it won't generate JavaDoc if you do.
    public ViewPager getViewPager() {
        return mViewPager;
    }

    //  /*
    //   * Inner classes, interfaces, enums
    //   */
}

В этом случае IDE не создает блочный комментарий для getViewPager().

person sha    schedule 29.06.2016
comment
Автогенерация /** работает только поверх конструкторов и методов классов. И добавление // к /***/ кажется излишним. Я бы предпочел использовать только /***/, если мой комментарий длинный, как абзац, если это одна строка, я просто использую //. - person Enzokie; 29.06.2016
comment
Извините, мое объяснение могло вас смутить. Но если по какой-то причине в конце класса уже есть комментарий к блоку с комментариями, то автоматическая генерация комментария к блоку не работает для последнего метода в классе. - person sha; 29.06.2016
comment
Почему вы добавляете // к /**? И в основном /** не имеет никакого эффекта, когда ваши методы не имеют аргументов. - person Enzokie; 30.06.2016
comment
Я также не добавляю //, я просто прокомментировал это для объяснения. :) - person sha; 30.06.2016
comment
Ах я вижу. Поскольку ваш getViewPager() вообще не имеет аргументов, /** предоставит только @return ViewPager :). - person Enzokie; 30.06.2016
comment
@sha фрагмент кода теперь кажется перепутанным. Почему вы удалили //? - person Sufian; 01.07.2016
comment
@sha прочитайте это и зарегистрируйте эту ошибку. - person Sufian; 03.07.2016
comment
Спасибо @Sufian. Сообщили об ошибке – code.google.com/p/android/issues/ подробно?id=215019 - person sha; 04.07.2016
comment
Все еще не исправлено. Июнь 2019. Я отправлю записку в соответствующий орган после проверки, Google это или IntelliJ. - person Tim Maher-De Troyer; 13.06.2019