Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "FAQ How do I prevent my plug-in from being broken when I update Eclipse?"
| Line 1: | Line 1: | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
Eclipse makes a careful distinction between published APIs and | Eclipse makes a careful distinction between published APIs and | ||
internal implementation details. The APIs are designed to | internal implementation details. The APIs are designed to | ||
| Line 37: | Line 31: | ||
EclipseCon 2004 technical track presentation, “Eclipse APIs: Lines in the Sand” | EclipseCon 2004 technical track presentation, “Eclipse APIs: Lines in the Sand” | ||
(http://www.eclipsecon.org). | (http://www.eclipsecon.org). | ||
| + | |||
| + | <hr><font size=-2>This FAQ was originally published in [http://www.eclipsefaq.org Official Eclipse 3.0 FAQs]. Copyright 2004, Pearson Education, Inc. All rights reserved. This text is made available here under the terms of the [http://www.eclipse.org/legal/epl-v10.html Eclipse Public License v1.0].</font> | ||
Revision as of 16:09, 14 March 2006
Eclipse makes a careful distinction between published APIs and internal implementation details. The APIs are designed to reduce coupling between plug-ins to a small, stable interface. This insulates clients of the interface from being affected by implementation changes, and it allows the plug-in that publishes the interface to continue to innovate and grow without breaking existing clients. If your plug-in uses only published API and carefully follows the API contracts defined in the API javadoc, your plug-in should continue to work after migrating to a new Eclipse release.
In the Eclipse Platform, the API of a plug-in includes all public classes and interfaces
that do not have the word internal in their package names
and all public and protected methods in those classes and interfaces. The API
also includes all extension points that are not explicitly described as for internal
use only in their documentation; there is only a small handful of
such internal extension points.
See Also:
Eclipse online article “How to Use the Eclipse API”
EclipseCon 2004 technical track presentation, “Eclipse APIs: Lines in the Sand”
(http://www.eclipsecon.org).
This FAQ was originally published in Official Eclipse 3.0 FAQs. Copyright 2004, Pearson Education, Inc. All rights reserved. This text is made available here under the terms of the Eclipse Public License v1.0.