Apache Sling Feature Launcher

Clone this repo:
  1. b804637 [maven-release-plugin] prepare for next development iteration by David Bosschaert · 2 days ago master
  2. 7f0117c [maven-release-plugin] prepare release org.apache.sling.feature.launcher-1.1.14 by David Bosschaert · 2 days ago org.apache.sling.feature.launcher-1.1.14
  3. d99c0d1 SLING-9947 Update Feature Model Launcher to latest feature model by David Bosschaert · 2 days ago
  4. 242a5b8 [maven-release-plugin] prepare for next development iteration by David Bosschaert · 13 days ago
  5. efcff63 [maven-release-plugin] prepare release org.apache.sling.feature.launcher-1.1.12 by David Bosschaert · 13 days ago org.apache.sling.feature.launcher-1.1.12

Apache Sling

Build Status Test Status Coverage Sonarcloud Status JavaDoc Maven Central feature License

Feature Model Launcher

The Feature Model Launcher can launch an feature model application file to a running process.

The launcher can be executed as follows:

java org.apache.sling.feature.launcher.impl.Main

or via the Java Main class of the jar file:

java -jar org.apache.sling.feature.launcher-1.0.0.jar

The launcher creates a local cache, by default in a subdirectory called launcher. If you want to run the launcher with a clean start, delete this directory before invoking the launcher.

The following command line options are supported:

$ rm -rf launcher && java -jar org.apache.sling.feature.launcher-1.0.0.jar -h
usage: launcher
 -C <arg>    Set artifact clash override
 -CC <arg>   Set config class override
 -c <arg>    Set cache dir
 -D <arg>    Set framework properties
 -f <arg>    Set feature files (relative and absolute file path or URL including classloader resources)
 -fv <arg>   Set felix framework version
 -p <arg>    Set home dir
 -u <arg>    Set repository url
 -V <arg>    Set variable value
 -ec <arg>   Set Extension Configuration (format: extensionName:key1=val1,key2=val2)
 -fv <arg>   Set Felix Framework version
 -fa <arg>   Set Framework Artifact (overrides felix framework version)
 -v          Verbose

Note: if feature files are provided as a Classloader Resource like in an executable JAR file or classpath resource then it's Resource URL can be handed over to the Launcher as feature file (-f option):

java.net.URL url = getClass().getResource("/my-feature-file.json");
String[] arguments = new String[] {
    "-f", url.toString()

For further documentation see: https://github.com/apache/sling-org-apache-sling-feature/blob/master/readme.md