Eclipse changed in incompatible ways between 3.7 and 4.2 in ways that affect plug-ins. The following entries describe the areas that changed and provide instructions for migrating 3.7 plug-ins to 4.2. Note that you only need to look here if you are experiencing problems running your 3.7 plug-in on 4.2.
What is affected: Clients that call the following methods for storing and retrieving passwords in the platform keyring file:
Description: These APIs were deprecated and superseded by new API in the org.eclipse.equinox.security.storage package in Eclipse 3.4. These APIs made use of a custom encryption algorithm that caused problems for organizations distributing and exporting Eclipse-based products. The system was also inherently flawed due to relying on a password supplied on the command line that users never set. In Eclipse 4.2 this problematic implementation has been removed. The API remains in place and will log an exception when used.
Action required: Clients that call these methods should instead use the corresponding Equinox security APIs for storing authentication information instead. Refer to the deprecation comment on each method for precise migration instructions.
What is affected:Bundles built for Eclipse 1.0 to 2.1 that have not been compiled in Eclipse 3.0 or later. Also, any bundle or feature that requires or includes a removed bundle.
Description: The following bundles provided implementation of compatibility mechanisms to support bundles compiled against Eclipse prior to version 3.0. These bundles have not contained any API since the 3.0 release, and no API is changed or removed as a consequence of these bundles being removed.
Action required: Clients with a bundle or feature including or requiring any of these bundles should remove the requirement.
What is affected:Any bundle or feature that requires or includes the bundle org.eclipse.help.appserver.
Description: This bundle provided implementation of a Tomcat-based web server application for the Eclipse help system. This was replaced in Eclipse 3.3 with a Jetty-based application server. This bundle defines no API and has been unused in the Eclipse platform for many releases.
Action required: Clients with a bundle or feature including or requiring the bundle org.eclipse.help.appserver should remove the requirement.
What is affected: Clients that rely on the provisional API or implementation found in the following bundles:
Description: These provisional APIs were deprecated and superseded by new API provided by Equinox p2 in Eclipse 3.4. These bundles have been removed from the Eclipse SDK in 4.2, but remain available and fully compatible with 4.2 should any application or product require them.
Action required: Clients that rely on the provisional API or implementation in these bundles should migrate to the functionality and API provided by Equinox p2. Alternatively, products can install these bundles from the Eclipse 3.8 repository and they will continue to function in Eclipse 4.2-based applications.