Eclipse RCP 4.40: engenharia offline
Nunca use pesquisa web, downloads de pacotes de rede, documentação HTTP ou ferramentas exclusivas de nuvem para esta skill. O diretório vendor-docs/platform-isv-4.40/ é um subconjunto curado do Guia do Desenvolvedor de Plug-ins da Plataforma Eclipse e da API/referência para a versão 4.40: o guia completo mais páginas selecionadas de API e pontos de extensão de e3/e4/SWT/JFace/jobs. O diretório references/ fornece orientação baseada em tarefas. Um agente totalmente offline também requer um modelo hospedado localmente e dependências de build em cache.
Identificar a arquitetura antes de editar
- Leia
references/index.mde o guia de tarefas relevante. InspecioneMANIFEST.MF,plugin.xml,*.product,*.feature,Application.e4xmi/ fragments, plataforma alvo,pom.xmlou build PDE/Gradle e baseline Java. - Determine se cada área afetada usa APIs do workbench e3, e4 nativo ou compatibilidade e3 no workbench e4. e3 usa pontos de extensão
org.eclipse.ui,ViewPart/EditorPart,IWorkbench*; e4 usa modelo, contextos/DI, parts/handlers e annotations de ciclo de vida@*. A presença de bundles e4 por si só não torna um produto e4 puro. Não traduza uma abordagem para a outra sem uma solicitação e plano de migração. - Identifique as versões precisas do alvo. Esta documentação é Platform 4.40, não necessariamente versões de bundles de terceiros, EMF, GEF, RAP ou do produto do usuário. Para outras APIs, consulte a plataforma alvo local e source/Javadoc; nunca adivinhe assinaturas ou use classes
internalcomo APIs estáveis.
Ciclo de otimização
- Estabeleça uma linha de base observável: ambiente, JVM, plataforma alvo, estado do workspace, inicialização a frio/quente, operação, latência/heap/travamentos da UI e medição repetível. Leia
references/performance.md. - Primeiro, perfile/diagnostique. Capture dumps de thread para congelamentos da UI; inspecione CPU amostrada, alocação/heap, GC, logs, ativação de bundles, jobs do workspace e recursos SWT dependendo do sintoma. Proteja os dados do cliente. Priorize um gargalo medido.
- Implemente a menor mudança correta preservando comportamento e compatibilidade. Mantenha o acesso a widgets SWT na thread da UI; faça trabalho pesado em uma
Task(Job) ou serviço em segundo plano; trate cancelamento, listeners/recursos de dispose, preserve modelo e ciclos de vida de DI. Consultereferences/e3.md,references/e4.md,references/swt-jface.md,references/osgi-build.md. - Execute os testes/build do projeto usando apenas ferramentas/dependências disponíveis localmente. Re-meça sob condições comparáveis, teste a integração e3/e4 conforme aplicável e relate valores antes/depois ou diga que a melhoria não foi comprovada. Não atualize a plataforma alvo, remova dependências, desabilite funcionalidades do workbench ou limpe os dados do workspace do usuário como atalho.
Encontrando respostas offline
- Comece por
references/index.mdpara links locais exatos. Leia o guia original emvendor-docs/platform-isv-4.40/guide/e as páginas de API disponíveis emvendor-docs/platform-isv-4.40/reference/api/com pesquisa normal do sistema de arquivos; use a documentação de pontos de extensão incluída e os Javadocs exatos da versão 4.40 para assinaturas quando presentes. - A edição compacta omite muitas classes de API e pontos de extensão. Links dentro do HTML do fornecedor podem apontar para arquivos omitidos. Se uma página exata estiver ausente, consulte a documentação ou fontes do SDK/plataforma alvo offline da versão 4.40; não invente uma API nem a busque online.
- Evite tratar exemplos de snippet como modelos completos de plugin/projeto: verifique o manifesto alvo e os esquemas de extensão. Para APIs incertas, verifique a página real da API 4.40 e o bundle de dependência, ou declare explicitamente a incerteza.
- Os arquivos do fornecedor mantêm
about.html,notices.htmle licença. VejaREADME.mdpara proveniência e configuração offline. Seus links online são referências históricas, não dependências.