Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "E4/UI/Running the contacts demo"

< E4‎ | UI
(Known issues)
(Setup steps)
Line 22: Line 22:
 
##If you downloaded the eclipse e4 SDK you can quickly load the demo projects by generating a PSF project, using the menu '''e4>Generate e4 Example Project'''
 
##If you downloaded the eclipse e4 SDK you can quickly load the demo projects by generating a PSF project, using the menu '''e4>Generate e4 Example Project'''
 
##Then select the ''/org.eclipse.e4.examples.psf/e4-examples.psf'' file and '''Import PSF Project''' from the context menu.
 
##Then select the ''/org.eclipse.e4.examples.psf/e4-examples.psf'' file and '''Import PSF Project''' from the context menu.
 +
##skip to step 10
 
#Select File > Import... and select CVS > Projects from CVS, click Next.
 
#Select File > Import... and select CVS > Projects from CVS, click Next.
 
#Copy the CVS repository location and paste it into the "Host" field to populate the wizard page: <code>:pserver:anonymous@dev.eclipse.org:/cvsroot/eclipse</code>
 
#Copy the CVS repository location and paste it into the "Host" field to populate the wizard page: <code>:pserver:anonymous@dev.eclipse.org:/cvsroot/eclipse</code>
Line 28: Line 29:
 
#Drill down as follows: e4 > org.eclipse.e4.ui > examples and select org.eclipse.e4.demo.contacts. Click Next.
 
#Drill down as follows: e4 > org.eclipse.e4.ui > examples and select org.eclipse.e4.demo.contacts. Click Next.
 
#Important: Do not click Finish just yet. Advance to the last wizard page using Next, then click on Refresh Tags. Select the tag appropriate for your installation (e.g. R1_0M4, I20100112-0800, R0_9 ... you can find your installation's build tag in the Help > About Eclipse SDK dialog) and click Finish.
 
#Important: Do not click Finish just yet. Advance to the last wizard page using Next, then click on Refresh Tags. Select the tag appropriate for your installation (e.g. R1_0M4, I20100112-0800, R0_9 ... you can find your installation's build tag in the Help > About Eclipse SDK dialog) and click Finish.
#This will check out one project into your workspace. Expand the project in the Package Explorer and open the contacts.product file.  
+
#This will check out a project into your workspace. Expand the project in the Package Explorer and open the contacts.product file.  
 
#In the opened editor, navigate to the 'Testing' section in the 'General' tab.
 
#In the opened editor, navigate to the 'Testing' section in the 'General' tab.
 
#Click the 'Launch an Eclipse application' hyperlink. An error will show up.
 
#Click the 'Launch an Eclipse application' hyperlink. An error will show up.

Revision as of 15:50, 26 February 2010

A screenshot of the e4 contacts demo as of 1.0M2.
The instructions provided on this page were last updated for the e4 1.0M4 milestone.

The e4 contacts demo showcases an e4-based RCP application that allows the user to view and edit vCards.

Prerequisites

Features

  • Displays the usage and definition of commands, handlers, and keybindings in e4
    • Ctrl+D switches to the "Dark Theme"
    • Ctrl+L switches to the "Bright Theme"
    • Ctrl+5, X will exit the application (demonstrates multistroke keybindings)
    • Ctrl+S to save the vCard that's currently opened
  • Shows how CSS can be used to skin an application (note that the CSS engine does not have any particular dependencies on e4 technologies and can be reused in an Eclipse 3.x-based application)
  • Editing a vCard will cause the part to display the '*' dirty affordance (demonstrates the life cycle of saveable parts)

Setup steps

  1. Download an e4 SDK here.
  2. Unzip/Untar the file as you would with a regular Eclipse SDK download.
  3. Start up Eclipse.
    1. If you downloaded the eclipse e4 SDK you can quickly load the demo projects by generating a PSF project, using the menu e4>Generate e4 Example Project
    2. Then select the /org.eclipse.e4.examples.psf/e4-examples.psf file and Import PSF Project from the context menu.
    3. skip to step 10
  4. Select File > Import... and select CVS > Projects from CVS, click Next.
  5. Copy the CVS repository location and paste it into the "Host" field to populate the wizard page: :pserver:anonymous@dev.eclipse.org:/cvsroot/eclipse
  6. You should see "Host: dev.eclipse.org, Repository path: /cvsroot/eclipse, User: anonymous, Connection type: pserver".
  7. Click Next and select the second option Use an existing module.
  8. Drill down as follows: e4 > org.eclipse.e4.ui > examples and select org.eclipse.e4.demo.contacts. Click Next.
  9. Important: Do not click Finish just yet. Advance to the last wizard page using Next, then click on Refresh Tags. Select the tag appropriate for your installation (e.g. R1_0M4, I20100112-0800, R0_9 ... you can find your installation's build tag in the Help > About Eclipse SDK dialog) and click Finish.
  10. This will check out a project into your workspace. Expand the project in the Package Explorer and open the contacts.product file.
  11. In the opened editor, navigate to the 'Testing' section in the 'General' tab.
  12. Click the 'Launch an Eclipse application' hyperlink. An error will show up.
  13. Run > Run Configurations...
  14. Now launch the product from the dialog, it should open.

Known issues

  1. The splash screen does not currently go away, see bug 277463.
  2. The examples PSF works correctly with each milestone, but is invalid for I builds, see bug 298011.

Back to the top