Skip to content

Commit 9bc13ad

Browse files
Update sitedocs for branch main
1 parent 2da13cc commit 9bc13ad

File tree

283 files changed

+355
-1
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

283 files changed

+355
-1
lines changed

doc/main/BndBuild.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@
5858
</ul></li>
5959
<li><a href="TestingBundles.html"><span class="icon-chevron-down"></span>Testing Bundles</a>
6060
<ul class="nav nav-list">
61+
<li><a href="tycho-test-plugin/plugin-info.html">Tycho Test Plugin</a></li>
6162
<li><a href="tycho-surefire-plugin/plugin-info.html">Tycho Surefire Plugin</a></li>
6263
</ul></li>
6364
<li><a href="TychoCiFriendly.html">Tycho CI Friendly Versions</a></li>

doc/main/BuildProperties.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@
5858
</ul></li>
5959
<li><a href="TestingBundles.html"><span class="icon-chevron-down"></span>Testing Bundles</a>
6060
<ul class="nav nav-list">
61+
<li><a href="tycho-test-plugin/plugin-info.html">Tycho Test Plugin</a></li>
6162
<li><a href="tycho-surefire-plugin/plugin-info.html">Tycho Surefire Plugin</a></li>
6263
</ul></li>
6364
<li><a href="TychoCiFriendly.html">Tycho CI Friendly Versions</a></li>

doc/main/Category.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@
5858
</ul></li>
5959
<li><a href="TestingBundles.html"><span class="icon-chevron-down"></span>Testing Bundles</a>
6060
<ul class="nav nav-list">
61+
<li><a href="tycho-test-plugin/plugin-info.html">Tycho Test Plugin</a></li>
6162
<li><a href="tycho-surefire-plugin/plugin-info.html">Tycho Surefire Plugin</a></li>
6263
</ul></li>
6364
<li><a href="TychoCiFriendly.html">Tycho CI Friendly Versions</a></li>

doc/main/PackagingTypes.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@
5858
</ul></li>
5959
<li><a href="TestingBundles.html"><span class="icon-chevron-down"></span>Testing Bundles</a>
6060
<ul class="nav nav-list">
61+
<li><a href="tycho-test-plugin/plugin-info.html">Tycho Test Plugin</a></li>
6162
<li><a href="tycho-surefire-plugin/plugin-info.html">Tycho Surefire Plugin</a></li>
6263
</ul></li>
6364
<li><a href="TychoCiFriendly.html">Tycho CI Friendly Versions</a></li>

doc/main/SBOM.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@
5858
</ul></li>
5959
<li><a href="TestingBundles.html"><span class="icon-chevron-down"></span>Testing Bundles</a>
6060
<ul class="nav nav-list">
61+
<li><a href="tycho-test-plugin/plugin-info.html">Tycho Test Plugin</a></li>
6162
<li><a href="tycho-surefire-plugin/plugin-info.html">Tycho Surefire Plugin</a></li>
6263
</ul></li>
6364
<li><a href="TychoCiFriendly.html">Tycho CI Friendly Versions</a></li>

doc/main/SignProducts.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@
5858
</ul></li>
5959
<li><a href="TestingBundles.html"><span class="icon-chevron-down"></span>Testing Bundles</a>
6060
<ul class="nav nav-list">
61+
<li><a href="tycho-test-plugin/plugin-info.html">Tycho Test Plugin</a></li>
6162
<li><a href="tycho-surefire-plugin/plugin-info.html">Tycho Surefire Plugin</a></li>
6263
</ul></li>
6364
<li><a href="TychoCiFriendly.html">Tycho CI Friendly Versions</a></li>

doc/main/StructuredBuild.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@
5858
</ul></li>
5959
<li><a href="TestingBundles.html"><span class="icon-chevron-down"></span>Testing Bundles</a>
6060
<ul class="nav nav-list">
61+
<li><a href="tycho-test-plugin/plugin-info.html">Tycho Test Plugin</a></li>
6162
<li><a href="tycho-surefire-plugin/plugin-info.html">Tycho Surefire Plugin</a></li>
6263
</ul></li>
6364
<li><a href="TychoCiFriendly.html">Tycho CI Friendly Versions</a></li>

doc/main/SystemProperties.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@
5858
</ul></li>
5959
<li><a href="TestingBundles.html"><span class="icon-chevron-down"></span>Testing Bundles</a>
6060
<ul class="nav nav-list">
61+
<li><a href="tycho-test-plugin/plugin-info.html">Tycho Test Plugin</a></li>
6162
<li><a href="tycho-surefire-plugin/plugin-info.html">Tycho Surefire Plugin</a></li>
6263
</ul></li>
6364
<li><a href="TychoCiFriendly.html">Tycho CI Friendly Versions</a></li>

doc/main/TargetPlatform.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@
5858
</ul></li>
5959
<li><a href="TestingBundles.html"><span class="icon-chevron-down"></span>Testing Bundles</a>
6060
<ul class="nav nav-list">
61+
<li><a href="tycho-test-plugin/plugin-info.html">Tycho Test Plugin</a></li>
6162
<li><a href="tycho-surefire-plugin/plugin-info.html">Tycho Surefire Plugin</a></li>
6263
</ul></li>
6364
<li><a href="TychoCiFriendly.html">Tycho CI Friendly Versions</a></li>

doc/main/TestingBundles.html

