This tutorial explains how to create your first update site to distribute a graphical modeling tool created with Eclipse Sirius.
The instructions describe the creation of an update site for the result of the basic tutorial: a modeling tool which simply allows the user to graphically represent a family.
Get the modeling tool in your environment
Otherwise, start by following the instructions to install the Basicfamily Domain Model:
Install the solution of the Starter Tutorial. It is implemented by a Viewpoint Specification Project that you need to import into your workspace. This project can be easily installed from the provided examples (menu File > New > Example... : select Basic Family Sample Modeler Definition).
By default the icons defined in the modeler are not exported into the update site: you have do update the project definition in order to get these icons in the final modeler.
Open the file MANIFEST.MF from the META-INF directory of the project org.eclipse.sirius.sample.design.
In the tab Build check the icons folder in the Binary Build list.
Start creating the update site
Create a Feature Project
The first step consists in creating a feature project containning all the features necessary to create the update site.
Right click in the Model Explorer view and select Other....
Select Feature Project.
Then set the feature's properties:
- Project name:
- Feature Name:
- Feature Vendor:
Your name company
Finally, click on Next and select the projects defining your complete modeling tool: the metamodel, the modeler and all the other required plugins.
Click on Finish.
Create an Update Site project
Right click in the Model Explorer view and select New > Other….
Select Update Site Project.
Then set the project name :
Click on Finish: Eclipse creates the project and opens an editor on the site.xml file.
Add a new Category and name it Basic Family (id :
Add the feature org.eclipse.sirius.sample.basicfamily.feature to the category. This defines a category proposed during the installation of the plugin.
Finally, click on Build to launch the update site creation:
Export the Update Site project
Now it is necessary to export the update site to an archive.
Select these resources:
- folder features
- folder plugins
- file artifacts.jar
- file content.jar
- file site.xml
Right click on the selected resources and click on Export
Select Archive File in General section
Fill the To archive file field to define the archive location and select the option Create only selected directories.
Warning : The .project file should not be selected.
Click on Finish: the archive is exported to the path defined previously.
Test the Update Site
Install the modeler
To verify if the Update Site works correctly, install the Basic Family modeler in a new Sirius environment or in a new Obeo Designer.
Open your Eclipse environment and select Help > Install New Software….
Click on Add… and fill the fields
Basic Family Modeler
- Location:Click on "Archive… " button and retrieve the archive exported previously
Click on Ok button
Ckick on Next button and follow instructions.
Run the Modeler
After Sirius or Obeo Designer has restarted, import the Sample Basic Family model as described in Import a sample model.
After selecting the viewpoint you can use the modeler