Difference between revisions of "Tutorial: Project Development"

From Developer Documents
Jump to navigation Jump to search
m
m
Line 102: Line 102:
  
 
* Open UI plugin settings: '' '''org.com.acme.movie.ui''' >> '''plugin.xml''' ''
 
* Open UI plugin settings: '' '''org.com.acme.movie.ui''' >> '''plugin.xml''' ''
* Add ''org.simantics.project'' to dependencies: '' '''Dependencies''' >> '''Required Plug-ins''' >> '''Add...''' ''
+
* Add some plug-in dependencies: '' '''Dependencies''' >> '''Required Plug-ins''' >> '''Add...''' ''
 +
** ''org.simantics.project'', ''org.simantics.db'', ''org.simantics.utils'', ''org.simantics.utils.datastructures''
 
* Add ''org.simantics.project.feature'' extension: '' '''Extensions''' >> '''Add...''' >> '''org.simantics.project.feature''' ''
 
* Add ''org.simantics.project.feature'' extension: '' '''Extensions''' >> '''Add...''' >> '''org.simantics.project.feature''' ''
 
* id = ''com.acme.movie.feature''
 
* id = ''com.acme.movie.feature''
Line 108: Line 109:
 
* published = true
 
* published = true
 
* class = ''com.acme.movie.ui.ProjectFeature''
 
* class = ''com.acme.movie.ui.ProjectFeature''
* Instantiate the class: click the blue ''class*.'' link to open a wizard.
+
 
 +
Create Project Feature class and set the default perspective.
 +
* Instantiate the class: click the blue ''class*.'' link to open a wizard. '''Finish'''
 +
* Add method configure(). Note, you can automatically import dependency classes with (''ctrl-shift-o, organize imports'').
 +
<syntaxhighlight lang="java">
 +
    public class ProjectFeature extends AbstractProjectFeature implements IProjectFeature {
 +
 
 +
@Override
 +
public void configure() throws ProjectException {
 +
        getProject().setHint(ProjectKeys.DEFAULT_PERSPECTIVE, "com.acme.movie.ui.perspective");
 +
}
 +
 
 +
    }
 +
</syntaxhighlight>
 +
 
  
  
Line 124: Line 139:
 
* Click ''Launch an Eclipse application''
 
* Click ''Launch an Eclipse application''
  
If everything goes fine a simantics platform should start and open up. There will be no default perspective but you can choose your "Movie Production" perspective. It should look like this, if not, you can look for help in the tutorial source codes at https://www.simulationsite.net/svn/simantics/tutorials/trunk/
+
If everything goes fine a simantics platform should start and open up. It should look like this, if not, you can look for help in the tutorial source codes at https://www.simulationsite.net/svn/simantics/tutorials/trunk/
  
 
[[file:tutorial_perspective.png]]
 
[[file:tutorial_perspective.png]]

Revision as of 09:47, 20 October 2010

Our customer wants a tool to aid in production of motion pictures. In this tutorial series we are going to create a Movie Production tool over Simantics Platform. In this part we create a UI plugin, a perspective and a feature.

Step 1: Create UI Plugin

To create the a new plugin, open the wizard.

  • File >> New >> Plug-in Development >> Plug-in Project >> Next >

Project name for the feature is com.acme.movie.ui. Next >. In the wizard you should know that you'll have a use for an activator, check that, the plug-in makes UI contributions, but is not a rich client application. Finish

Open the plugin from plugin.xml. From Overview page make sure This plug-in is a singleton.

Step 2: Create Perspective

Perspective is a viewport to work is done in a project (Read More). We need a movie production perspective. The plan is to have a model browser (left), an editor for diagram representations (center), a properties view (bottom) and a database view (right). Here is a sketch.

Sketch.png


Lets start. Add Movie Production perspective.

  • Open com.acme.movie.ui / META-INF/MANIFEST.MF >> Extensions
  • Add a new extension, org.eclipse.ui.perspectives
  • A node will appear, select it, right click new >> perspective. Select it.
  • Add info, put com.acme.movie.ui.perspective as id, "Movie Production" as name, and com.acme.movie.ui.PerspectiveFactory as class name.
  • Create perspective factory class. Click on the blue underlined "Class *:" link, a class instantiation wizard will open. Finish.
  • Make the editor area permanently visible by editing the class

<syntaxhighlight lang="java">

   public class PerspectiveFactory implements IPerspectiveFactory {
     @Override
     public void createInitialLayout(IPageLayout layout) {
       layout.setEditorAreaVisible(true);		
     }
   }

</syntaxhighlight>


