Quick Start Guide
This is a short introduction how to create a SPLevo project and analyze your product copies.
To follow this quick start, it is recommended to download the Calculator Example. Extract the two Eclipse projects contained in the calculator example zip archive and import them into your eclipse workspace.
Install the SPLevo Core and JaMoPP Java Cartridge from the nightly update site:
http://sdqweb.ipd.kit.edu/eclipse/splevo/nightly/
Create a new project using the SPLevo menu and select "New Consolidation Project" (see Screenshot below).
A wizard will ask your to provide a name for your consolidation project and lets you select the projects to consolidate
Provide a reasonable name, select the projects you want to consolidate, provide names for the variants, and click finish.
You will be presented with the SPLevo Dashboard to control your consolidation:
To start over, click the "Init VPM" button. Your product copies will be analyzed for differences between them and a variation point model (VPM) will be opened in the VP Explorer on the left.
This explorer lets you browse through the resources differing between the product variants to be consolidated. The variation points are presented according to the resources they are contained in.
At this point, you are presented with a fine granular VPM with each difference being represented as one variation point (VP) including the according variants. The VPM is used in the downstream process to design the variability of the future spoftware productline.
Now, we are ready to analyze the identified variation points (differences) for any relationships between them.
Click the button "Refine VPM". A dialog will open to let you select the analyzers you would like to execute.
Recommendation for the QuickStart: Choose the "JaMoPP Program Dependency Analyzer"
Now, click on the next button. On the following page you can choose between the VPM Graph visualisation or the refinement browser. The former provides a fancy vizualization only, but you should go with VPM Refinement Browser selected by default. Keep the rest of the settings as they are for now, and go with the "finish" button.
This will start the analysis and as soon as it is done, the VPM Refinement Browser is opened and recommends reasonable merges and groupings of the variation points based on the relationships identified between them. If you click on a recommended refinement, information about the recommendations are presented in the right margin of the browser. In the center area, you can expand a tree with variation points that will be merged or grouped. (A right click on the Variation Points or contained variants provides you a link to the related source code).
However, you should accept the refinements and click on the small arrow beside of the "SPLevo Refinement Browser" title and choose "Apply Refinements"
The variation point model is now adapted according to the refinements and if you use the small button below the "Init VPM" again, the Variation Point Explorer will show you the new, refined version of the variation point model.
Finally, the Product Lines Export will later on allow to finalize all artifacts required to continue with a single code base product line. Up to knwo, it allows for getting a feature representation of the variability designed so far. Clicking on "Generate Feature Model" will generate a feature model and open it as a feature diagram. The model and diagram files are located in a subdirectory of your consolidation project "models\fm" in your consolidation project.
