(r6) Emergo < SPG

SPG Web>SoftwareProductivityGroup>GenteAreaProjects>AspectProductLine>BibliografiaAspectosProductLines>EmergentAndDFA>Emergo (revision 6) (raw view)~~EditAttach~~
---+!! !Emergo
---------------------------------------------------------------------------------------------------------------------
---++Introduction
Features in product lines eventually share elements between them, which might break feature modularization, since modifications in a feature result in problems for another. The concept of Emergent Interfaces aims to establish contracts between features, to prevent developers from breaking other features when performing a maintenance task. !Emergo is an Eclipse plug-in that automates the computation of feature dependencies in preprocessor-based product lines.

 <img src="%ATTACHURL%/Emergo.png" alt="Emergo" />

---------------------------------------------------------------------------------------------------------------------
---++Main functionalities
!Emergo's main functionality is the automatic computation of emergent interfaces, which establish contracts between features and make developers aware of feature dependencies. Supporting this main functionality, !Emergo provides the following facilities: 
   * Provides two views to show emergent interfaces: one based on table and one based on graph;
   * Better navigation on the source code: from both table and graph views, developers can find feature dependencies in source code through mouse clicks;
   * Takes the feature model product line into consideration;

---------------------------------------------------------------------------------------------------------------------
---++Download and Installing
We tested !Emergo in Eclipse 3.6 SR2. Before installing Emergo, please install the [[http://www.eclipse.org/gef/zest/][Zest plugin]]. Zest contains a graph layout package which we use to generate emergent interfaces based on graphs. Afterwards, all you need to do is to place [[http://www.cin.ufpe.br/~mmr3/emergo/Emergo_-_EI_1.0.0.201202061829.jar][the Emergo jar file]] into the plugins folder of your Eclipse. Please, notice that !Emergo is a *prototype*. We will be glad to hear from you any suggestions and bug reports.

---------------------------------------------------------------------------------------------------------------------
---++Getting started
After installing, open a Java project. The project must contain an _ifdef.txt_ file in the root folder. This file contains the list of features and the feature model of the product line. Here is an [[http://twiki.cin.ufpe.br/twiki/bin/viewfile/SPG/Emergo?rev=1;filename=JCalc.zip][example]] of a product line that you can use to test !Emergo.

---++++Views
Emergent interfaces can be visualized by using two views: based on a table or on a graph. Before trying to generate emergent interfaces, open these views. To do so, *Window -> Show View -> Other -> Emergo Views*. Open the *Emergo Table View* and the *Emergo Graph View*.

 <img src="%ATTACHURL%/Emergo-Views.png" alt="Emergo views" />

---++++Properties
After opening the views, select the type of analysis that will be used for generating the interfaces. There are two types of analyses available: intraprocedural and interprocedural. Open the project properties (right click on the project, *Properties -> Emergo*).

The Intraprocedural analysis computes feature dependencies exclusively within the method where the selection occurred. Interprocedural analysis computes dependencies from the method where the selection occurred and other methods. Depending on the product line size (number of lines of code, number of methods, number of features etc), when computing emergent interfaces using the Interprocedural analysis, !Emergo can take *several minutes* to finish the computation.

 <img src="%ATTACHURL%/Emergo-Properties.png" alt="Emergo views" />

---++++Generating Emergent Interfaces
To generate emergent interfaces, the first step consists of selecting the maintenance point. After selecting, you can either press Ctrl+9 or right click on the editor, then *Emergo -> Generate Interface*. The results will appear in both *Emergo Table View* and *Emergo Graph View*.

 <img src="%ATTACHURL%/Emergo-Menu.png" alt="Emergo menu" />

<!--
---++++Selecting more than one maintenance point
To generate interfaces based on more than one maintenance point, you should select the source lines that represent the maintenance points. To do so, select each line at a time, right click on the editor, then *Emergo -> Select Line*. The selected lines will appear in the *Selected Lines* view. Then, right click on the editor, *Emergo -> Generate Interface from Selected Lines*.

 <img src="%ATTACHURL%/Emergo-Selected-Lines.png" alt="Emergo view for the selected lines" />

-->

---------------------------------------------------------------------------------------------------------------------
---++Publications
%BIBTEX{web="SPG" topic="Emergo" style="html" bibfile="emergent-interfaces.bib" }%

---------------------------------------------------------------------------------------------------------------------
---++Contacts
   * [[mailto:mmr3@cin.ufpe.br][Márcio Ribeiro]]
   * [[mailto:twt@cin.ufpe.br][Társis Tolêdo]]
   * [[mailto:brabrand@itu.dk][Claus Brabrand]]
   * [[mailto:phmb@cin.ufpe.br][Paulo Borba]]
   * [[mailto:jw@cs.au.dk][Johnni Winther]]

-- Main.MarcioRibeiro - 07 Feb 2012
-- Main.MarcioRibeiro - 05 Feb 2012
-- Main.MarcioRibeiro - 22 Sep 2011
Topic revision: r6 - 2012-02-07 - MarcioRibeiro