Maven 将生成的 documentation/json 文件上传到存储库
Maven upload generated documentation/json file to repository
我使用私有 MavenPlugin 自动为我的 web / rest 服务生成文档。这个插件会生成一个巨大的 JSON 文件,我想将其与我的 jar 文件一起上传到存储库,这样您就不必检出项目并再次执行 maven 目标来获取文档。我必须根据要求共享特定版本的文档,所以我想我将它们与 versions/artifacts 一起存储在存储库中(作为文件或仅包含一个文件的存档)。
我已经考虑了三种可能性:
创建一个新的 Maven 插件来为我做这种上传,它必须处理检测它应该将 json 推送到(本地和远程 + 配置)的存储库。
使用某种程序集插件 configuration/resource 插件将文档包含在 artifact.jar 或 source.jar 中。但是 IMO 它不应该在那里,因为它很大而且你可以自己用源代码创建它并且 b 我不想从 artifact.jar.
下载和提取它
编辑 MavenPlugin 以告知 install/deploy 插件包含该 json 文件并将其上传到我的存储库。如果可能,请不要在使用 MavenPlugin 的 pom 中为 install/deploy 插件指定显式配置。
第三个是我的首选,但我不知道如何实现它。 (如果我在这里找不到好的解决方案,我可能会调试源代码或 javadoc 插件来检查它们是如何做到的)
如果没有更好的选择,第二个是我会使用的选项。
第一个看起来很尴尬,听起来像是我想避免的很多工作。^^
关于如何实施选项 3 或我可能错过的任何其他替代方案的任何想法?
请仅 Java 或 pom.xml。没有蚂蚁,没有 grails/gradle,没有 bash/shell 脚本。
使用assembly plugin's single
目标将文件打包到单独的分类jar中(例如myApp-jsondocs.jar
)。默认情况下,生成的程序集将附加到项目 - 有关详细信息,请参阅目标的 attach
参数。
我使用私有 MavenPlugin 自动为我的 web / rest 服务生成文档。这个插件会生成一个巨大的 JSON 文件,我想将其与我的 jar 文件一起上传到存储库,这样您就不必检出项目并再次执行 maven 目标来获取文档。我必须根据要求共享特定版本的文档,所以我想我将它们与 versions/artifacts 一起存储在存储库中(作为文件或仅包含一个文件的存档)。
我已经考虑了三种可能性:
创建一个新的 Maven 插件来为我做这种上传,它必须处理检测它应该将 json 推送到(本地和远程 + 配置)的存储库。
使用某种程序集插件 configuration/resource 插件将文档包含在 artifact.jar 或 source.jar 中。但是 IMO 它不应该在那里,因为它很大而且你可以自己用源代码创建它并且 b 我不想从 artifact.jar.
下载和提取它
编辑 MavenPlugin 以告知 install/deploy 插件包含该 json 文件并将其上传到我的存储库。如果可能,请不要在使用 MavenPlugin 的 pom 中为 install/deploy 插件指定显式配置。
第三个是我的首选,但我不知道如何实现它。 (如果我在这里找不到好的解决方案,我可能会调试源代码或 javadoc 插件来检查它们是如何做到的) 如果没有更好的选择,第二个是我会使用的选项。 第一个看起来很尴尬,听起来像是我想避免的很多工作。^^
关于如何实施选项 3 或我可能错过的任何其他替代方案的任何想法?
请仅 Java 或 pom.xml。没有蚂蚁,没有 grails/gradle,没有 bash/shell 脚本。
使用assembly plugin's single
目标将文件打包到单独的分类jar中(例如myApp-jsondocs.jar
)。默认情况下,生成的程序集将附加到项目 - 有关详细信息,请参阅目标的 attach
参数。