Eclipse RCP 4.40:离线工程
本技能不得使用网络搜索、网络包下载、HTTP 文档或仅云端工具。 附带的 vendor-docs/platform-isv-4.40/ 是 精选子集,包含 Eclipse 平台插件开发者指南及 4.40 的 API/参考:完整指南以及精选的 e3/e4/SWT/JFace/jobs API 页面和扩展点。references/ 提供面向任务的指导。若要完全离线工作,代理 还需本地托管的模型和缓存构建依赖。
编辑前先识别架构
- 阅读
references/index.md及相关任务指南。检查MANIFEST.MF、plugin.xml、*.product、*.feature、Application.e4xmi/片段、目标平台、pom.xml或 PDE/Gradle 构建以及 Java 基线。 - 判断每个受影响区域使用的是 e3 工作台 API、原生 e4 还是 e4 工作台上的 e3 兼容层。e3 使用
org.eclipse.ui扩展点、ViewPart/EditorPart、IWorkbench*;e4 使用模型、上下文/DI、部件/处理器和@*生命周期注解。仅凭 e4 捆绑包的存在 不代表 产品是纯 e4。未经请求和迁移计划,不得将一种方法翻译为另一种。 - 确定目标的精确版本。本文档针对 Platform 4.40,不一定是第三方捆绑包、EMF、GEF、RAP 或用户自己产品的版本。对于其他 API,请检查本地目标平台和源代码/Javadoc;切勿猜测签名或将
internal类当作稳定 API。
优化循环
- 建立可观察的基线:环境、JVM、目标平台、工作空间状态、冷/热启动、操作、延迟/堆/UI 卡顿以及可重复的测量。阅读
references/performance.md。 - 首先进行概要分析/诊断。对于 UI 冻结,捕获线程转储;根据症状,检查采样 CPU、分配/堆、GC、日志、捆绑包激活、工作空间任务和 SWT 资源。保护客户数据。优先处理已测量的瓶颈。
- 实现 最小 的正确更改,保持行为和兼容性。保持 SWT 控件访问在 UI 线程上;在
Job或后台服务中执行繁重工作;处理取消、dispose 监听器/资源、维护模型和 DI 生命周期。参见references/e3.md、references/e4.md、references/swt-jface.md、references/osgi-build.md。 - 仅使用本地可用的工具/依赖项运行项目测试/构建。在可比条件下重新测量,酌情测试 e3/e4 集成,并报告前后值,或说明未证明有改进。不得将升级目标平台、删除依赖关系、禁用工作台功能或清除用户工作空间数据作为捷径。
离线查找答案
- 从
references/index.md开始,获取确切的本地链接。在vendor-docs/platform-isv-4.40/guide/下阅读原始指南,并在vendor-docs/platform-isv-4.40/reference/api/下查看可用的 API 页面,使用常规文件系统搜索;使用包含的扩展点文档和精确的 4.40 Javadoc 获取签名(如存在)。 - 精简版省略了许多 API 类和扩展点。供应商 HTML 内的链接可能指向已省略的文件。如果在离线环境中未找到确切的页面,请查阅 4.40 SDK/目标平台的文档或源代码;不要凭空创建 API 或在线获取。
- 避免将示例代码视为完整的插件/项目模板:检查目标清单和扩展模式。对于不确定的 API,请验证实际的 4.40 API 页面和依赖捆绑包,或明确说明不确定性。
- 供应商文件保留了
about.html、notices.html和许可协议。参见README.md了解来源和离线设置。其中的在线链接仅为历史参考,非依赖项。