从代码到用户：DBeaver插件发布全流程实战指南

你是否曾为开源插件的打包发布流程感到困惑？本文将以DBeaver项目为例，详细讲解从代码构建到Eclipse Marketplace上架的完整流程，帮助开发者快速掌握专业级插件发布技术。

1. 环境准备与项目配置

插件开发前需确保Maven和Eclipse PDE（Plug-in Development Environment）已正确配置。DBeaver使用Tycho插件构建系统，核心配置文件位于product/community/pom.xml，其中定义了打包格式、版本号和目标平台信息。

产品定义文件product/community/DBeaver.product是发布的基础，包含以下关键配置：

• 产品元数据（名称、版本、应用入口）
• 启动参数（VM参数、程序参数）
• 依赖特性与插件
• 启动器配置（图标、名称）

2. 插件打包流程

2.1 特性定义与版本管理

DBeaver采用特性（Feature）组织插件，社区版核心特性定义在features/org.jkiss.dbeaver.ce.feature/pom.xml。该文件配置了Maven资源插件，用于生成产品元数据文件：

<resource>
  <directory>root</directory>
  <includes>
    <include>.eclipseproduct</include>
    <include>readme.txt</include>
  </includes>
  <filtering>true</filtering>
</resource>

2.2 构建命令与产物

执行以下Maven命令进行打包：

mvn clean package -f product/community/pom.xml

Tycho插件会根据配置生成多平台分发包，配置见product/community/pom.xml第25-40行：

<formats>
  <win32>zip</win32>
  <linux>tar.gz</linux>
  <macosx>tar.gz</macosx>
  <solaris>tar.gz</solaris>
</formats>

构建产物位于target/products目录，包含各平台的可执行程序和更新站点。

3. 更新站点配置

3.1 分类定义

分类文件product/community/category.xml定义了插件在Eclipse Marketplace中的分类信息：

<category-def name="org.jkiss.dbeaver" label="DBeaver CE">
  <description>Universal Database Manager</description>
</category-def>

所有DBeaver核心特性都归类到org.jkiss.dbeaver分类下，确保用户能在Marketplace中正确发现插件。

3.2 P2仓库生成

DBeaver使用Eclipse P2（Provisioning Platform）管理软件包，product/repositories目录包含各特性仓库配置。执行构建后会生成包含插件元数据的P2仓库，用于Eclipse更新和安装。

4. 发布到Eclipse Marketplace

4.1 准备发布材料

发布前需准备：

• 插件图标（位于product/community/icons）
• 详细的功能描述和更新日志
• 许可证文件（LICENSE.md）

4.2 提交流程

1. 将P2仓库部署到Web服务器
2. 在Eclipse Marketplace开发者门户创建新发布
3. 填写插件元数据，指定P2仓库URL
4. 上传截图和文档
5. 提交审核，通常1-2个工作日完成审核

5. 版本管理与更新策略

DBeaver采用语义化版本控制，版本号定义在product/community/DBeaver.product第5行：

version="24.0.5.qualifier"

其中qualifier会在构建时被替换为时间戳或Git提交ID，确保版本唯一性。更新策略配置在product/community/category.xml中，支持自动更新通知。

6. 常见问题解决

6.1 依赖冲突

Tycho构建时常遇到的依赖问题可通过product/community/pom.xml中的过滤器解决：

<filter>
  <type>eclipse-plugin</type>
  <id>org.apache.ant</id>
  <restrictTo>
    <version>1.10.0</version>
  </restrictTo>
</filter>

6.2 签名验证

Eclipse Marketplace要求插件JAR必须签名，可使用Maven Jarsigner插件配置自动签名流程。

7. 总结与最佳实践

1. 保持清晰的版本号策略，遵循语义化版本规范
2. 使用CI/CD自动化构建流程，确保每次提交可发布
3. 维护详细的更新日志，帮助用户了解变更
4. 定期检查依赖更新，保持与最新Eclipse平台兼容

通过本文介绍的流程，开发者可以系统化地管理DBeaver插件的发布过程。完整的项目结构和配置文件提供了最佳实践参考，帮助开发者避开常见陷阱，高效发布高质量插件。