Jak generować komentarze javadoc w Android Studio


204

Czy mogę używać klawiszy skrótu w Android Studio do generowania komentarzy javadoc?

Jeśli nie, jaki jest najłatwiejszy sposób generowania komentarzy javadoc?


To pytanie to 50/50. Albo szukasz pojedynczych bloków javadoc generujących javadoc w całym dokumencie. Który to jest?
K - Toksyczność w SO rośnie.

ALTR + ENTER pokazują widok, w którym można wygenerować komentarz do już zadeklarowanych metod.
Zala Janaksinh

Być może powinieneś dodać szablon Live (studio Android - ustawienie - edytor - Szablony Live - dodaj). W polu tekstowym szablonu dodaj następujący tekst. / ** * $ komentarz $ * /
Johnett Mathew

Odpowiedzi:


388

Nie mogę znaleźć żadnego skrótu do generowania komentarzy javadoc. Ale jeśli wpiszesz /**przed deklaracją metody i naciśniesz Enter, blok komentarzy javadoc zostanie wygenerowany automatycznie.

Przeczytaj to, aby uzyskać więcej informacji.


7
Szkoda, że ​​nie działa to również w przypadku generowania komentarzy javadoc dla klas, pól itp. Byłoby jeszcze lepiej, gdyby wygenerowało javadoc z dostosowywanego szablonu.
Ted Hopp

23
oczywiście ma skrót: ustaw nazwę metody / konstruktora i naciśnij alt + enter, wybierz z menu generuj javadoc
Ewoks

odnieś to więcej o powyższym rozwiązaniu
Pritesh Vishwakarma

110

Aby wygenerować komentarze, wpisz /**klucz przed deklaracją metody i naciśnij Enter. Będzie generować komentarz javadoc.

Przykład:

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

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

Aby uzyskać więcej informacji, sprawdź link https://www.jetbrains.com/idea/features/javadoc.html


4
@satheeshwaran - naprawdę? To taka sama odpowiedź jak ta z DouO (oryginalna odpowiedź), tyle że ma przykład. Nawet link jest kopią. Przykład powinien zostać właśnie dodany do oryginalnej odpowiedzi.
CJBS

3
@ satheeshwaran - za to, co jest warte, widzę, że samo zobaczenie przykładu komentarzy (w odpowiedzi) jest przydatne, gdy ktoś chce szybko uzyskać odpowiedź ;-)
CJBS

W rzeczywistości w przykładzie brakuje * przed ostatnim /
Maximiliano Ambrosini

35

Oto przykład komentarza JavaDoc z 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;
        }
 }

Format podstawowy można wygenerować automatycznie na jeden z następujących sposobów:

  • Ustaw kursor nad metodą i wpisz /**+Enter
  • Ustaw kursor na nazwie metody i naciśnij Alt+ Enter> kliknij Dodaj JavaDoc wprowadź opis zdjęcia tutaj

17

Możesz zainstalować wtyczkę JavaDoc w Ustawieniach-> Wtyczka-> Przeglądaj repozytoria.

pobierz dokumentację wtyczki z poniższego linku

Dokument wtyczki JavaDoc

wprowadź opis zdjęcia tutaj


To działa świetnie. Zainstaluj wtyczkę JavaDoc (jak wyżej), a następnie naciśnij CNTL + SHIFT + ALT + G.
Alan Nelson

10

Możesz użyć stylu generowania komentarzy JavaDoc zaćmieniem poprzez „Napraw komentarz do dokumentu”. Otwórz „Preferencje” -> „Mapa klawiszy” i przypisz akcję „Napraw komentarz do dokumentu” do odpowiedniego klawisza.


9

Tutaj możemy coś takiego. I zamiast używać dowolnego skrótu, możemy pisać „domyślne” komentarze na poziomie klasy / pakietu / projektu. I modyfikuj zgodnie z wymaganiami

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

Zaletą jest to, że możesz utworzyć blok komentarzy all the methods at a time.


9

Komentarze Javadoc mogą być automatycznie dołączane przy użyciu funkcji autouzupełniania IDE. Spróbuj wpisać /**i nacisnąć, Enteraby wygenerować przykładowy komentarz 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
 */

