blob: 24d6e3e48b0c910ac23e3a735925571ebaf69770 [file] [log] [blame]
h2. Goal {{features:create-kar}}
The {{features:create-kar}} goal creates a kar file from a given features XML.
A kar file is a zip archive shipping all bundles and configuration files containing in features of a features XML, and the features XML itself.
You can deploy a kar file just by copying it in the deploy folder, all resources will be loaded from the kar file.
h3. Example
The example below generates a kar file from a given features XML. The generated kar will be in the target folder with the ${artifactId}-${version}.kar name.
{pygmentize:xml}
<project>
<build>
<plugins>
<plugin>
<groupId>org.apache.karaf.tooling</groupId>
<artifactId>features-maven-plugin</artifactId>
<version>${project.version}</version>
<executions>
<execution>
<id>create-kar</id>
<goals>
<goal>create-kar</goal>
</goals>
<configuration>
<featuresFile>${project.basedir}/src/main/resources/features.xml</featuresFile>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
{pygmentize}
h3. Parameters
|| Name || Type || Description ||
| {{featuresFile}} | {{File}} | The features XML used to generate the KAR file \\ Default value: {{${project.build.directory}/feature/feature.xml}} |
| {{resourcesDir} | {{File}} | Location of resources directory for additional content to include in the KAR. Note that it includes everything under classes so as to include maven-remote-resources \\ Default value: ${project.build.directory}/classes}} |
| {{finalName}} | {{String}} | Name of the generated kar \\ Default value: {{${project.build.finalName}}} |
| {{outputDirectory}} | {{File}} | Directory containing the generated archive \\ Default value: {{${project.build.directory}}} |