feature.xml */
+ public final static String FEATURE_FILENAME_DESCRIPTOR = "feature.xml"; //$NON-NLS-1$
+
+ /** Constant for the string fragment.xml */
+ public final static String FRAGMENT_FILENAME_DESCRIPTOR = "fragment.xml"; //$NON-NLS-1$
+
+ /** Constant for the string plugin.xml */
+ public final static String PLUGIN_FILENAME_DESCRIPTOR = "plugin.xml"; //$NON-NLS-1$
+
+ /** Constant for the string META-INF/MANIFEST.MF */
+ public final static String BUNDLE_FILENAME_DESCRIPTOR = "META-INF/MANIFEST.MF"; //$NON-NLS-1$
+
+ /**
+ * Key used to store the value of a project reference in the Eclipse-SourceReferences manifest header.
+ *
+ * @since 3.6
+ * @see IFetchFactory
+ */
+ public static final String KEY_SOURCE_REFERENCES = "sourceReferences"; //$NON-NLS-1$
+
+}
diff --git a/tycho-its/projects/api-tools/embedded-jars/org.eclipse.pde.build/src/org/eclipse/pde/build/IAntScript.java b/tycho-its/projects/api-tools/embedded-jars/org.eclipse.pde.build/src/org/eclipse/pde/build/IAntScript.java
new file mode 100644
index 0000000000..9f92f5a12c
--- /dev/null
+++ b/tycho-its/projects/api-tools/embedded-jars/org.eclipse.pde.build/src/org/eclipse/pde/build/IAntScript.java
@@ -0,0 +1,155 @@
+/*******************************************************************************
+ * Copyright (c) 2006, 2019 IBM Corporation 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-2.0/
+ *
+ * SPDX-License-Identifier: EPL-2.0
+ *
+ * Contributors:
+ * IBM Corporation - Initial API and implementation
+ *******************************************************************************/
+package org.eclipse.pde.build;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Interface providing helper methods to produce Ant scripts.
+ * + * It contains convenience methods for creating the XML elements + * required for Ant scripts. See the Ant + * website for more details on Ant scripts and the particular Ant tasks. + *
+ * @noimplement This interface is not intended to be implemented by clients. + */ +public interface IAntScript { + + /** + * Print the given string to the Ant script. + * + * @param string the string to print. + */ + public void print(String string); + + /** + * Print the given comment to the Ant script folled by a carriage-return. + * + * @param comment the comment to print. + */ + public void printComment(String comment); + + /** + * Print the given string followed by a carriage-return. + * + * @param string the string to print. + */ + public void println(String string); + + /** + * Print a empty line. + */ + public void println(); + + /** + * Print an ant call task as defined by AntCall}. + * @param target the target executed by the call. This value can not benull.
+ * @param inheritAll If true, pass all properties to the new Ant project.
+ * @param params Specifies as key / value pairs, the properties to set before running the specified target. This value can be null
+ */
+ public void printAntCallTask(String target, boolean inheritAll, Mapname=value.
+ * @param name the name of the attribute to print. This value can not be null.
+ * @param value the name of the value to print. This value can be null.
+ * @param mandatory indicate whether or not the value is mandatory.
+ * If the value is null and the attribute is mandatory, the printed value will be "".
+ */
+ public void printAttribute(String name, String value, boolean mandatory);
+
+ /**
+ * Print tagName as an xml begin tag (<tagName>).
+ * @param tagName the tag to print.
+ */
+ public void printStartTag(String tagName);
+
+ /**
+ * Print tagName as an xml begin tag with attributes (<tagName [attributes...] >).
+ * @param tag the tag to print.
+ * @param attributes attributes for the tag.
+ * @since 3.6
+ */
+ public void printStartTag(String tag, Map</tagName>).
+ * @param endTag the tag to print.
+ */
+ public void printEndTag(String endTag);
+
+ /**
+ * Print an xml element with attributes (<tagName [attributes...] />).
+ * @param tag the tag to print
+ * @param attributes the attributes for the tag
+ * @since 3.6
+ */
+ public void printElement(String tag, Mapnull.
+ * @param depends a comma-separated list of names of targets on which this target depends. This value can be null.
+ * @param ifClause the name of the property that must be set in order for this target to execute. This value can be null
+ * @param unlessClause the name of the property that must not be set in order for this target to execute. This value can be null
+ * @param description a short description of this target's function. This value can be null
+ */
+ public void printTargetDeclaration(String name, String depends, String ifClause, String unlessClause, String description);
+
+ /**
+ * Print the end tag for a target declaration.
+ */
+ public void printTargetEnd();
+
+ /**
+ * Print an echo task
+ * @param file - file to write the message to (or null)
+ * @param message - the message to echo
+ * @param level - the level to report the message (ie, "error", "warning", "info"), "warning" is the default if null is passed.
+ * @since 3.6
+ */
+ public void printEchoTask(String file, String message, String level);
+
+ /**
+ * Print the beginning of a macro definition.
+ * @param macroName the name of the macro
+ * @param attributes the attributes of the macro
+ * @since 3.6
+ */
+ public void printMacroDef(String macroName, Listorg.eclipse.pde.build.fetchFactories extension-point.
+ *
+ * The factories are being used at various points in the execution of the PDE Build eclipse.fetch Ant task.
+ * Based on a map file entry, they are responsible for generating segments of an ant script whose execution will fetch
+ * plug-ins, fragments, bundles and features or individual files contained in one of those elements.
+ * The format of a map file entry is:
+ *
+ * <elementType>@<elementName> = <repositoryTag>, <repositoryDetails>
+ *
+ * The format of elementType and elementName is fixed.
+ * The factories specify the value of repositoryTag and the format of the repositoryDetails.
+ * repositoryTag and repositoryDetails becomes defacto APIs.
+ *
+ * repositoryTag should match the factory id used when declaring the factory extension. For example, for the CVS the value is "CVS".
+ * repositoryDetails should contains enough details to allow the factory to generate a fetch script retrieving the element.
+ *
+ * The fetch factories are being contributed through the org.eclipse.pde.build.fetchFactories
+ * extension-points.
+ *
+ * Fetch factories will not be re-used between different PDE Build eclipse.fetch Ant tasks. Each task will create at
+ * most one fetch factory instance for the duration of the task processing. This allows implementors to
+ * build and maintain stateful information. Such information must be released in {@link #addTargets(IAntScript)} call.
+ *
+ * The grammar of the expected value is limited to: + *
+ * value::= (alpha|digit|'_'|'-')+ + * digit ::= [0..9] + * alpha ::= [a..zA..Z] + *+ * */ + public static final String KEY_ELEMENT_TAG = "tag"; //$NON-NLS-1$ + + /** One of the value for element type. See {@link #KEY_ELEMENT_TYPE}.*/ + public static final String ELEMENT_TYPE_BUNDLE = "bundle"; //$NON-NLS-1$ + + /** One of the value for element type. See {@link #KEY_ELEMENT_TYPE}.*/ + public static final String ELEMENT_TYPE_FEATURE = "feature"; //$NON-NLS-1$ + + /** One of the value for element type. See {@link #KEY_ELEMENT_TYPE}.*/ + public static final String ELEMENT_TYPE_FRAGMENT = "fragment"; //$NON-NLS-1$ + + /** One of the value for element type. See {@link #KEY_ELEMENT_TYPE}.*/ + public static final String ELEMENT_TYPE_PLUGIN = "plugin"; //$NON-NLS-1$ + + /** + * This method should parse / validate a mapfile entry and derive a corresponding + * key / value pair structure containing the relevant information. + *
+ * The arguments specified in the map file are provided. The map with entry + * infos should be filled with provider specific information that is + * required in later processing to sucessfully generate the fetch script. + *
+ *+ * Since 3.6, factories may optionally set the {@link Constants#KEY_SOURCE_REFERENCES} property in the entry infos map to support the inclusion + * of source references in the bundle manifest using the Eclipse-SourceReferences header. + *
+ * @param rawEntry the arguments as specified in the map file (may not benull).
+ * @param overrideTags a key / value containing all the override tags specified for all the repository (maybe null or empty).
+ * The values of this map of this are read from the fetchTag property (see file scripts/templates/headless-build/build.properties).
+ * @param entryInfos the map to store repository specific information derived from the rawEntry.This object is being passed as arguments to
+ * the other methods of the factory. The factories are also expected to set {@link #KEY_ELEMENT_TAG} to indicate the tag that will be used
+ * to fetch the element. This value is for example used to generate the "qualifier" value of a version number.
+ * Note that {@link #KEY_ELEMENT_NAME} and {@link #KEY_ELEMENT_TYPE} are reserved entries whose values respectively
+ * refer to the name of the element being fetched and its type.
+ * @throws CoreException if the rawEntry is incorrect.
+ */
+ public void parseMapFileEntry(String rawEntry, Properties overrideTags, Mapplugin.xml file is expected
+ * to be in destination/plugin.xml.
+ * @param script the script in which to generate the segments of ant script. It is not authorized to generate target declaration during this call.
+ */
+ public void generateRetrieveElementCall(Mapplugin.xml file is expected
+ * to be in destination/plugin.xml.
+ * @param files the files to obtained for the specified element.
+ * @param script the script in which to generate the segments of ant script. It is not authorized to generate target declaration during this call.
+ */
+ public void generateRetrieveFilesCall(MapThis package contains the interfaces necessary to contribute a new repository support to the eclipse.fetch task of PDE Build. +
+ + diff --git a/tycho-its/projects/api-tools/embedded-jars/org.eclipse.pde.build/src_ant/META-INF/eclipse.inf b/tycho-its/projects/api-tools/embedded-jars/org.eclipse.pde.build/src_ant/META-INF/eclipse.inf new file mode 100644 index 0000000000..b4df3ab631 --- /dev/null +++ b/tycho-its/projects/api-tools/embedded-jars/org.eclipse.pde.build/src_ant/META-INF/eclipse.inf @@ -0,0 +1 @@ +jarprocessor.exclude.sign=true \ No newline at end of file diff --git a/tycho-its/projects/api-tools/embedded-jars/pom.xml b/tycho-its/projects/api-tools/embedded-jars/pom.xml new file mode 100644 index 0000000000..4ee027e572 --- /dev/null +++ b/tycho-its/projects/api-tools/embedded-jars/pom.xml @@ -0,0 +1,59 @@ + +