组装现场，包括儿童答案

【问题标题】：Assembly the site including children组装现场，包括儿童
【发布时间】：2014-10-24 18:34:19
【问题描述】：

部署团队要求我们将我们的 maven 站点打包为一个 war，并将其发布到 Archiva 存储库中。

我们的第一个问题，如何组装战争，里面有子站点。

我试试这个，但它不起作用。 产生的战争不包括儿童网站。我在 maven 文档、google、stackoverflow 等方面进行了研究。但我没有找到任何东西。

项目结构文件夹：

.
├── child-yyyy-1
│   ├── pom.xml
│   └── src
│       ├── main
│       │   └── java
│       │       └── com
│       │           └── xxx
│       │               └── App.java
│       └── test
│           └── java
├── child-yyyy-2
│   ├── pom.xml
│   └── src
│       ├── main
│       │   └── java
│       │       └── com
│       │           └── xxx
│       │               └── App.java
│       └── test
│           └── java
└── parent-site
    ├── assembly
    │   └── api-site.xml
    └── pom.xml

父pom：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.xxx</groupId>
  <artifactId>parent-yyyy</artifactId>
  <version>1.0-SNAPSHOT</version>
  <packaging>pom</packaging>
  <name>parent-yyyy</name>

  <modules>
    <module>../child-yyyy-1</module>
    <module>../child-yyyy-2</module>
  </modules>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-assembly-plugin</artifactId>
                <configuration>
                    <descriptors>
                        <descriptor>assembly/api-site.xml</descriptor>
                    </descriptors>
                </configuration>
                <executions>
                    <execution>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
</project>

api-site.xml

<?xml version="1.0" encoding="UTF-8"?>
<assembly
    xmlns="http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation=" http://maven.apache.org/plugins/maven-assembly-plugin/assembly/1.1.2 http://maven.apache.org/xsd/assembly-1.1.2.xsd">
    <id>api-site</id>
    <formats>
        <format>war</format>
    </formats>
    <baseDirectory>/</baseDirectory>
    <fileSets>
        <fileSet>
            <outputDirectory>/</outputDirectory>
            <directory>target/site</directory>
        </fileSet>
        <fileSet>
            <outputDirectory>/child-yyyy-1/</outputDirectory>
            <directory>child-yyyy-1/target/site</directory>
        </fileSet>
        <fileSet>
            <outputDirectory>/child-yyyy-2/</outputDirectory>
            <directory>child-yyyy-2/target/site</directory>
        </fileSet>
    </fileSets>
</assembly>

孩子 1 个 pom：

<?xml version="1.0"?>
<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>com.xxx</groupId>
    <artifactId>parent-yyyy</artifactId>
    <version>1.0-SNAPSHOT</version>
    <relativePath>../site</relativePath>
  </parent>
  <groupId>com.xxx</groupId>
  <artifactId>child-yyyy-1</artifactId>
  <version>1.0-SNAPSHOT</version>
  <name>child-yyyy-1</name>
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>
</project>

孩子 2 pom：

<?xml version="1.0"?>
<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>com.xxx</groupId>
    <artifactId>parent-yyyy</artifactId>
    <version>1.0-SNAPSHOT</version>
    <relativePath>../site</relativePath>
  </parent>
  <groupId>com.xxx</groupId>
  <artifactId>child-yyyy-2</artifactId>
  <version>1.0-SNAPSHOT</version>
  <name>child-yyyy-2</name>
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>
</project>

【问题讨论】：

某人-1。为什么是-1？请发表评论。

标签： maven maven-3 maven-assembly-plugin

【解决方案1】：

首先是你有错误的项目结构，这意味着你的父级在一个子文件夹中......最好有这样的父级。

  +-- parent (pom.xml)
       +--- child1 (pom.xml)
       +--- child2 (pom.xml)
       ....

这将简化您的父级，您无需为模块提供 ../...而在子级中，您无需在父级中提供 relativePath 元素。

除了在 parent 中定义 maven-assembly-plugin 没有任何意义，因为 parent 将首先执行，这意味着当时您还没有生成站点。

对此的默认解决方案是创建一个单独的子节点

  +-- parent (pom.xml)
       +--- child1 (pom.xml)
       +--- child2 (pom.xml)
       +--- site-child (pom.xml)

像您一样定义 maven-assembly-plugin 并非常重要定义对您想要包含的站点的子站点的依赖项。

根据以上所有内容，使用以下方法生成网站：

mvn site

这意味着您处于站点生命周期中，这意味着您需要在站点生命周期中而不是在默认生命周期中打包战争，您需要从这里更改 maven-assembly-plugin 的配置：

  <build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-assembly-plugin</artifactId>
            <configuration>
                <descriptors>
                    <descriptor>assembly/api-site.xml</descriptor>
                </descriptors>
            </configuration>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

到以下：

  <build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-assembly-plugin</artifactId>
            <configuration>
                <descriptors>
                    <descriptor>assembly/api-site.xml</descriptor>
                </descriptors>
            </configuration>
            <executions>
                <execution>
                    <phase>site</phase>
                    <goals>
                        <goal>single</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

之后应该可以通过以下方式创建这个：

mvn site

【讨论】：