Eclipse RCP 4.40:離線工程
對於此技能,請勿使用網路搜尋、網路套件下載、HTTP 文件或僅限雲端的工具。提供的 vendor-docs/platform-isv-4.40/ 是 Eclipse 平台外掛開發者指南及 4.40 API/參考的精選子集:完整指南加上精選的 e3/e4/SWT/JFace/Job API 頁面與擴充點。references/ 提供任務導向的指引。一個完全離線的代理還需要一個本地託管的模型與快取的建置相依套件。
在編輯前識別架構
- 閱讀
references/index.md及相關任務指南。檢查MANIFEST.MF、plugin.xml、*.product、*.feature、Application.e4xmi/ 程式片段、目標平台、pom.xml或 PDE/Gradle 建置及 Java 基準。 - 判斷每個受影響區域使用的是 e3 工作台 APIs、原生 e4,還是 e3 相容層位於 e4 工作台上。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 凍結擷取執行緒 dump;根據症狀取樣 CPU、分配/堆積、GC、日誌、套件啟用、工作區 Job 及 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 或從線上獲取。
- 避免將範例片段視為完整的外掛/專案範本:請檢查目標的 manifest 與擴充點 schema。對於不確定的 API,請驗證實際的 4.40 API 頁面與相依套件,或明確說明不確定性。
- 供應商檔案保留
about.html、notices.html及授權。請參閱README.md了解出處與離線設定。其中的線上連結僅為歷史參考,並非相依項目。