-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathimportexport.html
171 lines (171 loc) · 9.58 KB
/
importexport.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta name="date" content="2017-06-13 22:24:59 +0200" />
<link rel="stylesheet" href="../book.css" type="text/css" />
<link rel="shortcut icon" href="../favicon.ico" type="image/x-icon" />
<title>EclEmma - Session Import and Export</title>
</head>
<body>
<table cellspacing="0" cellpadding="0" border="0" style="width:100%;">
<tr>
<td style="padding:5px 10px 5px 10px;font-size:16pt;font-weight:bold;color:#000066;background-color:#f7f7f7;border:1px solid #a5b6c6;">
EclEmma <span style="color:#8998a5;">3.1.9</span>
</td>
<td style="padding:5px 10px 5px 10px;font-size:16pt;font-weight:bold;color:#8998a5;border-bottom:1px solid #a5b6c6;">
Java Code Coverage for Eclipse
</td>
<td style="padding:0px 0px 0px 0px;border-bottom:1px solid #a5b6c6;text-align:right">
<a href="https://marketplace.eclipse.org/marketplace-client-intro?mpc_install=264" title="Drag to your running Eclipse workspace to install EclEmma Java Code Coverage">
<img src="https://marketplace.eclipse.org/modules/custom/eclipsefdn/eclipsefdn_marketplace/images/btn-install.svg" alt="Drag to your running Eclipse workspace to install EclEmma Java Code Coverage" style="vertical-align:text-bottom; border:0px solid black" />
</a>
</td>
</tr>
<tr><td style="vertical-align:top;padding:20px 10px 20px 10px;background-color:#f7f7f7;border-left:1px solid #a5b6c6;border-right:1px solid #a5b6c6;border-bottom:1px solid #a5b6c6;">
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:0px;">
<a href="../index.html">Overview</a>
</div>
<div class="menu" style="background-image:url(../images/container.gif);margin-left:0px;">
<a href="../installation.html">Installation</a>
</div>
<div class="menu" style="background-image:url(../images/container.gif);margin-left:0px;">
<a href="index.html">User Guide</a>
</div>
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:16px;">
<a href="launching.html">Launching in Coverage Mode</a>
</div>
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:16px;">
<a href="coverageview.html">Using the Coverage View</a>
</div>
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:16px;">
<a href="annotations.html">Source Code Annotations</a>
</div>
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:16px;">
<a href="coverageproperties.html">Coverage Properties</a>
</div>
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:16px;">
<a href="decorators.html">Decorators</a>
</div>
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:16px;">
<a href="sessions.html">Managing Coverage Sessions</a>
</div>
<div class="menuhi" style="background-image:url(../images/topic.gif);margin-left:16px;">
<a href="importexport.html">Session Import and Export</a>
</div>
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:16px;">
<a href="keyboard.html">Keyboard Usage</a>
</div>
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:16px;">
<a href="preferences.html">Preferences</a>
</div>
<div class="menu" style="background-image:url(../images/container.gif);margin-left:0px;">
<a href="../support.html">Support</a>
</div>
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:0px;">
<a href="../resources.html">Resources</a>
</div>
<div class="menu" style="background-image:url(../images/container.gif);margin-left:0px;">
<a href="../devdoc/index.html">Developer Information</a>
</div>
<div class="menu" style="background-image:url(../images/container.gif);margin-left:0px;">
<a href="../research/index.html">Research</a>
</div>
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:0px;">
<a href="../jacoco/index.html">JaCoCo</a>
</div>
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:0px;">
<a href="../changes.html">Change Log</a>
</div>
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:0px;">
<a href="../license.html">License</a>
</div>
<div class="menu" style="background-image:url(../images/topic.gif);margin-left:0px;">
<a href="../contact.html">Contact</a>
</div>
<div class="menu" style="margin-top:15pt;background-image:url(../images/extern.gif)">
<a href="https://github.com/jacoco">GitHub Home</a>
</div>
<div style="text-align:center;margin-top:0pt;">
<a href="http://www.eclipse.org/org/press-release/20080318_AwardsWinners.php"><img src="../images/award.jpg" width="144" height="120" alt="Eclipse Community Award 2008" style="border:0px solid black" /></a>
</div>
<div style="text-align:center;margin-top:10pt;">
<a href="http://www.jacoco.org/jacoco"><img src="../images/jacoco.png" height="62" width="140" alt="JaCoCo" style="border:0px solid black" /></a>
</div>
<div style="text-align:center;margin-top:10pt;">
<a href="http://www.sonarqube.org/"><img src="../images/sonarqube.png" height="40" width="140" alt="Inspected with sonarqube" style="border:0px solid black" /></a>
</div>
<div style="text-align:center;margin-top:10pt;padding-top:15px;border-top:1px solid #a0a0a0">
<a href="https://www.mtrail.ch/en/career.html"><img src="../images/mtrail.png" width="140" height="200" alt="jobs at mtrail" style="border:0px solid black" /></a>
</div>
<div style="text-align:center;margin-top:10pt">
<a href="http://www.javaspecialists.eu/"><img src="../images/tjsn.jpg" width="140" height="140" alt="The Java Specialists' Newsletter" style="border:0px solid black" /></a>
</div>
</td><td style="vertical-align:top;padding:0px 0px 5px 20px;width:90%;border-bottom:1px solid #a5b6c6;" colspan="2">
<h2>Session Import and Export</h2><p>
While EclEmma is primarily designed for test runs and analysis within the
Eclipse workbench, it provides import and export functionality.
</p><h3>Session Import</h3><p>
If your program is launched outside the Eclipse debugging environment, you
might import JaCoCo execution data from these launches. This allows to study
the coverage results directly in your source code. The <i>Coverage Session</i>
import wizard can be activated form the <i>File → Import...</i> menu or
from the <i>Coverage</i> view's context menu.
</p><p>
The wizard dialog requires you to specify the source of the execution data on
its first page. There are three possible sources:
</p><ul>
<li>Local <code>*.exec</code> file location.</li>
<li>Remote <code>*.exec</code> file URL.</li>
<li>IP address and port of a
<a class="extern" href="http://www.jacoco.org/jacoco/trunk/doc/agent.html">JaCoCo agent</a>
attached to a running process. You can also specify whether the execution
data should be reset in the target VM when dumping the data.</li>
</ul><p>
If you keep a reference to the original execution data source (check the
corresponding import option) you can simply re-import the data as often as you
want. For this use the <i>Refresh</i> option from the context menu of the
<i>Coverage</i> view or simply hit the <code>F5</code> key.
</p><p>
On the second page you can specify session name and the scope, which are the
source folders and libraries that should be considered.
</p><p>
<b>Warning:</b> 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.
</p><h3>Session Export</h3><p>
The session export wizard allows to export coverage sessions in one of these
formats:
</p><ul>
<li><b>HTML:</b> A detailed and browseable report as a set of HTML
files.</li>
<li><b>Zipped HTML:</b> Same as above but zipped into a single file.</li>
<li><b>XML:</b> Coverage data as a single, structured XML file.</li>
<li><b>CSV:</b> Coverage data on class level granularity as comma-separated
values.</li>
<li><b>Execution data file:</b> Native JaCoCo execution data format.</li>
</ul><p>
The <i>Coverage Session</i> export wizard can be activated form the
<i>File → Export...</i> menu or from the <i>Coverage</i> view's context
menu. There must be at least one coverage session available to use the export
wizard.
</p><p>
Select one of the existing sessions and the export format.
</p>
</td></tr>
</table>
<table cellspacing="0" cellpadding="0" border="0" style="width:100%;">
<tr>
<td class="footer"><a href="../license.html">Copyright</a> © 2006, 2017 Mountainminds GmbH & Co. KG and Contributors</td>
<td class="footer" style="text-align:right;">
Validate
<a href="http://validator.w3.org/check?uri=http://www.eclemma.org/userdoc/importexport.html">XHTML</a>/<a href="http://jigsaw.w3.org/css-validator/validator?uri=http://www.eclemma.org/userdoc/importexport.html">CSS</a> ·
Last Modified
<a href="https://github.com/jacoco/eclemma/blob/4b213d2a7d26640ee877be662b91d662bdcb074e/org.eclipse.eclemma.doc/pages/importexport.html">2017-06-13</a> in Commit
<a href="https://github.com/jacoco/eclemma/commit/4b213d2a7d26640ee877be662b91d662bdcb074e">4b213d2a</a>
</td>
</tr>
</table>
</body>
</html>