Apache Sling Feature Launcher

Clone this repo:
  1. 8c73387 [maven-release-plugin] prepare for next development iteration by Robert Munteanu · 13 days ago master
  2. 276ef02 [maven-release-plugin] prepare release org.apache.sling.feature.launcher-1.1.6 by Robert Munteanu · 13 days ago org.apache.sling.feature.launcher-1.1.6
  3. 8bb50ec Upgrade to latest feature model release by Robert Munteanu · 13 days ago
  4. 02e137b Align module name with Jira version name by Robert Munteanu · 13 days ago
  5. 7aa00ee Adding sonarqube badges as per SLING-9682 by Dan Klco · 4 weeks ago

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()
};
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