Session Import and Export
While EclEmma is primarily designed for test runs and analysis within the Eclipse workbench, it provides import and export functionality.
Session Import
If your program is launched outside the Eclipse debugging environment, you
might import JaCoCo coverage files (*.exec) from these launches.
This allows to study the coverage results directly in your source code.
The Coverage Session import wizard can be activated form the
File → Import... menu or from the Coverage view's context
menu.
The wizard dialog requires you to specify the following information:
- Name of the imported session
- Coverage (
*.ec) or session file (*.es) - Source folders or libraries that should be considered
If you keep a reference to the original coverage file (check the corresponding
import option) you can simply reload the coverage data after a new program
run. For this use the Refresh option from the context menu of the
Coverage view or simply hit the F5 key.
Warning: Imported execution data must be based on the exact same class files that are also used within the Eclipse IDE. If the external launch was based on different class files (e.g. created with different compiler) no coverage will be shown.
Session Export
The session export wizard allows to export coverage sessions in one of these formats:
- HTML: A detailed and browseable report as a set of HTML files.
- Zipped HTML: Same as above but zipped into a single file.
- XML: Coverage data as a single, structured XML file.
- CSV: Coverage data on class level granularity as comma-separated values.
- Execution data file: Native JaCoCo execution data format.
The Coverage Report export wizard can be activated form the File → Export... menu or from the Coverage view's context menu. There must be at least one coverage session available to use the export wizard.
Select one of the existing sessions and the export format.