Apache Sling Feature Model Launcher

Clone this repo:
  1. 80ffa27 SLING-9413 : Provide the Ability for the Launcher to start with Feature Archive(s) by Carsten Ziegeler · 3 weeks ago master
  2. 9e01543 SLING-9298 : Switch to commons.text by Carsten Ziegeler · 8 weeks ago
  3. 7453468 SLING-9296 : Update feature dependencies by Carsten Ziegeler · 8 weeks ago
  4. f475629 SLING-9295 : Make project compilable with Java 11 by Carsten Ziegeler · 8 weeks ago
  5. 983a37f [maven-release-plugin] prepare for next development iteration by David Bosschaert · 4 months ago

Build Status License feature

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()
};
org.apache.sling.feature.launcher.impl.Main.main(arguments);

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