5

W Android Studio nie potrzebujesz wtyczki. Na Macu po prostu otwórz Android Studio -> kliknij Android Studio na górnym pasku -> kliknij Prefrences -> znajdź szablony plików i kodów na liście -> wybierz obejmuje -> skompiluj i będą trwałe we wszystkich twoich projektach


2
  • Innym sposobem dodania komentarza do dokumentów Java jest naciśnięcie: Ctrl + Shift + A >> wyświetlenie wyskakującego okienka >> wpisz: Dodaj javadocs >> Enter.

  • Ctrl + Koszula + A: Wyszukiwanie poleceń (nazwa polecenia autouzupełniania)

wprowadź opis zdjęcia tutaj


2

Po prostu wybierz (tj. Kliknij) nazwę metody, a następnie użyj kombinacji klawiszy Alt + Enter, wybierz „Dodaj JavaDoc”

Zakłada się, że nie dodałeś jeszcze komentarzy powyżej metody, w przeciwnym razie opcja „Dodaj JavaDoc” nie pojawi się.


2

W Android Studio mamy kilka sposobów na automatyczne generowanie komentarzy:

  • Metoda I:

Wpisując / **, a następnie naciskając Enter, możesz wygenerować następny wiersz komentarza, a on automatycznie wygeneruje parametry itp., Ale gdy potrzebujesz skrótu do tej metody sprawdzania II poniżej.

  • ** Metoda II: **

1 - Idź do góry Menu

2 - Plik> Ustawienia

3 - Wybierz Keymap z ustawień

4 - W prawym górnym rogu paska wyszukiwania wyszukaj „Napraw dokument”

5 - Wybierz „napraw komentarz do dokumentu” z wyników i kliknij go dwukrotnie

6 - Wybierz Dodaj skrót klawiaturowy z otwartego menu po dwukrotnym kliknięciu

7 - Naciśnij klawisze skrótu na klawiaturze

8 - Przejdź do kodu i tam, gdzie chcesz dodać komentarz, naciśnij klawisz skrótu

9 - Ciesz się!


Najbardziej przekonujący sposób dodawania dokumentów. Np. Przypisałem „” i Enter jako skrót
CodeToLife

1

Wystarczy wybrać wersję klawisza Eclipse w ustawieniach mapy klawiszy. Mapa klawiszy Eclipse jest zawarta w Android Studio.


0

Nie jestem pewien, czy w pełni rozumiem pytanie, ale listę skrótów klawiaturowych można znaleźć tutaj - Mam nadzieję, że to pomaga!


2
W Eclipse, aby dodać komentarz javadoc naciśnij Alt + Shift + J, ale w AndroidStudio ale nie wiem jak to zrobić
qinxianyuzou

O ile pamiętam, ten skrót działał tylko wtedy, gdy masz zainstalowaną i włączoną wtyczkę „jautodoc”.
Matt

0

Android Studio -> Preferencje -> Edytor -> Intencje -> Java -> Deklaracja -> Włącz „Dodaj JavaDoc”

Po wybraniu Methods to Implement (Ctrl / Cmd + i) w lewym dolnym rogu powinieneś zobaczyć pole wyboru, aby włączyć Kopiuj JavaDoc.



-5

ALT+ SHIFT+ Gutworzy automatycznie wygenerowane komentarze do metody (umieść kursor w pozycji początkowej metody).


public void hideKeyboard () powinieneś umieścić kursor przed public i wypróbować go lub sprawdzić, czy zainstalowałeś java doc w swoim studio.
Dinesh IT

Dla mnie to też nie działa. Może działa w specjalnej mapie klawiszy. Mapę klawiszy można skonfigurować w Preferencje> Mapa klawiszy. Lub mapa klawiszy została edytowana.
Oliver Kranz,
Korzystając z naszej strony potwierdzasz, że przeczytałeś(-aś) i rozumiesz nasze zasady używania plików cookie i zasady ochrony prywatności.
Licensed under cc by-sa 3.0 with attribution required.