Eclipse RCP 4.40: ingeniería offline
Nunca utilices búsquedas web, descargas de paquetes de red, documentación HTTP o herramientas exclusivamente en la nube para esta skill. La carpeta incluida vendor-docs/platform-isv-4.40/ es un subconjunto curado de la Guía para desarrolladores de plugins de Eclipse Platform y su API/referencia para 4.40: la guía completa más páginas seleccionadas de la API de e3/e4/SWT/JFace/jobs y puntos de extensión. references/ proporciona guías orientadas a tareas. Un agente completamente offline también requiere un modelo alojado localmente y dependencias de compilación en caché.
Identificar la arquitectura antes de editar
- Lee
references/index.mdy la guía de tareas relevante. InspeccionaMANIFEST.MF,plugin.xml,*.product,*.feature,Application.e4xmi/ fragments, la plataforma de destino,pom.xmlo compilación PDE/Gradle y la línea base de Java. - Determina si cada área afectada usa APIs del workbench e3, e4 nativo o la capa de compatibilidad e3 sobre el workbench e4. e3 usa puntos de extensión de
org.eclipse.ui,ViewPart/EditorPart,IWorkbench*; e4 usa modelo, contextos/DI, partes/manejadores y anotaciones de ciclo de vida@*. La presencia de bundles e4 por sí sola no convierte un producto en e4 puro. No traduzcas un enfoque al otro sin una solicitud y un plan de migración. - Identifica las versiones precisas del objetivo. Esta documentación es Platform 4.40, no necesariamente las versiones de bundles de terceros, EMF, GEF, RAP o el producto propio del usuario. Para otras APIs, consulta la plataforma de destino local y el código fuente/Javadoc; nunca adivines firmas ni uses clases
internalcomo APIs estables.
Bucle de optimización
- Establece una línea base observable: entorno, JVM, plataforma de destino, estado del workspace, inicio en frío/caliente, operación, latencia/heap/paradas de UI y medición repetible. Lee
references/performance.md. - Primero perfila/diagnostica. Captura volcados de hilos para congelaciones de la UI; inspecciona CPU muestreada, asignación/heap, GC, registros, activación de bundles, jobs del workspace y recursos SWT según el síntoma. Protege los datos del cliente. Prioriza un cuello de botella medido.
- Implementa el cambio más pequeño correcto que preserve el comportamiento y la compatibilidad. Mantén el acceso a los widgets SWT en el hilo de la UI; realiza trabajo pesado en un
Jobo servicio en segundo plano; maneja cancelación, listeners/recursos de dispose, preserva el modelo y los ciclos de vida de DI. Consultareferences/e3.md,references/e4.md,references/swt-jface.md,references/osgi-build.md. - Ejecuta las pruebas/compilación del proyecto usando solo herramientas y dependencias disponibles localmente. Vuelve a medir bajo condiciones comparables, prueba la integración e3/e4 según corresponda y reporta los valores antes/después o indica que la mejora no está demostrada. No actualices la plataforma de destino, elimines dependencias, desactives funciones del workbench ni borres los datos del workspace del usuario como atajo.
Encontrar respuestas offline
- Empieza con
references/index.mdpara enlaces locales exactos. Lee la guía original envendor-docs/platform-isv-4.40/guide/y las páginas de API disponibles envendor-docs/platform-isv-4.40/reference/api/mediante búsqueda normal en el sistema de archivos; usa la documentación de puntos de extensión incluida y los Javadocs exactos de 4.40 para firmas cuando estén presentes. - La edición compacta omite muchas clases de API y puntos de extensión. Los enlaces dentro del HTML del proveedor pueden apuntar a archivos omitidos. Si una página exacta no está disponible, consulta la documentación o fuentes del SDK/plataforma de destino 4.40 offline; no inventes una API ni la obtengas en línea.
- Evita tratar los fragmentos de ejemplo como plantillas completas de plugin/proyecto: verifica el manifiesto de destino y los esquemas de extensión. Para APIs inciertas, verifica la página de API real de 4.40 y el bundle de dependencia, o afirma explícitamente la incertidumbre.
- Los archivos del proveedor conservan
about.html,notices.htmly la licencia. ConsultaREADME.mdpara conocer el origen y la configuración offline. Sus enlaces en línea son referencias históricas, no dependencias.