我目前正在GitHub中开发一个Java项目,我需要对每个更新进行手动生成JavaDoc并将其上传到GitHub页面。但这很乏味。
我想知道是否可以用CI自动实现这一点?
发布于 2022-06-09 20:29:11
自动生成带有JavaDoc页面的网页
是的,在您的GitHub操作中使用以下代码是可能的:
name: Deploy Javadoc
on:
push:
branches:
- master
- main
jobs:
publish:
runs-on: ubuntu-latest
steps:
- name: Deploy JavaDoc
uses: MathieuSoysal/Javadoc-publisher.yml@v2.0.4
with:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
javadoc-branch: javadoc
java-version: 17
target-folder: javadoc 信贷:https://github.com/MathieuSoysal/Javadoc-publisher.yml https://github.com/marketplace/actions/deploy-javadoc
当您将代码发布到“主”分支时,此代码会自动发布JavaDoc,您的JavaDoc会被推到javadoc分支上,并与GitHub页面一起部署。
不要忘记在您的GitHub回购设置中启用GitHub页面
在GitHub存储库中创建一个GitHub操作
要创建一个GitHub操作,只需将这个yaml文件添加到您的/.github/workflows/<your-file>.yaml存储库中。
发布于 2022-06-09 20:30:16
对不起,我可能错过了…问题的焦点
但据我所知,CI流程链通常由存储库提供的源文件自动生成工件。
流程链触发各种程序来生成这些人工制品,比如编译器、链接器和其他东西。
那么,调用javadoc工具作为CI链的一部分的问题在哪里呢?
Gradle和Maven都有用于JavaDoc的插件,甚至ant都有启动JavaDoc的命令。
即使对于替代的do工具,也存在将其集成到Gradle和Maven…中的方法。
在最坏的情况下,从批处理文件启动javadoc工具有多大的困难?
https://stackoverflow.com/questions/72565540
复制相似问题