| Helps manage inter-project references.
Normally you would create an instance of this object and keep it in your
project object in order to support
SubprojectProvider and various
operations that change settings which might refer to build artifacts from
other projects: e.g. when changing the classpath for a Java-based project
you would want to use this helper to scan potential classpath entries for
JARs coming from other projects that you would like to be able to build
as dependencies before your project is built.
You probably only need the higher-level methods such as
ReferenceHelper.addReference and
ReferenceHelper.removeReference(String,String) ; the lower-level methods such as
ReferenceHelper.addRawReference are provided for completeness, but typical client code should not need them.
Only deals with references needed to support build artifacts coming from
foreign projects. If for some reason you wish to store other kinds of
references to foreign projects, you do not need this class; just store
them however you wish, and be sure to create an appropriate
SubprojectProvider .
Modification methods (add, remove) mark the project as modified but do not save it.
author:
Jesse Glick | 