从零开发Eclipse插件全指南：OSGi解析与常见问题排查

一、从零开始开发Eclipse插件的学习资源 #

• Eclipse官方PDE入门教程：直接在Eclipse的Help菜单中搜索“Plug-in Development Guide”，里面包含从项目创建到高级功能的完整步骤，是最权威的入门资料。
• 实战书籍：《Eclipse插件开发实战》《Eclipse Rich Client Platform》，前者偏向国内开发者的实用场景，后者讲解RCP插件的核心原理。
• 技术博客系列：搜索“Eclipse插件开发入门”，有不少开发者分享的分步教程，涵盖视图开发、菜单扩展、对话框设计等基础功能。

二、OSGi Bundle相关问题解答 #

• 什么是OSGi Bundle：OSGi Bundle是一种模块化的Java组件格式，包含编译后的类文件、资源文件，以及描述组件依赖、版本、导出/导入包的MANIFEST.MF文件，核心作用是实现代码的模块化隔离、动态加载与版本管理。
• Eclipse插件默认是否包含OSGi Bundle：是的，Eclipse插件本身就是OSGi Bundle。创建插件项目时，PDE（Plug-in Development Environment）会自动生成MANIFEST.MF、build.properties等OSGi必备文件。
• 开发Eclipse插件是否必须使用OSGi Bundle：必须。Eclipse平台完全基于OSGi框架构建，只有符合OSGi规范的组件才能被平台识别、加载和管理，这是插件能在Eclipse中运行的前提。
• 如何下载并集成OSGi Bundle：无需单独下载，创建Eclipse插件项目时，PDE会自动配置OSGi环境。开发中只需在MANIFEST.MF中管理依赖（导入其他Bundle的包）、配置导出包、设置Bundle信息即可。

三、你遇到的具体问题解决方案 #

1. Java版本切换后的警告 #

• WARNING: Using incubator modules: jdk.incubator.vector：这个警告是因为你使用的某些库依赖了Java 21的孵化器模块，不影响插件功能。如果要消除，可在运行配置的VM参数中添加--add-modules=jdk.incubator.vector，或者忽略即可。
• SLF4J警告：OSGi环境下，普通的类路径配置无法让SLF4J找到提供者。正确做法：
  • 将slf4j-simple.jar放到插件项目的lib目录下；
  • 打开MANIFEST.MF的Runtime选项卡，将lib/slf4j-simple.jar添加到Classpath列表；
  • 修改build.properties，把lib/slf4j-simple.jar加入bin.includes中，确保构建时被包含。

2. build.properties的缺失错误 #

提示'source.lib/httpclient-5.4.1.jar' build entry is missing的原因是路径配置与实际文件位置不匹配：

• 先确认httpclient、httpcore的jar包实际存放路径，比如是否在项目根目录的lib文件夹，而非source.lib；
• 打开build.properties，将错误的路径修改为实际路径（比如lib/httpclient-5.4.1.jar）；
• 确保这些jar包被加入bin.includes列表，格式类似：

  bin.includes = META-INF/,\
                 .,\
                 lib/httpclient-5.4.1.jar,\
                 lib/httpcore-5.3.1.jar
  

补充：OSGi环境下引入第三方Jar的最佳实践 #

直接把Jar放到类路径容易出问题，推荐两种方式：

• 将第三方Jar转换为OSGi Bundle：右键点击Jar文件，选择Plug-in Tools > Convert to Plug-in Project，生成独立的Bundle插件，然后在你的插件项目中添加对它的依赖；
• 使用Embed-Dependency：在MANIFEST.MF的Bundle-ClassPath中指定Jar路径，同时添加Embed-Dependency: *（需使用BND工具，Eclipse PDE默认集成），让插件在构建时自动处理Jar的嵌入。

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