Skip to main content

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.

Jump to: navigation, search

Difference between revisions of "Export-Package"

(Add notice about migration to Github)
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
 +
{{Warning|This page has been migrated to https://github.com/eclipse-platform/eclipse.platform/blob/master/docs/Export-Package.md}}
 +
 
The [[Eclipse]] top-level project uses the following convention for the Export-Package manifest attribute:
 
The [[Eclipse]] top-level project uses the following convention for the Export-Package manifest attribute:
  
 
* Newly added internal packages should not use x-internal exports unless there are very good reasons
 
* Newly added internal packages should not use x-internal exports unless there are very good reasons
 
* For existing packages the x-internal export can be removed with PMC approval
 
* For existing packages the x-internal export can be removed with PMC approval
 
+
* Using x-friends is OK and should always be preferred over x-internals. The use of x-friends is an indication of tightly coupled bundles because its use is for when one bundle needs "approved" access to the internals of another bundle.
 +
* The 'Unexported package' Plug-in Manifest compiler option should be set to 'Warning'
 
[[Category:API]]
 
[[Category:API]]

Latest revision as of 08:02, 1 February 2024


The Eclipse top-level project uses the following convention for the Export-Package manifest attribute:

  • Newly added internal packages should not use x-internal exports unless there are very good reasons
  • For existing packages the x-internal export can be removed with PMC approval
  • Using x-friends is OK and should always be preferred over x-internals. The use of x-friends is an indication of tightly coupled bundles because its use is for when one bundle needs "approved" access to the internals of another bundle.
  • The 'Unexported package' Plug-in Manifest compiler option should be set to 'Warning'

Back to the top