Tycho构建无法自动生成Source Feature问题及插件作用咨询

问题背景 #

使用Tycho构建Eclipse项目时，已配置tycho-source-plugin并执行mvn clean verify，但repository模块报错无法找到com.test.A.feature.source.feature.group依赖，无法自动生成Source Feature。添加tycho-p2-plugin:p2-metadata执行配置后问题解决，现说明该配置的具体作用。

项目相关信息 #

项目结构 #

category.xml #

<?xml version="1.0" encoding="UTF-8"?>
<site>
   <feature id="com.test.A.feature" version="0.0.0">
      <category name="com.test.A.repository"/>
   </feature>
   <feature id="com.test.A.feature.source" version="0.0.0">
      <category name="com.test.A.repository"/>
   </feature>
   <category-def name="com.test.A.repository" label="Test A"/>
</site>

根pom.xml #

<?xml version="1.0"?>
<project
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://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>

    <groupId>com.test</groupId>
    <artifactId>build</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>pom</packaging>

    <properties>
        <tycho.version>4.0.10</tycho.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <modules>
        <module>com.test.A</module>
        <module>com.test.A.feature</module>
        <module>com.test.A.repository</module>
    </modules>

    <build>
        <plugins>
            <plugin>
                <groupId>org.eclipse.tycho</groupId>
                <artifactId>tycho-maven-plugin</artifactId>
                <extensions>true</extensions>
            </plugin>

            <plugin>
                <groupId>org.eclipse.tycho</groupId>
                <artifactId>tycho-packaging-plugin</artifactId>
                <configuration>
                    <format>yyyyMMdd-HHmm</format>
                </configuration>
            </plugin>

            <plugin>
                <groupId>org.eclipse.tycho</groupId>
                <artifactId>tycho-source-plugin</artifactId>
                <executions>
                    <execution>
                        <id>plugin-source</id>
                        <goals>
                            <goal>plugin-source</goal>
                        </goals>
                    </execution>
                    <execution>
                        <id>feature-source</id>
                        <goals>
                            <goal>feature-source</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
        </plugins>

        <pluginManagement>
            <plugins>
                <plugin>
                    <groupId>org.eclipse.tycho</groupId>
                    <artifactId>tycho-maven-plugin</artifactId>
                    <version>${tycho.version}</version>
                </plugin>
                <plugin>
                    <groupId>org.eclipse.tycho</groupId>
                    <artifactId>tycho-packaging-plugin</artifactId>
                    <version>${tycho.version}</version>
                </plugin>
                <plugin>
                    <groupId>org.eclipse.tycho</groupId>
                    <artifactId>tycho-source-plugin</artifactId>
                    <version>${tycho.version}</version>
                </plugin>
            </plugins>
        </pluginManagement>
    </build>
</project>

构建命令 #

mvn clean verify

错误日志 #

[INFO] ------------------------------------------------------------------------
[INFO] Reactor Summary:
[INFO] 
[INFO] build 0.0.1-SNAPSHOT ............................... SUCCESS [  0.126 s]
[INFO] [bundle] A 1.0.0-SNAPSHOT .......................... SUCCESS [  2.514 s]
[INFO] [feature] A Feature 1.0.0-SNAPSHOT ................. SUCCESS [  0.507 s]
[INFO] [updatesite] com.test.A.repository.eclipse-repository 0.0.1-SNAPSHOT FAILURE [  0.079 s]
[INFO] ------------------------------------------------------------------------
[INFO] BUILD FAILURE
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  10.819 s
[INFO] Finished at: 2024-11-27T19:44:00+08:00
[INFO] ------------------------------------------------------------------------
[ERROR] Cannot resolve dependencies of project com.test:com.test.A.repository.eclipse-repository:eclipse-repository:0.0.1-SNAPSHOT
[ERROR]  with context {osgi.os=win32, osgi.ws=win32, org.eclipse.update.install.features=true, osgi.arch=x86_64, org.eclipse.update.install.sources=true}
[ERROR]   Software being installed: com.test.A.repository.eclipse-repository raw:0.0.1.'SNAPSHOT'/format(n[.n=0;[.n=0;[-S]]]):0.0.1-SNAPSHOT
[ERROR]   Missing requirement: com.test.A.repository.eclipse-repository raw:0.0.1.'SNAPSHOT'/format(n[.n=0;[.n=0;[-S]]]):0.0.1-SNAPSHOT requires 'org.eclipse.equinox.p2.iu; com.test.A.feature.source.feature.group 0.0.0' but it could not be found: See log for details
[ERROR] -> [Help 1]

解决方案 #

在根pom.xml的build/plugins节点中添加以下配置：

<plugin>
    <groupId>org.eclipse.tycho</groupId>
    <artifactId>tycho-p2-plugin</artifactId>
    <executions>
        <execution>
            <id>p2-metadata</id>
            <goals>
                <goal>p2-metadata</goal>
            </goals>
            <phase>package</phase>
        </execution>
    </executions>
</plugin>

tycho-p2-plugin:p2-metadata的具体作用 #

1. 生成P2核心元数据：Tycho构建依赖Eclipse的P2供给系统管理依赖与安装逻辑，p2-metadata目标会为项目生成的所有构件（包括tycho-source-plugin生成的源码Feature）创建artifacts.xml和content.xml等P2元数据文件，这些文件是P2系统识别、查找构件的核心依据。
2. 注册源码构件到P2索引：tycho-source-plugin仅负责生成源码包，但不会自动将其注册到P2构件索引中。p2-metadata执行时会扫描项目输出的所有构件，将源码Feature的信息写入P2元数据，让repository模块在解析依赖时能找到com.test.A.feature.source.feature.group。
3. 同步版本与依赖关系：该目标会确保P2元数据中的构件版本、依赖关系与项目配置完全一致，避免出现版本不匹配或依赖无法识别的问题。在本次场景中，源码Feature版本与主Feature对应，但缺少P2元数据时，repository模块无法识别其存在。
4. 补全Tycho构建流程：对于包含源码构件的项目，tycho-source-plugin负责生成源码包，而P2元数据的生成需要由tycho-p2-plugin完成。缺少此步骤时，repository模块打包时无法从本地构建仓库找到源码Feature的P2索引，从而抛出依赖缺失错误。

内容的提问来源于stack exchange，提问作者Bourbon_7