editplus中如何设置生成javadoc说明文档的

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了editplus中如何设置生成javadoc说明文档的相关的知识,希望对你有一定的参考价值。

使用eclipse生成文档(javadoc)主要有三种方法:
1. 在项目列表中按右键,选择Export(导出),然后在Export(导出)对话框中选择java下的javadoc,提交到下一步。
在Javadoc Generation对话框中有两个地方要注意的:
javadoc command:应该选择jdk的bin/javadoc.exe
destination:为生成文档的保存路径,可自由选择。
按finish(完成)提交即可开始生成文档。
2. 用菜单选择:File->Export(文件->导出),
剩下的步骤和第一种方法是一样的。
3. 选中要生成文档的项目,然后用菜单选择,
Project->Generate Javadoc直接进入Javadoc Generation对话框,剩余的步骤就和第一种方法在Javadoc Generation对话框开始是一样的。

用哪种方法都行,但是要注意一下几个问题:
1、eclipse不能生成,报错:
java.lang.IllegalArgumentException at sun.net.www.ParseUtil.decode
,这是由于设置java环境变量引起的。例如classpath为
.;%JAVA_HOME\lib\dt.jar;%JAVA_HOME%\lib\tool.jar,解决方法就是把classpath删除或是参考官方文档 http://maven.apache.org/plugins/maven-javadoc-plugin/faq.html
2、生成文档乱码问题。完善api-doc,用eclipse生成javadoc的时候发生“编码 GBK 的不可映射字符 ”其实是字符编码问题。打开eclipse,project -> Generate javadoc 一项一项的选你要输出javadoc的项目,最后一步中VM设置行中加入以下代码

复制代码 代码如下:
-encoding utf-8 -charset utf-8
参考技术A 我会。明天教你

如何使用 gradle 从 Javadoc 跳过自动生成的类

【中文标题】如何使用 gradle 从 Javadoc 跳过自动生成的类【英文标题】:How to skip autogenerated classes from Javadoc using gradle 【发布时间】:2021-04-26 18:22:27 【问题描述】:

在一个 Android 库项目中,我使用 Gradle 脚本生成 Javadocs:

task androidJavadocs(type: Exec, dependsOn: buildJavadocsClasspath) 
  doFirst 

    executable = 'javadoc'

    args = [
        '-classpath', javadocsClasspath,
        '-sourcepath', './src/main/java',
        '-subpackages', 'com.example.myproject',
        '-d', javadocsDestinationDir,
        '-exclude', 'com.example.myproject.internal',
        '-doctitle', project.getName() + " " + VERSION_NAME + " API",
        '-windowtitle', POM_NAME + " API",
        '-link', "http://docs.oracle.com/javase/8/docs/api/",
        '-Xdoclint:none',
        '-quiet'
    ]
  

问题在于,在为引用自动生成的类(如 BuildConfig 或 DaggerMyClientComponent)的类生成 javadoc 时,Javadoc 返回警告 (Java 8) 或错误 (Java 11)

./src/main/java/com/example/myproject/MyClient.java:13: error: cannot find symbol
import com.example.myproject.internal.DaggerMyClientComponent;
                                              ^
  symbol:   class DaggerMyClientComponent
  location: package com.example.myproject.internal
./src/main/java/com/example/myproject/internal/storage/client/SdkVersionStorage.java:9: error: cannot find symbol
import com.example.myproject.BuildConfig;
                                     ^
  symbol:   class BuildConfig
  location: package com.example.myproject
./src/main/java/com/example/myproject/internal/utils/UserAgentHeader.java:8: error: cannot find symbol
import com.example.myproject.BuildConfig;
                                     ^
  symbol:   class BuildConfig
  location: package com.example.myproject

我不明白的一件事是,两个错误来自已经使用“exclude”参数从 javadoc 中排除的内部类。

除此之外,我看不到修复或抑制这些错误的选项。添加 com.example.myproject.internal.DaggerMyClientComponent 之类的排除规则不起作用。

使用 Android Studio 生成 Javadocs 不是一个选项,我需要使用可以在 CI (Bitrise) 中使用的脚本。

【问题讨论】:

你有什么运气吗?我正在遭受完全相同的问题。由于排除我的内部包裹而收到错误 【参考方案1】:

你有两种方法解决这个问题:

选项 1

在 javadoc 命令中添加--ignore-source-errors(我从this other answer 中采用了这种方法)

对于那些使用 javadoc gradle 任务的人,他们可以这样添加:

options.addBooleanOption('-ignore-source-errors', true)

选项 2

或者将 BuildConfig.java 文件的路径添加到 sourcepath 中(以备不时之需)

对于使用 javadoc gradle 任务的人,请将其添加到 source 属性中:

source = android.sourceSets.main.java.source + file('build/generated/source/buildConfig/release/your/package/BuildConfig.java').path

【讨论】:

以上是关于editplus中如何设置生成javadoc说明文档的的主要内容,如果未能解决你的问题,请参考以下文章

用MyEclipse生成doc文档的问题

如何在eclipse中,为整个工程生成javadoc文档

如何在eclipse 中设置自动添加Javadoc注释

JAVA之旅——this,static,关键字,main函数,封装工具类,生成javadoc说明书,静态代码块

Intellij IDEA生成JavaDoc(转发)

如何在 Javadocs 中引用 Lombok 生成的方法? [复制]