Apache Sling OSGi Feature Maven Plugin

slingfeature:apis-jar

Full name:

org.apache.sling:slingfeature-maven-plugin:1.1.20:apis-jar

Description:

Generates the APIs JARs for each selected Feature file.

Attributes:

Requires a Maven project to be executed.
Requires dependency resolution of artifacts in scope: test.
Binds by default to the lifecycle phase: package.

Required Parameters

Name	Type	Since	Description
`<features>`	`File`	`-`	Directory containing feature files Default value is: `src/main/features`.
`<testFeatures>`	`File`	`-`	Directory containing test feature files. Default value is: `src/test/features`.

Optional Parameters

Name	Type	Since	Description
`<apiClassifierMappings>`	`Map`	`-`	Mapping for the feature classifier to a user defined name
`<apiJavadocResources>`	`List`	`-`	Additional resources for the api javadoc jar
`<apiRegionNameMappings>`	`Map`	`-`	Mapping for an api region name to a user defined name
`<apiResources>`	`List`	`-`	Additional resources for the api jar
`<apiSourceResources>`	`List`	`-`	Additional resources for the api source jar
`<attachApiJars>`	`boolean`	`-`	If enabled, the created api jars will be atttached to the project Default value is: `true`.
`<excludeRegions>`	`Set`	`-`	Names of the regions to exclude, by default no regions is excluded.
`<featuresExcludes>`	`String`	`-`	Comma separated list of excludes for the feature files. Feature files excluded by this configuration are not processed at all.
`<featuresIncludes>`	`String`	`-`	Comma separated list of includes for the feature files in the configured directory. Only feature files specified by this include are processed. Default value is: `*/.json`.
`<generateApiJar>`	`boolean`	`-`	Generate api jar Default value is: `true`.
`<generateJavadocJar>`	`boolean`	`-`	Generate the javadoc jar Default value is: `true`.
`<generateSourceJar>`	`boolean`	`-`	Generate the sources jar Default value is: `true`.
`<generatedFeatures>`	`File`	`-`	Directory containing generated feature files
`<generatedFeaturesExcludes>`	`String`	`-`	Comma separated list of excludes for the generated feature files. Feature files excluded by this configuration are not processed at all.
`<generatedFeaturesIncludes>`	`String`	`-`	Comma separated list of includes for the generated feature files in the configured directory. Only feature files specified by this include are processed. Default value is: `*/.json`.
`<ignoreJavadocErrors>`	`boolean`	`-`	Ignore errors in javadoc generation Default value is: `false`.
`<includeRegions>`	`Set`	`-`	Names of the regions to include, by default all regions are included. Default value is: `*`.
`<includeResources>`	`String[]`	`-`	Patterns identifying which resources to include from bundles
`<incrementalApis>`	`boolean`	`-`	If set to true and api jars are created for more than one region, then the higher region only gets the difference to the lower region. If set to false each api jar gets the full region information (duplicating information) Default value is: `true`.
`<jarStartOrder>`	`int`	`-`	The start level for the attached jar/bundle.
`<javadocLinks>`	`String[]`	`-`	List of javadoc links used in the javadoc generation.
`<javadocSourceLevel>`	`String`	`-`	(no description)
`<selection>`	`FeatureSelectionConfig`	`-`	Select the features for api generation.
`<skipAddFeatureDependencies>`	`boolean`	`-`	If set to `true` the artifacts from the feature are not as dependencies to the project. Default value is: `false`.
`<skipAddJarToFeature>`	`boolean`	`-`	If set to `true` the main jar artifact is not added to the feature. Default value is: `false`.
`<skipAddJarToTestFeature>`	`boolean`	`-`	If set to `true` the main jar artifact is not added to the test feature. Default value is: `false`.
`<skipAddTestFeatureDependencies>`	`boolean`	`-`	If set to `true` the artifacts from the test feature are not as dependencies to the project. Default value is: `true`.
`<testFeaturesExcludes>`	`String`	`-`	Comma separated list of excludes for the test features.
`<testFeaturesIncludes>`	`String`	`-`	Comma separated list of includes for the test features. Default value is: `*/.json`.
`<validateFeatures>`	`boolean`	`-`	If set to `true` the features are validated against the JSON schema. Default value is: `true`.

Parameter Details

<apiClassifierMappings>

Mapping for the feature classifier to a user defined name

Type: java.util.Map
Required: No

<apiJavadocResources>

Additional resources for the api javadoc jar

Type: java.util.List
Required: No

<apiRegionNameMappings>

Mapping for an api region name to a user defined name

Type: java.util.Map
Required: No

<apiResources>

Additional resources for the api jar

Type: java.util.List
Required: No

<apiSourceResources>

Additional resources for the api source jar

Type: java.util.List
Required: No

<attachApiJars>

If enabled, the created api jars will be atttached to the project

Type: boolean
Required: No
Default: true

<excludeRegions>

Names of the regions to exclude, by default no regions is excluded.

Type: java.util.Set
Required: No

<features>

Directory containing feature files

Type: java.io.File
Required: Yes
Default: src/main/features

<featuresExcludes>

Comma separated list of excludes for the feature files. Feature files excluded by this configuration are not processed at all.

Type: java.lang.String
Required: No

<featuresIncludes>

Comma separated list of includes for the feature files in the configured directory. Only feature files specified by this include are processed.

Type: java.lang.String
Required: No
Default: **/*.json

<generateApiJar>

Generate api jar

Type: boolean
Required: No
Default: true

<generateJavadocJar>

Generate the javadoc jar

Type: boolean
Required: No
Default: true

<generateSourceJar>

Generate the sources jar

Type: boolean
Required: No
Default: true

<generatedFeatures>

Directory containing generated feature files

Type: java.io.File
Required: No

<generatedFeaturesExcludes>

Comma separated list of excludes for the generated feature files. Feature files excluded by this configuration are not processed at all.

Type: java.lang.String
Required: No

<generatedFeaturesIncludes>

Comma separated list of includes for the generated feature files in the configured directory. Only feature files specified by this include are processed.

Type: java.lang.String
Required: No
Default: **/*.json

<ignoreJavadocErrors>

Ignore errors in javadoc generation

Type: boolean
Required: No
Default: false

<includeRegions>

Names of the regions to include, by default all regions are included.

Type: java.util.Set
Required: No
Default: *

<includeResources>

Patterns identifying which resources to include from bundles

Type: java.lang.String[]
Required: No

If set to true and api jars are created for more than one region, then the higher region only gets the difference to the lower region. If set to false each api jar gets the full region information (duplicating information)

Type: boolean
Required: No
Default: true