如何使用Tycho构建多平台Eclipse更新站点？遇依赖解析失败

这个问题我之前帮不少人排查过——本质是Tycho在构建仓库时，默认会尝试为父pom中配置的所有环境解析每个feature的依赖，而你的三个feature分属不同平台，跨平台解析时自然找不到对应平台的依赖项，从而触发报错。下面是分步解决的方案：

1. 为每个平台专属Feature配置独立环境约束 #

每个平台的Feature模块（比如Windows、Linux、macOS各自的feature项目）需要在自身的pom.xml中，单独配置对应的目标环境，避免Tycho跨平台解析它的依赖：

以Windows平台的Feature为例，在其pom.xml中添加：

<build>
  <plugins>
    <plugin>
      <groupId>org.eclipse.tycho</groupId>
      <artifactId>target-platform-configuration</artifactId>
      <version>${tycho.version}</version>
      <configuration>
        <environments>
          <environment>
            <os>win32</os>
            <ws>win32</ws>
            <arch>x86</arch>
          </environment>
        </environments>
      </configuration>
    </plugin>
  </plugins>
</build>

Linux和macOS的Feature模块同理，只保留对应平台的环境配置即可。

2. 在Repository项目中为Feature添加平台过滤 #

在你的eclipse-repository项目的category.xml（或repository.xml）中，为每个Feature添加平台过滤规则，明确告知Tycho该Feature仅属于特定平台：

<category name="Your Repository Category" label="Platform-Specific Features">
  <feature id="com.yourcompany.feature.win" version="1.0.0.qualifier">
    <filter>(&amp;(osgi.os=win32)(osgi.ws=win32)(osgi.arch=x86))</filter>
  </feature>
  <feature id="com.yourcompany.feature.linux" version="1.0.0.qualifier">
    <filter>(&amp;(osgi.os=linux)(osgi.ws=gtk)(osgi.arch=x86_64))</filter>
  </feature>
  <feature id="com.yourcompany.feature.mac" version="1.0.0.qualifier">
    <filter>(&amp;(osgi.os=macosx)(osgi.ws=cocoa)(osgi.arch=x86_64))</filter>
  </feature>
</category>

3. 调整父Pom的多平台构建配置 #

在父Pom的target-platform-configuration中添加multiPlatform=true，让Tycho为每个环境独立处理依赖解析，避免跨平台冲突：

<plugin>
  <groupId>org.eclipse.tycho</groupId>
  <artifactId>target-platform-configuration</artifactId>
  <version>${tycho.version}</version>
  <configuration>
    <environments>
      <!-- 原有的三个环境配置 -->
    </environments>
    <multiPlatform>true</multiPlatform>
    <resolveAllDependencies>false</resolveAllDependencies>
  </configuration>
</plugin>

resolveAllDependencies=false会让Tycho只解析当前环境下需要的依赖，进一步减少跨平台解析的问题。

4. 验证依赖的可用性 #

最后要确认每个平台Feature依赖的插件，在你父Pom配置的Neon仓库中确实存在对应平台的版本。有些插件可能只提供特定平台的二进制包，这时候需要检查依赖是否正确，或者补充对应的仓库源。

排查细节的技巧 #

如果还是报错，运行构建时添加-X参数查看详细日志，定位具体是哪个依赖在哪个环境下缺失：

mvn clean install -X

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