请求协助：添加uk.co.spudsoft.birt.emitters.excel源码并解决EmitterID无效问题

问题翻译 #

我希望将uk.co.spudsoft.birt.emitters.excel的代码加入项目并定制修改，目前该发射器可正常实现Excel转换，但需对其功能扩展。请问如何为该库关联源码，修改后让项目加载修改后的源码而非原文件？另外，我尝试从已有spudsoft jar文件新建插件时，遇到错误：EmitterID com.asol.birt.excel.XlsxEmitter for render option is invalid。

1. 关联源码并让项目优先加载修改后的代码 #

• 拉取/导出对应版本的源码：
  从该库的代码仓库拉取与当前使用jar包版本一致的源码；若没有公开仓库，用反编译工具（如JD-GUI）导出jar内源码并整理成可编译的项目结构，确保包路径uk.co.spudsoft.birt.emitters.excel完全匹配。
• 将源码引入项目：
  在你的项目中新增模块或源码目录，放入整理后的源码，保持包结构不变。
• 调整依赖优先级：
  • Maven：将原spudsoft jar依赖设为<scope>provided</scope>，避免打包原jar，优先使用本地编译的类。
  • Gradle：将原依赖设为compileOnly，效果同上。
  • 普通Java项目：在IDE依赖顺序中，把本地源码目录移至原jar包之前，确保类加载优先级更高。
• 编译验证：修改源码后重新编译项目，运行时会自动加载本地修改后的类。

2. 解决EmitterID无效错误 #

这个错误是因为指定的EmitterID与spudsoft发射器实际注册的ID不匹配，处理步骤：

• 确认正确的EmitterID：
  打开spudsoft jar包，查看plugin.xml（OSGi插件）或发射器类的注册逻辑，该库正确的Excel发射器ID为uk.co.spudsoft.birt.emitters.excel.XlsxEmitter，而非com.asol.birt.excel.XlsxEmitter。
• 修正配置：
  在插件的配置文件（如plugin.xml）或渲染选项的代码中，将EmitterID替换为上述正确值。
• 检查依赖：
  确保插件项目已正确依赖spudsoft库或集成了修改后的源码，避免因类缺失导致ID验证失败。

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