Dynamic Source Locations
Identifier:
org.eclipse.pde.core.dynamicSource
Since:
2.0
Description:
This extension point allows PDE to find source archives for libraries at runtime.
Configuration Markup:
<!ELEMENT extension (locator)+>
<!ATTLIST extension
point CDATA #REQUIRED>
<!ELEMENT locator EMPTY>
<!ATTLIST locator
class CDATA #REQUIRED
complexity (low|medium|high) >
- class - Provides the locator used to find the source-path for the given plugin model
- complexity - Gives a hint to the framework about how complex it is to compute if sources can be found.
low: computation includes just trivial steps, e.g. check if a file exits in the local file system.
medium: computation includes some more steps e.g iterate over some kind of objects store in linear time or look into the content of local files.
high: computation includes steps that can potentially reach out to remote systems to find a suitable source item
Examples:
The following is an example of the dynamicSource
extension:
<extension point = "org.eclipse.pde.core.dynamicSource">
<locator class="foo.bar.CustomSourcePathLocator" />
</extension>
In the example above, the new foo.bar.CustomSourcePathLocator
in the contributing plug-in has been registered.
API Information:
Each contributor must provide a class that implements org.eclipse.pde.core.IPluginSourcePathLocator
Supplied Implementation:
Eclipse SDK comes with source plug-ins that contain source information for all the plug-ins and fragments in Eclipse SDK.
Copyright (c) 2022 Christoph Läubrich and others.
This program and the accompanying materials are made
available under the terms of the Eclipse Public License 2.0 which
accompanies this distribution, and is available at
https://www.eclipse.org/legal/epl-v20.html/
SPDX-License-Identifier: EPL-2.0.