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
(Prerequisites)
(Setup steps)
 
(22 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Image:E4-contacts-demo.PNG|thumb|400px|A screenshot of the e4 contacts demo as of 1.0M2.]]
+
[[Image:E4-contacts-demo.PNG|thumb|400px|A screenshot of the e4 contacts demo.]]
 +
:''The instructions provided on this page were last updated for the Eclipse 4.4 release.
 +
 
 
The '''e4 contacts demo''' showcases an e4-based RCP application that allows the user to view and edit vCards.
 
The '''e4 contacts demo''' showcases an e4-based RCP application that allows the user to view and edit vCards.
  
 
==Prerequisites==
 
==Prerequisites==
*[[E4/Install|e4 SDK installation]]
+
#Download an Eclipse SDK [http://download.eclipse.org/eclipse/downloads/ here].
 +
#Start up Eclipse.
 +
#Install the EMF SDK from the appropriate release site
  
 
==Features==
 
==Features==
 
*Displays the usage and definition of commands, handlers, and keybindings in e4
 
*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+5, X will exit the application (demonstrates multistroke keybindings)
 
**Ctrl+S to save the vCard that's currently opened
 
**Ctrl+S to save the vCard that's currently opened
Line 15: Line 17:
  
 
==Setup steps==
 
==Setup steps==
#Download an e4 SDK [http://download.eclipse.org/e4/downloads/ here].
+
#Clone the UI git repo from [http://git.eclipse.org/c/platform/eclipse.platform.ui.git eclipse.platform.ui]
#Unzip/Untar the file as you would with a regular Eclipse SDK download.
+
#Use the EGit Repository view and '''Import Projects''' to import 'org.eclipse.e4.demo.contacts' and 'org.eclipse.e4.demo.contacts.features' into your workspace
#Start up Eclipse.
+
#Expand the 'org.eclipse.e4.demo.contacts' project and open the contacts.product file.  
#e4 > General e4 Example Project
+
#In the opened editor, navigate to the 'Testing' section in the 'General' tab. It should be located in the bottom left hand side of the editor.
#Locate the <code>e4-examples.psf</code> file in the generated <code>org.eclipse.e4.examples.psf</code> project.
+
#Click the 'Launch an Eclipse application' hyperlink. The demo should then launch.
#Right-click > Import Project Set
+
#You may be prompted to provide information about the CVS repository. If such a dialog appears, simply click 'OK' to advance.
+
#For the user name, please use <code>anonymous</code> and leave the password field blank.
+
#The check out operation should complete successfully.
+
#Locate the <code>contacts.product</code> file in the generated <code>org.eclipse.e4.demo.contacts</code> project and open it.
+
#In the opened editor, navigate to the 'Testing' section in the 'General' tab.
+
#Click the 'Launch an Eclipse application' hyperlink. The demo should now come up.
+
  
 
==Known issues==
 
==Known issues==
#The splash screen does not currently go away, see {{bug|277463}}.
+
*The splash screen does not currently go away, see {{bug|277463}}.
#On GTK+, the background of the list may not be themed properly, see {{bug|285036}}.
+
*The examples PSF works correctly with each milestone, but is invalid for I builds, see {{bug|298011}}.
 +
*Contact demo fails to launch from the .product file.  Open the Run Configuration dialog and hit Run, see {{bug|303973}}.

Latest revision as of 13:25, 20 June 2014

A screenshot of the e4 contacts demo.
The instructions provided on this page were last updated for the Eclipse 4.4 release.

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

Prerequisites

  1. Download an Eclipse SDK here.
  2. Start up Eclipse.
  3. Install the EMF SDK from the appropriate release site

Features

  • Displays the usage and definition of commands, handlers, and keybindings in e4
    • 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. Clone the UI git repo from eclipse.platform.ui
  2. Use the EGit Repository view and Import Projects to import 'org.eclipse.e4.demo.contacts' and 'org.eclipse.e4.demo.contacts.features' into your workspace
  3. Expand the 'org.eclipse.e4.demo.contacts' project and open the contacts.product file.
  4. In the opened editor, navigate to the 'Testing' section in the 'General' tab. It should be located in the bottom left hand side of the editor.
  5. Click the 'Launch an Eclipse application' hyperlink. The demo should then launch.

Known issues

  • The splash screen does not currently go away, see bug 277463.
  • The examples PSF works correctly with each milestone, but is invalid for I builds, see bug 298011.
  • Contact demo fails to launch from the .product file. Open the Run Configuration dialog and hit Run, see bug 303973.

Back to the top