Android Studio에서 javadoc 주석을 생성하는 방법


204

Android Studio에서 단축키를 사용하여 javadoc 주석을 생성 할 수 있습니까?

그렇지 않은 경우 javadoc 주석을 생성하는 가장 쉬운 방법은 무엇입니까?


이 질문은 50/50입니다. 문서 전체에서 javadoc을 생성하는 단일 javadoc 블록을 찾고 있습니다. 무엇 이니?
K-SO의 독성이 증가하고 있습니다.

ALTR + ENTER는 이미 선언 된 메소드의 주석을 생성 할 수있는보기를 표시합니다.
Zala Janaksinh 2016 년

라이브 템플릿 (Android studio-설정-편집기-라이브 템플릿-추가)을 추가해야 할 수 있습니다. 템플릿 텍스트 필드에 다음 텍스트를 추가하십시오. / ** * $ comment $ * /
Johnett Mathew

답변:


388

javadoc 주석을 생성하는 단축키를 찾을 수 없습니다. 그러나 /**메소드 선언 전에 입력하고 Enter를 누르면 javadoc 주석 블록이 자동으로 생성됩니다.

자세한 내용은 이것을 읽으십시오 .


7
클래스, 필드 등에 대한 javadoc 주석을 생성하는데도 작동하지 않는 것은 부끄러운 일입니다. 사용자 정의 가능한 템플릿에서 javadoc을 생성하면 더 좋을 것입니다.
Ted Hopp

23
물론 바로 가기가 있습니다 : 메소드 / 생성자 이름의 위치와 alt + enter를 누르고 메뉴에서 javadoc 생성을 선택하십시오
Ewoks

참고 더에 대해 위의 솔루션
Pritesh하기 Vishwakarma

110

주석을 생성하려면 /**메소드 선언 전에 키를 입력 하고를 누르십시오 Enter. javadoc 주석을 생성합니다.

예:

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

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

자세한 정보는 https://www.jetbrains.com/idea/features/javadoc.html 링크를 확인 하십시오.


4
@satheeshwaran-정말? 예제를 제외하고는 DouO (원래 답변)의 답변과 동일합니다. 링크조차도 사본입니다. 예제는 원래 답변에 추가되었을 것입니다.
CJBS

3
@satheeshwaran-가치있는 것에 대해, 답변의 예를 보는 것만으로도 빠르게 답변을 원할 때 유용합니다
CJBS

실제로 예 / 마지막 전에 * 부족
막시 암브로시니

35

다음은 Oracle의 JavaDoc 주석 예입니다 .

/**
 * 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 추가를 클릭하십시오. 여기에 이미지 설명을 입력하십시오

17

설정-> 플러그인-> 브라우저 찾아보기에서 JavaDoc 플러그인을 설치할 수 있습니다.

아래 링크에서 플러그인 문서를 얻으십시오.

JavaDoc 플러그인 문서

여기에 이미지 설명을 입력하십시오


이것은 잘 작동합니다. (위와 같이)의 JavaDoc 플러그인을 설치 한 후 CNTL +의 SHIFT + ALT + G. 눌러
앨런 넬슨

10

"문서 주석 수정"을 통해 Eclipse 스타일의 JavaDoc 주석 생성을 사용할 수 있습니다. "환경 설정"-> "키맵"을 열고 "문서 주석 수정"조치를 원하는 키에 지정하십시오.


9

여기서 우리는 이와 같은 것을 할 수 있습니다. 그리고 단축키를 사용하는 대신 클래스 / 패키지 / 프로젝트 레벨에서 "기본"주석을 작성할 수 있습니다. 요구 사항에 따라 수정

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


9

IDE의 자동 완성 기능을 사용하여 Javadoc 주석을 자동으로 추가 할 수 있습니다. 입력 /**하고 쳐서 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
 */

5

