# 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.