iDempiere OSGi插件架构拆解40模块如何解耦并支撑二次开发生态【免费下载链接】idempiereiDempiere. Community Powered Enterprise. Full Open Source Business Suite ERP/CRM/MFG/SCM/POS项目地址: https://gitcode.com/gh_mirrors/id/idempiereiDempiere 是一款社区驱动的开源企业资源计划ERP套件覆盖 ERP、CRM、SCM、POS 等完整业务场景。它的核心工程能力之一正是基于OSGi 插件架构的模块化设计整个系统被拆分为 40 多个独立的 Bundle 模块各自声明依赖、独立打包、按需安装这也是 iDempiere 能够支撑庞大二次开发生态的根基。本文带你快速看懂这套 OSGi 插件架构是如何解耦的以及新手如何在此基础上开发自己的插件。一、40 模块全景先看目录就能懂架构打开仓库根目录每个一级目录基本就是一个 OSGi Bundle插件包。根pom.xml中注册了全部模块按职责可以划分为 6 大类模块分类代表目录作用 核心引擎org.adempiere.base、org.adempiere.base.callout、org.adempiere.base.process模型、事件、Callout 与后台 Process 框架 Web 前端org.adempiere.ui.zk、org.idempiere.zk.datatable、org.idempiere.zk.billboardZK 框架的 Web 界面、数据表、仪表盘 数据库适配org.compiere.db.postgresql.provider、org.compiere.db.oracle.providerPostgreSQL / Oracle 双库支持可插拔 报表org.adempiere.report.jasper、org.adempiere.report.jasper.libraryJasper 报表引擎与模板库⚙️ 基础设施org.idempiere.hazelcast.service、org.idempiere.redis.service集群缓存、分布式会话 插件生态org.idempiere.extension.manager、org.idempiere.p2、org.adempiere.replication扩展管理器、p2 打包仓库、数据复制这种一个目录 一个插件的布局让新手不用读代码也能快速定位功能归属——找 Web 界面去org.adempiere.ui.zk/找数据库逻辑去org.compiere.db.*。二、解耦三板斧Manifest、声明式服务、p2 打包1️⃣ Manifest 文件每个模块的合同每个模块都有META-INF/MANIFEST.MF它定义了插件的边界。以核心模块org.adempiere.base/META-INF/MANIFEST.MF为例其中有三类关键声明Export-Package对外公开的包。如org.compiere.model、org.adempiere.util等这是其他插件能看得见的 APIImport-Package/Require-Bundle依赖声明且带版本号约束例如org.osgi.service.cm;version1.6.1。依赖不满足时 OSGi 容器会直接拒绝启动从源头避免依赖地狱Bundle-Activator插件启动入口如org.adempiere.base.BaseActivator配合Bundle-ActivationPolicy: lazy实现懒加载。 一句话理解模块之间不直接引用 jar 包而是通过 Manifest 声明我提供什么、我需要什么这就是 OSGi 解耦的核心。2️⃣ OSGI-INF 目录声明式服务零代码接线模块内的OSGI-INF/目录存放 SCRDeclarative ServicesXML 描述文件用配置代替代码完成服务注册与绑定。比如事件管理器org.adempiere.base/OSGI-INF/eventmanager.xml只有短短几行实现类org.adempiere.base.event.EventManager绑定 OSGi 的EventAdmin服务对外发布IEventManager服务接口。全仓库有上百个这类 XML 描述符org.adempiere.base/OSGI-INF/下就有 60 个它们就是各模块之间松耦合通信的插座——邮件机制、税务提供者、支付处理器等能力全部通过这种服务接口暴露外部插件可自由替换实现。3️⃣ feature p2从 Bundle 到可安装的分发单元单个 Bundle 对用户来说太细碎了iDempiere 用两层打包机制解决feature.xml每个*-feature/目录如org.adempiere.base-feature/feature.xml把一组 Bundle 组合成一个逻辑功能包p2 仓库org.idempiere.p2/category.xml将所有 feature 注册到 p2 软件仓库形成应用商店式的安装/升级体系——这正是 Eclipse 平台同款机制支持增量更新与依赖自动解析。三、二次开发生态的入口Extension Manager真正让插件生态落地的是org.idempiere.extension.manager/模块。它的 READMEorg.idempiere.extension.manager/README.md概括了五大能力集中注册表数据库新增AD_Extension、AD_ExtensionEntity表追踪所有已安装插件及版本依赖校验安装前自动检查 REST API、核心模块等前置依赖生命周期控制支持动态启动、停止、刷新插件 Bundle无需重启服务器元数据驱动解析插件附带的metadata.json与info.md为管理员提供丰富的管理界面安全下载从远程仓库拉取制品并校验 checksum。以数据复制插件为例其元数据文件org.adempiere.replication/metadata.json声明了插件 ID、适用版本、分类标签Core/Data Management/Integration和所包含的两个 Bundle。管理员在Extension Management窗口即可一键搜索、安装、升级插件整个体验类似浏览器装扩展。四、新手上手3 步基于 iDempiere 做二次开发第 1 步获取源码git clone https://gitcode.com/gh_mirrors/id/idempiere第 2 步理解构建根pom.xml提供了多套 Maven Profile默认 profile 构建全部模块也可用-P common,core或-P common,extended按核心层 / 扩展层组合构建模块清单见根pom.xml中的 profile 定义。执行mvn clean package即可产出 p2 仓库。第 3 步写你的第一个插件参照org.adempiere.plugin.utils/这个轻量工具模块新建插件时只需要一份META-INF/MANIFEST.MF声明Export-Package和Require-Bundle依赖org.adempiere.base一个OSGI-INF/*.xml声明你的服务组件一份metadata.json供 Extension Manager 识别可参考org.adempiere.replication/metadata.json。调试时可借助内置的org.idempiere.felix.webconsole/Felix Web 控制台在浏览器中实时查看 Bundle 状态与服务列表配合org.idempiere.test/模块中的单元测试骨架做回归验证。五、新手常见问题 FAQQ1不懂 OSGi 也能开发插件吗可以。90% 的场景只需照抄 Manifest 模板和 OSGI-INF XML 写法具体规则可对照org.adempiere.base/META-INF/MANIFEST.MF修改。Q2插件装错了会影响整个系统吗影响可控。OSGi 的包级隔离 Extension Manager 的依赖预检让插件故障通常只局限于自身 Bundle可单独停用而不拖垮核心。Q3想给不同客户裁剪功能怎么办利用 Maven Profilecommon/core/extended 组合在构建期裁剪或部署后通过 Extension Manager 在运行期启停插件两种粒度任选。六、总结iDempiere 的 OSGi 插件架构可以浓缩为一句话Manifest 定边界XML 做接线p2 管分发Extension Manager 管生命周期。40 模块各司其职又彼此独立既保证了企业级 ERP 系统的稳定可扩展也为社区留下了低门槛的二次开发入口。对新手而言读懂pom.xml的模块清单和核心 Manifest就已经掌握了这套架构的 80%。【免费下载链接】idempiereiDempiere. Community Powered Enterprise. Full Open Source Business Suite ERP/CRM/MFG/SCM/POS项目地址: https://gitcode.com/gh_mirrors/id/idempiere创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考