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 by File -> New -> Consolidation Project (located in the in SPLevo category).
This will automatically a new project with a SPLevo project file, switch to the SPLevo perspective and open the SPLevo Analysis Dashboard:
On the SPLevo Dashboard, click on the button "Project Selection", or on the tab "source projects" and drag and drop the leading and integration projects to be analyzed in the according widgets.
Note: The drag and drop is only available using the Project Explorer as shown in the screenshot.
The "Variant Names" are filled automatically during the project drag and drop, but you can adapt them afterwards if you want to.
On the dashboard click the button "Diffing" to start the difference analysis. A pop up notifies you as soon as it finishs.
== Variation Point Model (VPM) Initialization ==
Click the button "Init VPM". As before, a dialog will confirm the intialization and the models directory will contain the vpm.
This initializes a fine granular variation point model (VPM) with each difference being represented as one variation point including the according variants. The VPM is used in the downstream process to develop the variability of the future product-line.
To see which differences have been detected and are available as variation points, click on the small button below the "Init VPM" button.
This will open the current VPM in the Variation Point Explorer.
File:splevo-vpexplorer.png
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.
== Variation Point Model Analysis == Now, we are ready to analyze the identified variation points (differences) for any relationships between them.
Click the button "Analyze 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"
File:analyzer-selection.png
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"
File:splevo-refinement-browser.png
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.
File:splevo-vpexplorer-2.png
== Feature Model Generation ==
Finally, to get a feature representation for discussion with the product management, click on "Generate Feature Model". This 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.
File:splevo-feature-model.png