Jump to: navigation, search

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&#148
 
EclipseCon 2004 technical track presentation, “Eclipse APIs: Lines in the Sand&#148
 
(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&#148 (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.