commit | bc0e2858cb464e7dea5b0262f5594050717a2219 | [log] [tgz] |
---|---|---|
author | David Bosschaert <bosschae@adobe.com> | Fri Aug 20 09:28:37 2021 +0100 |
committer | David Bosschaert <bosschae@adobe.com> | Fri Aug 20 09:28:37 2021 +0100 |
tree | da8256f52cddf7f99872282dc6338f67aa064abb | |
parent | ff547699700993f5ec35d48123ceb2352716e64e [diff] |
[maven-release-plugin] prepare release org.apache.sling.feature.analyser-1.3.32
The Analyser can analyse features for completeness and correctness. The analyser is pluggable and can perform custom checks.
The Analyser can also be run as part of a Maven build via the slingfeature-maven-plugin
The analyser can be run from the commandline by running the following main class:
java org.apache.sling.feature.analyser.main.Main
Below is a list of built-in analysers. Additional analysers in relation to Feature Model API Regions can be found here: org-apache-sling-feature-extension-apiregions
For further documentation see: Feature Model
apis-jar
This analyser task validates the metadata in the feature model for the apis-jar
goal of the slingfeature-maven-plugin.
bundle-connect
Checks whether the feature is ready for OSGi connect. Bundle with embedded jars are not allowed and packages between bundles must not overlap.
bundle-content
Gives a warning if a bundle contains initial content specified with Sling-Initial-Content
.
bundle-nativecode
Checks for native code instructions in bundles and errors if found.
bundle-packages
Checks bundle import/export package statements for consistency and completeness. Does not take API Regions into account. An expanded variant of this analyser is available in org-apache-sling-feature-extension-apiregions under the name api-regions-exportsimports
.
bundle-resources
Gives a warning if a bundle contains resources specified with Sling-Bundle-Resources
.
check-unused-bundles
Checks for unused bundles, bundles with exports which are not imported.
compare-features
Compares the artifacts in the bundles sections or in an extension between two feature models.
This analyser requires additional configuration:
Configuration key | Allowed values | Description |
---|---|---|
compare-type | ARTIFACTS | The types of entities being compared. Currently only artifacts can be compared. |
compare-with | Maven ID, e.g. mygroup:myart:1.2.3 | The golden feature to compare the features selected for the analyser with. |
compare-extension | extension name | If this configuration is absent, the feature's bundles are compared. Otherwise the extensions with the specified name are compared. These extensions must be of type ARTIFACTS . |
compare-mode | SAME or DIFFERENT | Whether the sections must be the same or must be different. Defaults to SAME . |
compare-metadata | true or false | Whether to include the artifact metadata in the comparison. Defaults to false . |
content-packages-dependencies
Checks the dependencies between content packages.
content-packages-installables
Checks that content packages do not contain installables for the OSGi installer like bundles or configurations.
content-packages-paths
This analyser checks for allowed and denied paths inside content packages. This analyser requires additional configuration:
Configuration key | Allowed values | Description |
---|---|---|
includes | Content paths | A comma separated list of content paths. If this is specified all content in the content package must match at least one of these. |
excludes | Content paths | A comma separated list of content paths. If this is specified all content in the content package must not match any of these - except it matches an include. |
duplicate-symbolic-names
Checks if there are duplicates of symbolic names for bundles.
feature-id
This analyser checks that the feature id matches one of the given accepted feature ids. If it doesn't it will emit an error.
This analyser requires additional configuration:
Configuration key | Allowed values | Description |
---|---|---|
accepted-feature-ids | comma-separated list of Maven IDs | The Maven ID/coordinates have the format groupId:artifactId[:packaging[:classifier]]:version . Each item is either a string which must be equal to the according item of the feature id, or a * which acts as wildcard (i.e. everything matches). |
repoinit
Checks the syntax of all repoinit sections.
requirements-capabilities
Checks bundle requirements/capabilities for consistency and completeness.