生成domino-jna 0.9.2.1 Javadoc及构建时遇多错误求助

1. Javadoc生成失败 #

首次使用domino-jna，在目录\domino-jna-master\domino-jna\src\main\java\com\mindoo\domino\jna执行以下命令生成Javadoc到c:\JNA：

javadoc -sourcepath {parent-folder}\domino-jna-master\domino-jna\src\main\java\com\mindoo\domino\jna -d c:\JNA -subpackages .

虽能找到.java文件，但出现cannot find symbol、package lotus.notes does not exist错误。添加-Xdoclint:none和--ignore-source-errors参数后，仍提示no public or protected classes found to document，用Eclipse操作也无效。

2. Maven构建依赖缺失 #

调整lwpd.domino.napi.jar的安装命令为：

mvn install:install-file -Dfile="C:\Program Files\HCL\Notes\jvm\lib\ext\lwpd.domino.napi.jar" -DgroupId=com.ibm -DartifactId=napi -Dversion=12.0.2 -Dpackaging=jar

执行Maven构建命令时：

mvn -DJVMPARAMS= -DDOMINOOSGIDIR="C:\Program Files\HCL\Notes\osgi" -DDOMINODIR="C:\Program Files\HCL\Notes" -DNOTESINI="C:\Program Files\HCL\Notes\Notes.ini" clean install -Dmaven.test.skip=true

出现依赖缺失错误：找不到com.ibm:domino-api-binaries:jar:11.0.0。

针对Javadoc生成问题 #

• 补充依赖类路径：javadoc命令需要指定Notes相关依赖的jar包路径，比如lotus.notes.jar（通常在Notes安装目录的jvm/lib/ext下），用-classpath参数添加。修改后的命令示例：

  javadoc -sourcepath {parent-folder}\domino-jna-master\domino-jna\src\main\java -classpath "C:\Program Files\HCL\Notes\jvm\lib\ext\lotus.notes.jar;C:\Program Files\HCL\Notes\jvm\lib\ext\lwpd.domino.napi.jar" -d c:\JNA -subpackages com.mindoo.domino.jna
  

  注意：-sourcepath应指向源码根目录（src/main/java）而非子包目录，-subpackages直接指定完整包名com.mindoo.domino.jna，避免用.导致范围错误。
• 检查类的访问修饰符：如果提示无公开/受保护类，确认目标包下的类是否真的有public或protected修饰，或者是否命令指定的包范围正确。

针对Maven构建依赖缺失问题 #

• 手动安装domino-api-binaries依赖：这个包是Notes的私有API包，需要从Notes安装目录找到对应的jar包（通常在osgi/shared/eclipse/plugins下，文件名类似com.ibm.domino.api.binaries_*.jar），然后用Maven安装到本地仓库：

  mvn install:install-file -Dfile="C:\Program Files\HCL\Notes\osgi\shared\eclipse\plugins\com.ibm.domino.api.binaries_12.0.2.jar" -DgroupId=com.ibm -DartifactId=domino-api-binaries -Dversion=12.0.2 -Dpackaging=jar
  

  注意版本号要和你的Notes版本匹配（这里用12.0.2对应你的Notes 12.0.2）。
• 确认版本一致性：检查项目pom.xml中domino-api-binaries的依赖版本是否和你安装的一致，避免版本不匹配导致找不到依赖。

内容的提问来源于stack exchange，提问作者Adam