The empty perspective needs content, lets start with the Model Browser. It should be located on the left-hand side as planned in the sketch. Simantics has such component, its identifier is org.simantics.structural.ui.modelBrowser. We are going to add a perspective extension that states that, in this perspective there is a Model Browser that is located to the left of the editor area. FYI the identifier of the editor area is org.eclipse.ui.editorss.

Add Model Browser View to the perspective.

  • Add new extension org.eclipse.ui.perspectiveExtensions
  • Put com.acme.movie.ui.perspective as targetID
  • Add model browser
    • com.acme.movie.ui.perspective >> right-click >> new >> view
    • id = org.simantics.structural.ui.modelBrowser
    • relationship = left
    • relative = org.eclipse.ui.editorss
    • ratio = 0.2
    • visible = true
    • closable = false


Apply the same steps to add property view at the bottom.

  • com.acme.movie.ui.perspective >> right-click >> new >> view
  • id = org.simantics.browsing.ui.graph.propertyView
  • relationship = left, org.eclipse.ui.editorss
  • ratio = 0.7
  • visible = true
  • closable = false


And symbol library on the right.

  • com.acme.movie.ui.perspective >> right-click >> new >> view
  • id = org.simantics.diagram.symbollibrary.managed
  • relationship = left
  • relative = org.eclipse.ui.editorss
  • ratio = 0.6
  • visible = true
  • closable = false

Step 3: Create Feature

Feature is a set of plug-ins grouped into a single manageable unit.

Create feature

  • Open wizard File >> New >> Plug-in Development >> Feature Project >> Next >
  • Project name for feature is com.acme.movie.feature. Next >.
  • The feature includes both com.acme.movie.ontology and .ui plugins, check those. Finish

Step 4: Create Product

In the final release the application would be delivered as a Feature. Features can be installed from an update site using Simantics Project Manager (SPM). But for development we are going to create a product.

Create a new product configuration

  • File >> New >> Plug-in Development >> Product Configuration >> Next >
  • Select com.acme.movie.ui as parent folder and put Movie.product for filename. Finish

Create Product extension

  • Open Movie.product
  • Select New Product. A wizard will open. Leave Defining Plug-in as com.acme.movie.ui and Product ID product.
  • Select org.simantics.workbench.application as Product Application. Finish.
  • Open Movie.product and Overview tab sheet from the editor bottom.
    • Add values for ID, Version and Name; say com.acme.movie, 1.0 and "Motion Picture Production Manager"
    • Choose org.simantics.workbench.product as Product and org.simantics.workbench.application as Application
    • Select "The product configuration is based on: features"
  • Open Dependencies tab sheet from the editor bottom.
    • Add org.simantics.sdk
    • Add com.acme.movie.feature
    • Save file.


Step 5: Simantics Feature

Add Simantics Project Feature. See Project Development.

  • Open UI plugin settings: org.com.acme.movie.ui >> plugin.xml
  • Add some plug-in dependencies: Dependencies >> Required Plug-ins >> Add...
    • org.simantics.project, org.simantics.db, org.simantics.utils, org.simantics.utils.datastructures
  • Add org.simantics.project.feature extension: Extensions >> Add... >> org.simantics.project.feature
  • id = com.acme.movie.feature
  • label = Movie Production Feature
  • published = true
  • class = com.acme.movie.ui.ProjectFeature

Create Project Feature class and set the default perspective.

  • Instantiate the class: click the blue class*. link to open a wizard. Finish
  • Add method configure(). Note, you can automatically import dependency classes with (ctrl-shift-o, organize imports).

<syntaxhighlight lang="java">

   public class ProjectFeature extends AbstractProjectFeature implements IProjectFeature {

@Override public void configure() throws ProjectException {

       getProject().setHint(ProjectKeys.DEFAULT_PERSPECTIVE, "com.acme.movie.ui.perspective");

}

   }

</syntaxhighlight>


Create install group.

  • Open UI plugin's extensions: org.com.acme.movie.ui >> plugin.xml >> Extensions
  • Select your feature Movie Production Feature
  • Add installGroup right-click >> New >> installGroup
  • id = com.acme.movie.feature.group


Step 6: Run it

OK, you have now a feature and a product configuration. Give it a go.

  • Open Movie.product
  • Click Launch an Eclipse application

If everything goes fine a simantics platform should start and open up. It should look like this, if not, you can look for help in the tutorial source codes at https://www.simulationsite.net/svn/simantics/tutorials/trunk/

Tutorial perspective.png



Handshake.png Congratulations You have now set-up a simantics project.

In the next part you will be developing a model.
Next.png Tutorial 3: Model Development