- html - 出于某种原因,IE8 对我的 Sass 文件中继承的 html5 CSS 不友好?
- JMeter 在响应断言中使用 span 标签的问题
- html - 在 :hover and :active? 上具有不同效果的 CSS 动画
- html - 相对于居中的 html 内容固定的 CSS 重复背景?
我只想从专用文档项目中为我的项目的某些 Artifact 生成 javadoc。
这意味着我想要一个名为“docs”的独立项目。在 docs/pom.xml 中,我想定义应包含在生成的 javadocs 中的 Artifact 。
到目前为止,我了解到我必须为我想要包含的项目生成一个单独的sources.jar。但我不知道如何继续下去。
目前我只能想象两种方法:
获取我想要包含的 Artifact (sources.jar),解压它们并以某种方式将 Javadoc 插件指向源目录。
将我感兴趣的 Artifact 定义为依赖项,并使用 javadoc-plugin 的“dependencySourceInclude”选项。但我不确定这是否是预期的用法。
有什么建议可以解决这个问题吗?
最佳答案
我自己找到了解决方案。这有点麻烦,但对我来说确实有用。我选择遵循我的第一个想法:
Get the artifacts (sources.jar) I want to include, unpack them and somehow point the javadoc plugin to the source directory.
这个解决方案有四个不同的部分,我稍后将更详细地解释:
现在更详细:
<强>1。在我想要包含的所有 Artifact 中生成sources.jar
要生成sources.jar,您必须使用maven-sources-plugin,如下所示:
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
<version>2.1.2</version>
<executions>
<execution>
<id>bundle-sources</id>
<phase>package</phase>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
您必须在要包含在 apidocs 中的每个项目/模块/Artifact 中执行此操作。
<强>2。解压这些sources.jars
在用于生成javadoc的pom.xml中,您必须添加以下插件来解压sources.jar文件。
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<executions>
<execution>
<id>unpack-artifact-sources</id>
<phase>generate-resources</phase>
<goals>
<goal>unpack</goal>
</goals>
<configuration>
<artifactItems>
<artifactItem>
<groupId>${project.groupId}</groupId>
<artifactId><!-- your artifact here --></artifactId>
<version>${project.version}</version>
<classifier>sources</classifier>
<overWrite>true</overWrite>
</artifactItem>
</artifactItems>
<outputDirectory>${project.build.directory}/unpack_sources</outputDirectory>
</configuration>
</execution>
<!-- add more unpack-executions here -->
</executions>
</plugin>
您可以根据需要添加任意数量的解包执行 block 。
<强>3。通过将 javadoc-plugin 指向解压的源代码来生成 Javadoc
现在是棘手的部分。让 javadoc-plugin 知道在哪里查找源文件。导入的定义是 <sourcepath>
定义。在本节中,我们定义在步骤 2 中解压源代码的文件夹。
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.7</version>
<configuration>
<sourcepath>${project.build.directory}/unpack_sources</sourcepath>
</configuration>
<executions>
<execution>
<goals>
<goal>javadoc</goal>
</goals>
<phase>process-resources</phase>
</execution>
</executions>
</plugin>
当您调用mvn clean install
时此时您将得到 site
target
内的文件夹文件夹。在此站点文件夹中,您将找到您的 apidocs。但为了让这个构建变得光彩夺目,我们希望将 apidocs 组装到一个 zip 存档中。
<强>4。将生成的 apidocs 打包为 zip 文件
要组装文档,您必须使用 maven-assembly-plugin
和一个额外的汇编文件。首先是 pom 中的插件定义:
<plugin>
<artifactId>maven-assembly-plugin</artifactId>
<executions>
<execution>
<id>docs-assembly</id>
<phase>package</phase>
<configuration>
<appendAssemblyId>false</appendAssemblyId>
<descriptors>
<descriptor>src/main/assembly/assemble.xml</descriptor>
</descriptors>
</configuration>
<goals>
<goal>single</goal>
</goals>
</execution>
</executions>
</plugin>
汇编.xml:
<?xml version="1.0" encoding="UTF-8"?>
<assembly>
<id>${project.build.finalName}</id>
<formats>
<format>zip</format>
</formats>
<includeBaseDirectory>false</includeBaseDirectory>
<fileSets>
<fileSet>
<directory>target/site/apidocs</directory>
<outputDirectory>/</outputDirectory>
</fileSet>
</fileSets>
</assembly>
关于Maven 3 : Generate Javadoc for defined artifacts,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/4947215/
对于 Nexus 中的 Artifact ,我想找出类路径,即该 Artifact 是针对哪个 Artifact 的哪个版本构建的。当然,解析pom会给出一些提示,但由于我们有父POM、依赖管理等,这
我想将库部署到公司的远程存储库。 这是我第一次要将库项目部署到远程存储库。 我收到以下错误消息: org.sonatype.aether.transfer.ArtifactNotFoundExcept
在我们的 Artifact 上,我们有POM文件为 commons-lang commons-lang 2.6 4.0.0 commons-lang commons-la
我们使用 Maven 来构建我们的项目,并使用 Nexus 作为存储库管理器。 有没有办法知道一个 Artifact 在哪里是另一个 Artifact 的依赖项? 例如,我们想知道我们的发布存储库中的
我已经重新初始化了我的 pom.xml,但是我得到了: ArtifactDescriptorException: Failed to read artifact descriptor for org.
将maven Android 项目导入eclipse 时出现以下错误: Could not update project assistance configuration me.gladwell.
假设,ArtifactA 依赖于 ArtifactB,ArtifactC 也依赖于 ArtifactB 我知道“mvn dependency plugin”可以帮助列出项目/Artifact 的依赖项
在我的 Maven 构建结束时,一个用于此明确目的的模块从各种其他模块收集 Artifact ,并使用 Assembly 插件将它们压缩到一个存档中。完成后,它会使用 Deploy 插件将它们部署到
我有一个我正在尝试构建的相对较新的项目。 Gradle 同步正常,但每当我尝试构建时,都会收到如下错误: Execution failed for task ':app:kaptGenerateStu
我在 Azure DevOps 中设置了 Gradle 构建,它在 Azure DevOps git 存储库中编译代码,然后将生成的 JAR(作为 Maven Artifact )发布到 Azure
提出这个问题的另一种方式是: 如何验证maven使用 Azure 进行项目 personal access token这样Maven构建就可以下载artifacts发表于Azure Artifacts
提出这个问题的另一种方式是: 如何验证maven使用 Azure 进行项目 personal access token这样Maven构建就可以下载artifacts发表于Azure Artifacts
这与具有类似错误的现有问题有点不同 - 我不认为这是重复的。 我有项目 A,我使用 mvn clean install 在本地成功构建并安装了该项目。 我验证了director中存在jar和pom~/
我有一个包含此存储库的 Artifact 服务器 发布 锁定版本 我必须将一些 Artifact (大约 50.000 个)从版本移至锁定版本... 我需要识别具有精确版本的 Artifact : 例
我正在升级一个拥有 3000 多个 java maven 项目和 repos 的庞大系统,从 Java 7 部署到 Java 8。我们将尝试一次迁移部分系统,这意味着一些 Artifact 会使用 j
所以我遇到了一个错误 Failed to read artifact descriptor对于已部署到我本地 Nexus 的插件。我检查了 Nexus 上的 pom。 这个插件依赖于 Maven 2.
在 Azure DevOps 中,我们有 Download/Publish构建工件任务和 Download/Publish管道工件任务。 构建工件任务和管道工件任务之间有什么区别,我们什么时候会选择一
我有一个由 Maven 管理的原始 java webapp(因此会生成一个 WAR 文件),我们称它为 webapp。 我喜欢保持其 Maven 配置不变,但有时我需要通过操作其内容(或以任何方式对其
我有一个 Artifact abc,它有一些测试。我的存储库中有不同版本的 abc。我现在希望能够针对项目的“旧版本”运行最新的测试。 我试图将 Artifact 本身添加到测试依赖项中,但这(当然)
我目前有一个用 Maven 构建的 Java 测试库,并作为 jar 分发。我的项目依赖于一个非常常见的库 (Objectweb ASM),而且我遇到了一些问题,即类路径中已经存在较早且不兼容的 AS
我是一名优秀的程序员,十分优秀!