Antenna scans artifacts of a project, downloads sources for dependencies, validates sources and licenses and creates:
- a third-party attribution document that lists all dependencies with their licenses,
- a sources.zip containing all sources of the dependencies, and
- a processing report.
Learn more about Antenna in What Antenna Does.
Or visit us on our Eclipse Project Site for the latest news of the project.
If you want to contribute to Antenna, please check out the Contribution guidlines.
The Antenna project consists of a core and multiple modules in ./modules, which encapsulate related functionality.
Some of these folders contain their own README.md, like e.g. ./modules/sw360/README.md which contain module specific information.
Please note that some dependencies of SW360antenna are only available for Java 8. So you need to use Java 8 to build the project.
If you want to build Antenna on the command line, just use Maven like
$ mvn install
By default, this will run tests. If you want to skip running tests use
$ mvn install -DskipTests
The build is stable starting with Maven version 3.5.x or higher, which was
when the usage of the revision property was introduced.
With a lower version you will get errors when trying to resolve dependencies created in the Antenna build,
since the version is not correctly parsed. A possible error message would look like this:
Failed to process POM for org.eclipse.sw360.antenna:model:jar:1.0.0-SNAPSHOT:
Non-resolvable parent POM for org.eclipse.sw360.antenna:model:1.0.0-SNAPSHOT:
Could not find artifact org.eclipse.sw360.antenna:antenna-management:pom:${revision}
in central (https://repo.maven.apache.org/maven2/) and 'parent.relativePath' points at wrong local POM
[ERROR] org.eclipse.sw360.antenna:model:jar:1.0.0-SNAPSHOT
You can activate the following optional profiles:
-P integration-test: activates also the optional profile for integration testing in the sw360 module (see also./modules/sw360/README.md)-P site-tests: which activates the site tests in./documentation/
Antenna can be used as a Maven plugin, with Gradle or standalone executable.
As a maven plugin, Antenna's behaviour is configured by adding a <plugin> to your project's pom.xml file and adding settings to the <configuration> section.
Similarly, in Gradle, the same Maven files must be given and the build.gradle file needs to include the Antenna configuration.
As a standalone executable, Antenna is configured as an executable jar in the command line.
Find out how to configure Antenna by reading: How to configure Antenna.
Antenna can be used with Java versions 9 or newer. However, it requires some additional configuration described in Tool Configuration.
To find answers in the most frequent questions/problems go to Troubleshooting.
For more information please refer to our documentation.