如何使用p2-maven-plugin以本地JAR目录为源构建p2仓库

核心问题根因 #

之前配置无法识别本地目录JAR、tycho-extras-p2配置不触发的核心原因：

• 现有p2-maven-plugin默认仅从Maven仓库（本地.m2、远程中央仓）拉取指定坐标的构件，未开启本地文件系统目录的扫描能力
• tycho-extras-p2插件的发布目标需要明确指定输入的平台目录，无自动递归扫描普通文件夹JAR的能力，多数场景下因生命周期绑定错误、goal调用不对，导致配置根本不会实际执行

可直接复用的p2-maven-plugin配置 #

替换原有pom中p2-maven-plugin的硬编码坐标拉取配置，新增本地目录扫描源，同时对齐p2仓库输出路径：

<plugin>
    <groupId>org.reficio</groupId>
    <artifactId>p2-maven-plugin</artifactId>
    <version>1.12.0</version>
    <executions>
        <execution>
            <id>build-local-p2-site</id>
            <phase>process-classes</phase>
            <goals>
                <goal>site</goal>
            </goals>
            <configuration>
                <!-- 固定输出到target/repository，和jetty服务的映射路径对齐 -->
                <repositoryDirectory>${project.build.directory}/repository</repositoryDirectory>
                <!-- 新增本地目录扫描规则 -->
                <fileSources>
                    <fileSource>
                        <!-- 替换为实际存放所有第三方JAR、Eclipse插件JAR的目录路径，支持项目相对路径写法 -->
                        <directory>${project.basedir}/local-libs</directory>
                        <!-- 递归扫描子目录下的所有JAR，避免漏扫层级结构里的插件包 -->
                        <includeSubdirs>true</includeSubdirs>
                        <!-- 自动读取JAR包内MANIFEST.MF的OSGi bundle信息，无需手动为每个JAR写坐标 -->
                        <autodetectArtifact>true</autodetectArtifact>
                    </fileSource>
                </fileSources>
                <!-- 保留原有从.m2拉取指定构件的配置可叠加，不需要的注释掉即可
                <artifacts>
                    <artifact>
                        <id>org.example:demo-component:2.1.0</id>
                    </artifact>
                </artifacts>
                -->
            </configuration>
        </execution>
    </executions>
</plugin>

配置触发验证方法 #

直接通过命令行显式调用插件目标，配合debug日志确认执行状态：

• 执行命令：mvn org.reficio:p2-maven-plugin:1.12.0:site -X
• 查看输出日志，只要打印出本地目录下扫描到的JAR文件列表，就说明配置已被正常触发；若日志仅打印从.m2仓库拉取构件的内容，说明fileSources配置块的嵌套层级写错，未被插件识别

注意：不要将fileSources配置块嵌套到artifacts节点内部，这是之前配置不生效的最常见写法错误

对齐jetty-maven-plugin的静态服务配置 #

调整jetty的资源映射路径，直接将p2仓库目录作为静态资源根路径，无需额外打包war包：

<plugin>
    <groupId>org.eclipse.jetty</groupId>
    <artifactId>jetty-maven-plugin</artifactId>
    <version>10.0.20</version>
    <configuration>
        <webApp>
            <resourceBase>${project.build.directory}/repository</resourceBase>
            <contextPath>/</contextPath>
        </webApp>
        <httpConnector>
            <port>8080</port>
        </httpConnector>
    </configuration>
</plugin>

启动后直接访问http://localhost:8080，能看到p2仓库核心的artifacts.xml、content.xml文件，即可在Eclipse RCP目标定义里添加该站点，正常拉取所有本地目录下的插件包。

高频踩坑点 #

• 不要对本地存放的Eclipse插件JAR开启强制元数据生成开关，否则会覆盖JAR本身携带的Bundle-SymbolicName、版本等信息，导致RCP应用无法匹配到对应插件
• 普通无OSGi元数据的第三方JAR，插件会自动生成兼容的OSGi bundle描述，无需手动修改JAR内容
• 之前遗留的tycho-extras-p2插件的执行配置需要全部删除，避免两个插件同时向同一个输出目录写入p2元数据，导致站点内容冲突

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