Deployment of a custom plug-in using Link folders fails
One of the methods to extend an Eclipse platform consists of creating a folder called links, containing files with extension .link that point to a an Eclipse extension location. In version 7 of the IBM Software Development Platform (SDP), this extension method no longer works.
To reproduce the issue, you would perform steps similar to the following:
1. Start IBM Rational® Software Architect (RSA) and load a workspace containing the plug-in project that you have already developed, or develop a new plug-in (you could start with File->New->Project->Plug-in Development->Plug-in project and select one of the existing plug-in templates, such as the "Hello World" template).
2. Once you have a working plug-in project in your workspace, export it as a deployable plug-in with the command:
File->Export->Plug-in Development->Deployable plug-ins and Fragments
Save it in a separate folder with a name like:
Note that there should be a subfolder called "eclipse", inside your favourite extensions folder.
The plug-in jar file will be placed in:
(the "plugins" subfolder will be created automatically).
3. Create a new Feature project:
File->New->Project->Plug-in Development->Feature Project
In the dialog page called: Referenced Plug-ins and Fragments
choose the identifier of the plug-in just exported (which should still be in your workspace).
4. Export the Feature project as deployable feature with the menu:
File->Export->Plug-in Development->Deployable Feature
Choose the identifier of the feature just created.
Save the feature in the folder:
This will automatically create a sub-folder
containing another folder, called like the feature, with a version number at the end:
and with a file called feature.xml inside.
Make a note of the name: MyFeature
(extension's feature directory without the version suffix) because it is needed to create the .link folder later on.
5. Create the folder called "links" inside the RSA installation directory (the one that contains eclipse.exe)
resulting in the folllowing folder in a dafault Windows installation:
6. Create a file with extension ".link" . The link file must have the same name as the extension's feature directory without the version suffix, so in this case:
with the content::
in the above "links" folder.
Note that the path does not contain the "eclipse" subfolder.
Note how on Windows you are still required to use "/" instead of "\"
7. Start RSA on a new workspace
The new feature is not visible, because the Installation Manager sets the transient flag in the platform.xml file. This flag ensures that Eclipse ignores link files.
(The reason for setting this flag is to circumvent the Eclipse defect 166852, see the Related URL section for more information).
Resolving the problem
There are various alternative approaches:
1. Use the Eclipse standalone update commands (addSite and removeSite) to add an extension directory. (See the Installation Manager 126.96.36.199 readme file and reference therein)
2. Use Add extension option in Help->Software Updates->Manage configuration
(See the DeveloperWorks article "Manage your Eclipse Environment")
3. Put plugins/feature into the <installdir>/feature and <installdir>/plugins directory; then, launch Eclipse once with the -clean command line argument.
Please note that the above <installdir> should refer to the installation of the specific product, which is by default located in:
and not to the common repository, which is by default located in:
|Software Development||Rational Software Modeler||Extensibility||Windows, Linux||7.0, 188.8.131.52|
|Software Development||Rational Systems Developer||Extensibility||Linux, Windows||7.0, 184.108.40.206|
|Software Development||Rational Application Developer for WebSphere Software||Eclipse||Windows, Linux||7.0, 220.127.116.11|
|Software Development||Rational Data and Application Modeling Bundle||Linux, Windows||7.0|
|Data & Information Management||Rational Data Architect||Extensibility||Linux, Windows||7.0, 18.104.22.168|
More support for:
Rational Software Architect
Software version: 7.0, 22.214.171.124
Operating system(s): Linux, Windows
Reference #: 1255611
Modified date: 28 February 2007
Translate this page: