carbidecpp22devenv/configuration/org.eclipse.osgi/bundles/188/1/.cp/cheatsheets/rcpapp/rcpapp-plugin-product.xml
<?xml version="1.0" encoding="UTF-8" ?>
<!--
Copyright (c) 2005, 2009 IBM Corporation and others.
All rights reserved. This program and the accompanying materials
are made available under the terms of the Eclipse Public License v1.0
which accompanies this distribution, and is available at
http://www.eclipse.org/legal/epl-v10.html
Contributors:
IBM Corporation - initial API and implementation
-->
<!-- Simple Cheat Sheet -->
<cheatsheet title="Define a plug-in based product">
<!-- Introduction -->
<intro href="/org.eclipse.platform.doc.user/reference/ref-cheatsheets.htm">
<description>
This cheat sheet will demonstrate how to define a plug-in based
product configuration for an RCP application and run an RCP application
product using PDE.
<br/>
<br/>
To learn more about using cheat sheets, click the help button
in the top right corner (?).
</description>
</intro>
<!-- Item -->
<item title="Open the plug-in development perspective"
href="/org.eclipse.pde.doc.user/guide/tools/views/views.htm"
dialog="false"
skip="false">
<description>
To open the plug-in development perspective,
select <b>Window->Open Perspective->Other...</b>
and choose <b>Plug-in Development</b>.
<br/>
<br/>
Alternatively, click the following button to perform the task.
</description>
<command serialization="org.eclipse.ui.perspectives.showPerspective(org.eclipse.ui.perspectives.showPerspective.perspectiveId=org.eclipse.pde.ui.PDEPerspective)" required="false" translate="" />
</item>
<!-- Item -->
<item title="Create the product configuration"
href="/org.eclipse.pde.doc.user/guide/tools/file_wizards/new_product_config.htm"
dialog="true"
skip="false">
<description>
To create the product configuration, perform the following steps:
</description>
<subitem label="Select "File->New->Product Configuration" from the main menu"
skip="false">
<command serialization="org.eclipse.ui.newWizard(newWizardId=org.eclipse.pde.ui.NewProductConfigurationWizard)" required="false" translate="" />
</subitem>
<subitem label="Select "com.example.rcpapp" in the resulting "New Product Configuration" wizard page"
skip="false"/>
<subitem label="Input "rcpapp.product" into the "File name" text box"
skip="false"/>
<subitem label="Select the "Use a launch configuration" radio button inside the "Initialize the file content" group and click "Finish""
skip="false"/>
</item>
<!-- Item -->
<item title="Open the product editor"
href="/org.eclipse.pde.doc.user/guide/tools/editors/product_editor/editor.htm"
dialog="false"
skip="false">
<description>
To open the product editor (if it is not already open),
expand the <b>com.example.rcpapp</b> tree dialog
in the <b>Package Explorer</b> view and double-click
on the <b>rcpapp.product</b> file (the <b>Overview</b> page
should be open initially).
<br/>
<br/>
Alternatively, click the following button to perform the task.
</description>
<command serialization="org.eclipse.ui.navigate.openResource(filePath=/com.example.rcpapp/rcpapp.product)" required="false" translate="" />
</item>
<!-- Item -->
<item title="Define the product"
href="/org.eclipse.pde.doc.user/guide/tools/editors/product_editor/overview.htm"
dialog="true"
skip="false">
<description>
To define the product, perform the following steps:
</description>
<subitem label="Input "RCP Application" into the "Name" text box on the "General Information" section"
skip="false"/>
<subitem label="Click the "New..." button next to the "Product" drop down menu to open the "New Product Definition" dialog box"
skip="false"/>
<subitem label="Verify "com.example.rcpapp" is the inputted value for the "Defining Plug-in" text box"
skip="true"/>
<subitem label="Verify "product" is the inputted value for the "Product ID" text box"
skip="true"/>
<subitem label="Accept the defaults and click "Finish""
skip="false"/>
<subitem label="Select "File->Save" from the main menu"
skip="false"/>
</item>
<!-- Item -->
<item title="Synchronize the product configuration with the defining plug-in"
href="/org.eclipse.pde.doc.user/guide/tools/editors/product_editor/overview.htm"
dialog="true"
skip="false">
<description>
Product configurations and their constituent files may become
unsynchronized. This situation is apparent when changes
made using the product editor are not reflected in the application.
<br/>
<br/>
To synchronize the product configuration with the defining plug-in,
click the <b>Synchronize</b> hyperlink under the <b>Testing</b>
heading on the product editor <b>Overview</b> page.
<br/>
<br/>
Note: PDE automatically synchronizes the product configuration
when the <b>Launch an Eclipse Application</b> hyperlinks under the
<b>Testing</b> heading are used.
</description>
</item>
<!-- Item -->
<item title="Run the RCP product"
dialog="false"
href="/org.eclipse.pde.doc.user/guide/tools/editors/product_editor/overview.htm"
skip="false">
<description>
To run the RCP product,
perform the following steps:
</description>
<subitem label="Click the "Launch an Eclipse application" hyperlink under the "Testing" heading"
skip="false"/>
<subitem label="Note: "RCP Application" now shows up in the window title bar"
skip="true"/>
<subitem label="Exit the RCP application"
skip="false"/>
</item>
</cheatsheet>