Update the manual to reflect changes to features packaging made for
@@ -55,10 +55,10 @@ Then specify the packaging in your project as usual, e.g.
|Packaging |Description
|feature
-|The feature packaging generates a features.xml descriptor using the `karaf:features-generate-descriptor`
+|The feature packaging verifies a features.xml descriptor using the `karaf:verify` goal.
|kar
-|The kar packaging generates a features.xml descriptor using the `karaf:features-generate-descriptor` and then packages a kar using the `karaf:features-create-kar`
+|The kar packaging generates a features.xml descriptor using the `karaf:features-generate-descriptor` and then packages a kar using the `karaf:features-create-kar` goal.
|karaf-assembly
|Assembles a Karaf server based on the features descriptors and kar files listed as Maven dependencies.
@@ -135,8 +135,6 @@ The `karaf-maven-plugin` provides several goals to help you create and verify fe
===== `karaf:features-generate-descriptor`
-Except in unusual circumstances, use the `<packaging>feature</packaging>` to run this goal.
-
The `karaf:features-generate-descriptor` goal generates a features XML file based on the Maven dependencies.
By default, it will follow Maven transitive dependencies, stopping when it encounters bundles already present in features that are Maven dependencies.
@@ -210,9 +208,17 @@ This can be overridden by specifying the bundle in the source feature.xml with t
<version>${project.version}</version>
<extensions>true</extensions>
<configuration>
- <startLevel>80</startLevel>
- <aggregateFeatures>true</aggregateFeatures>
+ <enableGeneration>true</enableGeneration>
</configuration>
+ <executions>
+ <execution>
+ <id>generate-features-file</id>
+ <phase>generate-resources</phase>
+ <goals>
+ <goal>features-generate-descriptor</goal>
+ </goals>
+ </execution>
+ </executions>
</plugin>
</plugins>
</build>
@@ -221,6 +227,8 @@ This can be overridden by specifying the bundle in the source feature.xml with t
===== `karaf:verify`
+Except in unusual circumstances, use the `<packaging>feature</packaging>` to run this goal.
+
The `karaf:verify` goal verifies and validates a features XML descriptor by checking if all the required imports
for the bundles defined in the features can be matched to a provided export.
