Posso usar teclas de atalho no Android studio para gerar comentários javadoc?
Caso contrário, qual é a maneira mais fácil de gerar comentários javadoc?
Posso usar teclas de atalho no Android studio para gerar comentários javadoc?
Caso contrário, qual é a maneira mais fácil de gerar comentários javadoc?
Respostas:
Não consigo encontrar nenhum atalho para gerar comentários javadoc. Mas se você digitar /**
antes da declaração do método e pressionar Enter, o bloco de comentários javadoc será gerado automaticamente.
Leia isto para mais informações.
Para gerar comentários, digite a /**
tecla antes da declaração do método e pressione Enter
. Ele irá gerar um comentário javadoc.
Exemplo:
/**
* @param a
* @param b
*/
public void add(int a, int b) {
//code here
}
Para mais informações, consulte o link https://www.jetbrains.com/idea/features/javadoc.html
Aqui está um exemplo de um comentário JavaDoc da 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;
}
}
O formato básico pode ser gerado automaticamente de uma das seguintes maneiras:
Você pode instalar o plug-in JavaDoc em Configurações-> Plugin-> Procurar repositórios.
obtenha a documentação do plugin no link abaixo
Você pode usar o estilo eclipse da geração de comentários JavaDoc através de "Corrigir comentário do documento". Abra "Preferências" -> "Mapa de teclas" e atribua a ação "Corrigir comentário do documento" a uma chave desejada.
Aqui podemos algo como isto. E, em vez de usar qualquer atalho, podemos escrever comentários "padrão" no nível da classe / pacote / projeto. E modifique conforme a exigência
*** 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.
A vantagem é que, você pode criar um bloco de comentários para all the methods at a time.
Os comentários do Javadoc podem ser anexados automaticamente usando o recurso de preenchimento automático do IDE. Tente digitar /**
e pressionar Enterpara gerar um exemplo de comentário 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
*/
No Android Studio, você não precisa do plug-in. Em um Mac, abra o Android Studio -> clique em Android Studio na barra superior -> clique em Prefrences -> encontre Modelos de arquivo e código na lista -> selecione inclui -> construa e será persistente em todo o seu projeto
Simplesmente selecione (ou seja, clique) no nome do método e, em seguida, use a combinação de teclas Alt + Enter, selecione "Adicionar JavaDoc"
Isso pressupõe que você ainda não adicionou comentários acima do método; caso contrário, a opção "Adicionar JavaDoc" não aparecerá.
No Android studio, temos algumas maneiras de gerar comentários automaticamente:
Digitando / ** e, em seguida, pressionando Enter, você pode gerar a próxima linha de comentário e ela gerará automaticamente os parâmetros, etc. mas quando você precisar da tecla de atalho para este método de verificação II abaixo.
1 - Ir para o topoMenu
2 - Arquivo> Configurações
3 - Selecione Keymap nas configurações
4 - Na barra de pesquisa no canto superior direito, pesquise "Fix Doc"
5 - Selecione o "corrigir comentário do documento" nos resultados e clique duas vezes nele
6 - Selecione Adicionar atalho de teclado no menu suspenso aberto após clicar duas vezes.
7 - Pressione as teclas de atalho no teclado
8 - Vá para o seu código e, onde você deseja adicionar algum comentário, pressione a tecla de atalho
9 - Aproveite!
Basta selecionar a versão Eclipse do keycap nas configurações de Keymap. Um Eclipse Keymap está incluído no Android Studio.
Não sei se entendi completamente a pergunta, mas uma lista de atalhos do teclado pode ser encontrada aqui - Espero que ajude!
Eu recomendei o Dokka para o javadoc com comentários e muito mais
ALT+ SHIFT+ Gcriará os comentários gerados automaticamente para o seu método (coloque o cursor na posição inicial do seu método).