Esse guia cobre os plug-ins do Eclipse 2.1 (ou anterior) ao Eclipse 3.0.
Um dos objetivos do Eclipse 3.0 era mover o Eclipse para frente enquanto permanece compatível com as versões anteriores o maior tempo possível. Ou seja, os plug-ins gravados nas APIs do Eclipse 2.1 devem continuar funcionando no 3.0 em vez das alterações da API.
Os tipos principais de compatibilidade são compatibilidade de contrato de API e compatibilidade binária. A compatibilidade de contrato da API significa que a utilização válida das APIs 2.1 permanece válida para o 3.0, então não há necessidade de rever o código de funcionamento. A compatibilidade binária significa que as assinaturas do método API, etc. não foram alteradas de formas que fariam com que o código ("binário") compilado para não vincular mais e executar com as novas bibliotecas 3.0.
Apesar de todo o esforço feito para evitar a quebra, há algumas áreas de incompatibilidade. Esse documento descreve onde o Eclipse foi alterado de formas incompatíveis entre 2.1 e 3.0 e fornece instruções para migrar plug-ins 2.1 a 3.0.