blob: 5764a3c90f49bf0a63a17294acb8bf59bee6a11c (
plain)
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
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
|
<?xml version="1.0" encoding="UTF-8" ?>
<!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" />
<link rel="stylesheet" href="resources/doc.css" charset="UTF-8" type="text/css" />
<link rel="stylesheet" href="../coverage/jacoco-resources/prettify.css" charset="UTF-8" type="text/css" />
<link rel="shortcut icon" href="resources/report.gif" type="image/gif" />
<style>
table, th, td {
border-collapse: collapse;
padding: 3px;
}
table tbody tr td {
border-left: #b0b0b0 3px solid;
}
table tbody tr td:nth-child(2) {
border-left: none;
}
th {
background-color:#e0e0e0;
}
table tbody td:hover {
background: #f0f0d0;
}
</style>
<script type="text/javascript" src="../coverage/jacoco-resources/prettify.js"></script>
<title>JaCoCo - Build</title>
</head>
<body onload="prettyPrint()">
<div class="breadcrumb">
<a href="../index.html" class="el_report">JaCoCo</a> >
<a href="index.html" class="el_group">Documentation</a> >
<span class="el_source">Build</span>
</div>
<div id="content">
<h1>Build</h1>
<p>
The JaCoCo build is based on <a href="http://maven.apache.org/">Maven</a> and
can be locally executed on every machine with a proper
<a href="environment.html">environment setup</a>. In particular you need at
least <a href="http://maven.apache.org/">Maven 3.3.9</a> and JDK 8
installations. Developers are encouraged to run the build before every commit
to ensure consistency of the source tree.
</p>
<h2>Running the Build</h2>
<p>
The build can be started by executing the following command with
<code>./org.jacoco.build/</code> as the working directory:
</p>
<pre>
mvn clean install
</pre>
<p>
Total build time is typically around 3 minutes, however first build might take
more time, because Maven should download plugins and dependencies. The
download ZIP will be created at the following location:
</p>
<pre>
./jacoco/target/jacoco-<i>x.y.z.qualifier</i>.zip
</pre>
<h2>Running Quick Build without Tests</h2>
<p>
It is not recommended, however possible to the run build without any tests:
</p>
<pre>
mvn clean install -DskipTests
</pre>
<h2>Compilation and testing with different JDKs</h2>
<p>
By default for compilation and execution of tests will be used JDK that runs
Maven. Alternatively you can use JDK from
<a href="http://maven.apache.org/guides/mini/guide-using-toolchains.html">Maven
Toolchains</a> by setting property <code>jdk.version</code>.
</p>
<p>
Following table shows how modules will be compiled depending on version of JDK:
</p>
<table>
<thead>
<tr>
<th></th>
<th>JDK 5</th>
<th>JDK 6</th>
<th>JDK 7</th>
<th>JDK 8</th>
<th>JDK 9</th>
<th>JDK 10</th>
<th>JDK 11</th>
<th>JDK 12</th>
</tr>
</thead>
<tbody>
<tr>
<th>org.jacoco.core.test.validation.java8</th>
<td colspan="3">excluded from build</td>
<td colspan="5">compiled into bytecode version 52 (Java 8)</td>
</tr>
<tr>
<th>org.jacoco.core.test.validation.java7</th>
<td colspan="2">excluded from build</td>
<td colspan="6" rowspan="2">compiled into bytecode version 51 (Java 7)</td>
</tr>
<tr>
<th>org.jacoco.core.test.validation.groovy</th>
<td colspan="2">excluded from build</td>
</tr>
<tr>
<th>org.jacoco.core.test.validation.kotlin</th>
<td colspan="1">excluded from build</td>
<td colspan="6">compiled into bytecode version 50 (Java 6)</td>
<td rowspan="2">compiled into bytecode version 51 (Java 7)</td>
</tr>
<tr>
<th>all other modules</th>
<td colspan="4">compiled into bytecode version 49 (Java 5)</td>
<td colspan="3">compiled into bytecode version 50 (Java 6)</td>
</tr>
</tbody>
</table>
<p>
Alternatively you can specify bytecode version for all modules using property
<code>bytecode.version</code>.
</p>
<p>
For example to use JDK 10 from Maven Toolchains and compile all modules
into bytecode version 53 (Java 9):
</p>
<pre>
mvn clean install -Djdk.version=10 -Dbytecode.version=9
</pre>
<p>
Also Eclipse Compiler for Java can be used for compilation:
</p>
<pre>
mvn clean install -Decj
</pre>
<p>
Combining these options JaCoCo is regularly tested with the following setups:
</p>
<ul>
<li><code>mvn clean install -Djdk.version=5 -Dbytecode.version=5</code></li>
<li><code>mvn clean install -Djdk.version=6 -Dbytecode.version=6</code></li>
<li><code>mvn clean install -Djdk.version=7 -Dbytecode.version=7</code></li>
<li><code>mvn clean install -Djdk.version=8 -Dbytecode.version=8</code></li>
<li><code>mvn clean install -Djdk.version=8 -Dbytecode.version=8 -Decj</code></li>
<li><code>mvn clean install -Djdk.version=9 -Dbytecode.version=9</code></li>
<li><code>mvn clean install -Djdk.version=10 -Dbytecode.version=10</code></li>
<li><code>mvn clean install -Djdk.version=11 -Dbytecode.version=11</code></li>
<li><code>mvn clean install -Djdk.version=12 -Dbytecode.version=12</code></li>
</ul>
</div>
<div class="footer">
<span class="right"><a href="@jacoco.home.url@">JaCoCo</a> @qualified.bundle.version@</span>
<a href="license.html">Copyright</a> © @copyright.years@ Mountainminds GmbH & Co. KG and Contributors
</div>
</body>
</html>
|
