每次Push时在GitLab上创建JavaDoc

Question

我正在开发一个Java项目，它运行在GitLab上。我正在尝试找到一种方法，使得GitLab在每次推送时自动生成Java文档。

我尝试使用Maven的JavaDoc插件，并通过pipeline调用它。但是该插件需要文件“javadoc.exe”，它只存在于我的计算机本地，而不在GitLab上。

有没有可能在没有此文件的情况下运行该插件？或者有其他选项来解决这个问题吗？

谢谢！

- CodeMaster3000

---

Javadoc插件需要Maven和Java。你的流水线中没有可用的Java吗？ - J Fabian Meier

Answer 1

选项1. 使用包含javadoc的JDK镜像

证明:

$ docker run -it --rm openjdk javadoc --version
javadoc 12.0.1

GitLab CI工作的示例：

generate-doc:
  image: openjdk
  script:
    - javadoc ...

选项2. 通过npm安装javadoc

参见文档：https://www.npmjs.com/package/javadoc

证明：

Translated:

$ npm install -s javadoc
+ javadoc@1.0.6
added 235 packages from 100 contributors and audited 81 packages in 8.795s
found 0 vulnerabilities

$ javadoc --version
javadoc 12.0.1

GitLab CI工作的示例：

generate-doc:
  image: node
  script:
    - npm install -s javadoc
    - javadoc ...

- Ivan