Difference between revisions of "Equinox p2 Migration Guide"

From Eclipsepedia

Jump to: navigation, search
m (Before & After)
m (See Also: test cases link)
Line 79: Line 79:
 
* [[Equinox_p2_Getting_Started|Equinox p2 - Getting Started]]
 
* [[Equinox_p2_Getting_Started|Equinox p2 - Getting Started]]
 
* [[Equinox_p2_Getting_Started#Dropins|Equinox p2 - Getting Started with Dropins]]
 
* [[Equinox_p2_Getting_Started#Dropins|Equinox p2 - Getting Started with Dropins]]
 
+
* [[Equinox_p2_tests|Equinox p2 Testcases]]
  
 
[[Category:Equinox_p2]]
 
[[Category:Equinox_p2]]

Revision as of 14:07, 31 March 2008

This is a work in progress, and subject to change.

Before & After

Below is a comparison chart showing how to organize your extensions, plugins & features, using a p2-free Eclipse and a p2-enabled Eclipse (3.4M6+).

Eclipse 3.2 through Eclipse 3.4M5 Eclipse 3.4M6+
 
Eclipse
folder
eclipse/
  plugins/  (plugin folders & jars)
  features/ (feature folders)
eclipse/dropins/somefolder/eclipse/
  plugins/  (plugin folders & jars)
  features/ (feature folders)

- or, simpler -

eclipse/dropins/eclipse/
  plugins/  (plugin folders & jars)
  features/ (feature folders)

Note that the old layout is also still supported, but with the new dropins folder, you have more control and it's easier to clean up unwanted extensions (eg., by deleting the whole somefolder folder).

 
.link
files
eclipse/links/ (*.link files)
eclipse/dropins/ (*.link files)

As before, each .link file contains a path to a folder in which eclipse/features/ and eclipse/plugins/ can be found. For example:

path=/home/nickb/eclipse/phpeclipse

- or -

path=X:/home/nickb/eclipse/ecf

Note that the old layout is also still supported.

 
Extension
folders
.../somefolder/eclipse/
  plugins/  (plugin folders & jars)
  features/ (feature folders)
  .eclipseextension

These folders, including the .eclipseextension file, are created when doing an Update Manager install to a folder other than the base eclipse/ directory.

If you want to create the .eclipseextension file by hand, here's how. You can also just open the .eclipseproduct file from the root of your Eclipse install with Eclipse's File > Open File... then do a File > Save As... to rename it.

To import a pre-existing folder, use Help > Software Updates > Manage Configuration > Add an Extension Location.

.../somefolder/eclipse/
  plugins/  (plugin folders & jars)
  features/ (feature folders)

The old format is still supported, though the .eclipseextension file is no longer required.

As such, you can now just unpack a zip and point Eclipse at it. Or, even easier, point Eclipse at the zip and it'll handle the unzip for you.

To import such a folder, use Help > Software Updates... > Available Features > Manage sites... > Add... > Local... (or Archive..., for an unpacked zip.)

See Also