Lines changed: 73 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,7 @@
5858
</ul></li>
5959
<li class="active"><a><span class="icon-chevron-down"></span>Testing Bundles</a>
6060
<ul class="nav nav-list">
61+
<li><a href="tycho-test-plugin/plugin-info.html">Tycho Test Plugin</a></li>
6162
<li><a href="tycho-surefire-plugin/plugin-info.html">Tycho Surefire Plugin</a></li>
6263
</ul></li>
6364
<li><a href="TychoCiFriendly.html">Tycho CI Friendly Versions</a></li>
@@ -231,7 +232,78 @@ <h2>bnd-testing</h2>
231232
to automatically inject services:</p></li>
232233
<li>
233234
<p><a href="https://github.com/eclipse-tycho/tycho/tree/master/demo/testing/bnd/osgi-test" class="externalLink">https://github.com/eclipse-tycho/tycho/tree/master/demo/testing/bnd/osgi-test</a></p></li>
234-
</ul></section><section><a id="combining_different_approaches"></a>
235+
</ul></section><section><a id="tycho-test-plugin"></a>
236+
<h2>tycho-test-plugin</h2>
237+
<p>The <a href="https://tycho.eclipseprojects.io/doc/master/tycho-test-plugin/plugin-info.html" class="externalLink">tycho-test-plugin</a> is a new plugin introduced in Tycho 6 to provide unified testing of OSGi bundles.
238+
Unlike previous approaches, it is no longer bound to surefire and offers better integration with modern testing frameworks.</p><section><a id="junit-platform_mojo"></a>
239+
<h3>junit-platform mojo</h3>
240+
<p>The <code>tycho-test:junit-platform</code> mojo integrates the <a href="https://docs.junit.org/current/user-guide/#running-tests-console-launcher" class="externalLink">JUnit Platform Console Launcher</a> into any OSGi Framework.
241+
This approach has several advantages:</p>
242+
<ol style="list-style-type: decimal;">
243+
244+
<li>Tycho is completely independent from the used JUnit framework version (since it calls it via a command-line interface)</li>
245+
<li>Better and more natural integration of selecting test engines in the pom.xml or with the target platform</li>
246+
<li>You can use any of the JUnit provided test engines or new features that might be added</li>
247+
</ol>
248+
<p>This requires:</p>
249+
<ul>
250+
251+
<li>packaging <code>eclipse-plugin</code> is used</li>
252+
<li>a configured execution of the <code>tycho-test:junit-platform</code> goal</li>
253+
<li>JUnit Platform dependencies (console launcher and test engines) as test-scoped dependencies</li>
254+
</ul>
255+
<p>A sample snippet looks like this:</p>
256+
257+
<pre class="prettyprint linenums"><code class="language-xml">&lt;project xmlns=&quot;http://maven.apache.org/POM/4.0.0&quot; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;
258+
xsi:schemaLocation=&quot;http://maven.apache.org/POM/4.0.0 https://maven.apache.org/maven-v4_0_0.xsd&quot;&gt;
259+
...
260+
&lt;build&gt;
261+
...
262+
&lt;plugin&gt;
263+
&lt;groupId&gt;org.eclipse.tycho&lt;/groupId&gt;
264+
&lt;artifactId&gt;tycho-test-plugin&lt;/artifactId&gt;
265+
&lt;version&gt;${tycho-version}&lt;/version&gt;
266+
&lt;executions&gt;
267+
&lt;execution&gt;
268+
&lt;id&gt;execute-tests&lt;/id&gt;
269+
&lt;goals&gt;
270+
&lt;goal&gt;junit-platform&lt;/goal&gt;
271+
&lt;/goals&gt;
272+
&lt;/execution&gt;
273+
&lt;/executions&gt;
274+
&lt;/plugin&gt;
275+
&lt;/build&gt;
276+
277+
&lt;dependencies&gt;
278+
&lt;!-- The API is used at compile time of the bundle --&gt;
279+
&lt;dependency&gt;
280+
&lt;groupId&gt;org.junit.jupiter&lt;/groupId&gt;
281+
&lt;artifactId&gt;junit-jupiter-api&lt;/artifactId&gt;
282+
&lt;version&gt;${junit-version}&lt;/version&gt;
283+
&lt;scope&gt;compile&lt;/scope&gt;
284+
&lt;/dependency&gt;
285+
286+
&lt;!-- The console and the engine are only required at test execution time --&gt;
287+
&lt;dependency&gt;
288+
&lt;groupId&gt;org.junit.platform&lt;/groupId&gt;
289+
&lt;artifactId&gt;junit-platform-console&lt;/artifactId&gt;
290+
&lt;version&gt;${junit-version}&lt;/version&gt;
291+
&lt;scope&gt;test&lt;/scope&gt;
292+
&lt;/dependency&gt;
293+
&lt;dependency&gt;
294+
&lt;groupId&gt;org.junit.jupiter&lt;/groupId&gt;
295+
&lt;artifactId&gt;junit-jupiter-engine&lt;/artifactId&gt;
296+
&lt;version&gt;${junit-version}&lt;/version&gt;
297+
&lt;scope&gt;test&lt;/scope&gt;
298+
&lt;/dependency&gt;
299+
&lt;/dependencies&gt;
300+
&lt;/project&gt;
301+
</code></pre>
302+
<p>To execute the tests, one has to invoke maven with <code>mvn verify</code>. The following demo project is provided as an example:</p>
303+
<ul>
304+
305+
<li><a href="https://github.com/eclipse-tycho/tycho/tree/master/demo/testing/junit-platform" class="externalLink">https://github.com/eclipse-tycho/tycho/tree/master/demo/testing/junit-platform</a></li>
306+
</ul></section></section><section><a id="combining_different_approaches"></a>
235307
<h2>combining different approaches</h2></section><section><a id="setup_test_source_folders_in_eclipse"></a>
236308
<h2>setup test source folders in eclipse</h2></section></section> </main>
237309
</div>

0 commit comments

Comments
 (0)