Guide de migration des plug-ins vers Eclipse 3.0

Le présent guide décrit le processus de migration des plug-ins d'Eclipse 2.1 (ou version antérieure) vers Eclipse 3.0.

L'un des objectifs de la version 3.0 consiste à améliorer Eclipse en conservant sa compatibilité avec les versions précédentes autant que possible. En d'autres termes, les plug-ins développés avec les API d'Eclipse 2.1 devraient continuer à fonctionner dans la version 3.0 malgré les modifications apportées aux API.

Il existe deux types de clé pour la compatibilité : la compatibilité des contrats d'API et la compatibilité binaire. La compatibilité des contrats d'API signifie que l'utilisation valide de API de la version 2.1 est toujours possible dans la version 3.0 ; par conséquent, il n'est pas nécessaire de modifier le code. La compatibilité binaire signifie que les signatures des méthodes d'API, etc, n'ont pas été modifiées radicalement de sorte que le code compilé ("binaire") existant peut encore établir un lien et s'exécuter avec les nouvelles bibliothèques de la version 3.0.

Toutefois, malgré tous les efforts pour éviter des défaillances, il subsiste certains domaines d'incompatibilité. Le présent document décrit les zones pour lesquelles les modifications apportées à Eclipse rendent incompatibles la version 2.1 et la version 3.0, et fournit des instructions relatives à la migration des plug-ins de la version 2.1 vers la version 3.0.