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 EMMA coverage (*.ec) or session files
(*.es) 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.
Coverage analysis is based on runtime coverage data plus so called Meta data derived from the corresponding class files. For the import you can select whether the Meta data should be taken from the imported EMMA session file or from the classes compiled locally within your workbench.
Warning: If the Meta data and runtime coverage data are not based on the same class files, no or improper coverage information will be visualized.
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.
- XML: Coverage data as a single, structured XML file.
- Plain text: Limited coverage information as a plain text document.
- EMMA coverage file: Coverage file as used internally by EMMA.
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. Note that in any case the specified destination must point to a file in an existing folder.