Android Studio에서는 플러그인이 필요하지 않습니다. Mac의 경우 Android Studio를 열고-> 상단 표시 줄에서 Android Studio를 클릭하고-> Prefrences-> 목록에서 파일 및 코드 템플릿 찾기-> 포함 선택-> 빌드 모든 프로젝트에서 지속될 것입니다


2
  • Java 문서 주석을 추가하는 또 다른 방법은 Ctrl + Shift + A >> 팝업 표시 >> 유형 : javadocs 추가 >> Enter를 누르는 것 입니다.

  • Ctrl + Shirt + A : 명령 조회 (자동 완성 명령 이름)

여기에 이미지 설명을 입력하십시오


2

메소드 이름을 선택 (예 : 클릭) 한 다음 Alt + Enter 키 조합을 사용하여 "Add JavaDoc"을 선택하십시오.

이는 메소드 위에 주석을 아직 추가하지 않은 것으로 가정합니다. 그렇지 않으면 "Add JavaDoc"옵션이 나타나지 않습니다.


2

Android 스튜디오에는 댓글을 자동 생성하는 방법이 거의 없습니다.

  • 방법 I :

/ **를 입력하고 Enter를 누르면 다음 주석 행을 생성 할 수 있으며 매개 변수 등을 자동으로 생성하지만 아래에서이 체크 아웃 방법 II에 대한 단축키가 필요한 경우.

  • ** 방법 II : **

1-맨 위로 이동

2-파일> 설정

3-설정에서 키맵을 선택하십시오

4-오른쪽 상단 검색 창에서 "문서 수정"을 검색하십시오.

5-결과에서 "문서 수정 사항 수정"을 선택하고 두 번 클릭하십시오.

6-두 번 클릭 한 후 열린 드롭 다운에서 키보드 단축키 추가를 선택하십시오.

7-키보드의 단축키를 누릅니다

8-코드로 이동하고 주석을 추가하려는 위치에서 단축키를 누릅니다.

9-즐기세요!


문서를 추가하는 가장 확실한 방법입니다. 예를 들어 "" "를 지정하고 바로 가기로 입력
CodeToLife

1

키맵 설정에서 Eclipse 버전의 키캡을 선택하기 만하면됩니다. Eclipse Keymap은 Android Studio에 포함되어 있습니다.


0

질문을 완전히 이해하지는 못했지만 키보드 단축키 목록을 여기 에서 찾을 수 있습니다 . 도움이 되길 바랍니다.


2
javadoc의 코멘트를 추가하는 일식에서 Alt 키 + 시프트 +의 J를 눌러하지만,하지만, 안드로이드 스튜디오에서 나는 어떻게 해야할지하지 않습니다
qinxianyuzou

내가 기억한다면, 'jautodoc'플러그인을 설치하고 활성화 한 경우에만 해당 바로 가기가 작동했습니다.
Matt

0

Android Studio-> 환경 설정-> 편집기-> 의도-> Java-> 선언-> "JavaDoc 추가"사용

그리고 왼쪽 하단에 구현 방법 (Ctrl / Cmd + i)을 선택하는 동안 JavaDoc 복사를 활성화하는 확인란이 표시되어야합니다.



-5

ALT+ SHIFT+ G는 메소드에 대해 자동 생성 된 주석을 작성합니다 (메소드를 메소드의 시작 위치에 놓으십시오).


public void hideKeyboard () u 커서를 public 앞에 놓고 시도하거나 스튜디오에 java doc을 설치했는지 확인하십시오.
Dinesh IT

그것은 나에게도 효과가 없다. 어쩌면 특수 키 맵에서 작동 중일 수 있습니다. 키맵은 환경 설정> 키맵에서 구성 할 수 있습니다. 또는 키맵이 편집되었습니다.
Oliver Kranz
당사 사이트를 사용함과 동시에 당사의 쿠키 정책개인정보 보호정책을 읽고 이해하였음을 인정하는 것으로 간주합니다.
Licensed under cc by-sa 3.0 with attribution required.