This extension point should be used to register Eclipse code samples. A sample is one or more Eclipse projects that are packaged in a way suitable for subsequent import into the workspace.
Each sample has a name, one or more project elements and a final perspective. The sample wizard will create a project for each
project element, import the content from the archive, and open the final perspective if specified. Projects must be complete i.e. have correct nature and classpath (if Java or plug-in projects).
If target view is specified and contains resource elements, it will be used to select and reveal those resources in the view after the sample has been created.
This extension point is currently provided for internal Eclipse SDK usage only. It should not be used for anything else except Eclipse SDK examples.
<!ELEMENT extension (sample+)>
point CDATA #REQUIRED
id CDATA #IMPLIED
name CDATA #IMPLIED>
<!ELEMENT sample (description , project+ , activity*)>
id IDREF #REQUIRED
name CDATA #REQUIRED
perspectiveId IDREF #IMPLIED
launcher CDATA #IMPLIED
targetViewId IDREF #IMPLIED>
an element that represents a single sample to be imported into the workspace.
org.eclipse.ui.part.ISetSelectionTargetinterface. Resources listed in
projectelements will be selected and revealed in the target view.
<!ELEMENT project EMPTY>
name CDATA #REQUIRED
archive CDATA #REQUIRED
shared (true | false)
selectReveal CDATA #IMPLIED>
each project element will result in a workspace project being created with the content imported from the associated archive.
true, and the project with the same name already exists in the workspace, it will be silently skipped. Otherwise, users will be prompted for overwrite permission.
<!ELEMENT description EMPTY>
helpHref CDATA #IMPLIED>
body text of this element should contain description of the sample.
<!ELEMENT activity EMPTY>
id CDATA #REQUIRED>
specifies an activity that needs to be enabled for this sample
The following is an example of the extension point:
<extension point="org.eclipse.pde.ui.samples"> <sample id="com.example.xyz.sample" name="My Sample"> <description helpHref="/com.example.xyz.doc/samples/com.example.xyz.sample1/doc-html/doc.html"> A short description of the sample. </description> <project name="com.example.xyz.sample1" archive="samples/sample1.zip"/> </sample> </extension>
If specified, the value of the attribute
launcher must represent a fully qualified name of the Java class that implements
PDE UI supplies Runtime Workbench launcher for launching another instance of Eclipse.
Copyright (c) 2004, 2013 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-v20.html/ SPDX-License-Identifier: EPL-2.0.