Maven plugin to build Jenkins plugins. See the developer guide for details.

Mojo documentation

See GitHub Releases

• Treat POM loading errors in dependencies as nonfatal.

• JENKINS-54807 - Fix classloading of Java-internal modules when running hpi:run with Java 11

• PR #90 - Introduce a new hpi.compatibleSinceVersion property to support marking plugins as incompatible without the plugin configuration override
  • Prevents issues like JENKINS-55562
• JENKINS-54949 - Add support of adding the current pom.xml to the custom WAR in the hpi:custom-war mojo

• hpi:run was broken since 3.0 since minimumJavaVersion was not being properly propagated.

• JENKINS-20679 - Inject Minimum-Java-Version into the manifest.
  • It is set by a new mandatory minimumJavaVersion parameter in hpi:hpi, hpi:jar and hpi:hpl
  • Format: java.specification.version according to Java JEP-223. Examples: 1.6, 1.7, 1.8, 6, 7, 8, 9, 11, ...
• PR #83 - Improve the error message when an improper JAR file is passed
• Internal: Move manifest-related parameters and logic to AbstractJenkinsManifestMojo

• Delete work/plugins/*.jpl where the current test-scoped dependency is not in fact a snapshot.
• Use a more specific temp dir for Jetty.

• Bugs in the dependency copy of mvn hpi:run could lead to anomalies such as work/plugins/null.jpi.

• Option to override a snapshot plugin version with a more informative string.

• Using a newer standard VersionNumber that precisely matches the behavior of the Jenkins plugin manager.

• Fix mvn clean hpi:run and some similar special goal sequences.

• Jenkins plugin archetypes are no longer bundled with this Maven plugin. Instead use the new project.
• Making -DwebAppFile=… work.
• Fixing unchecked/rawtypes warnings in InjectedTest.
• No more special handling of artifacts with -ea in the version.

• Updated integrated Jetty server to 9.x. This means that JDK 8 is now required at build time. (Plugins may continue to target older Java baselines using the java.level property in the 2.x parent POM.)
• JENKINS-24064 Added executable-war artifact type, permitting Jenkins to stop deploying the wasteful jenkins-war-*-war-for-test.jar artifact, which was identical to jenkins-war-*.war.

• Fixed HTML escaping for Javadoc created for taglibs so it can be processed by JDK 8.
• Logging the current artifact for InjectedTest.
• More fixes to mojos that assumed that plugin artifacts used a short name identical to the artifactId.
• Minor archetype updates.

• Fixing a problem with plugin dependency resolution affecting users of jitpack.io.

• Allowing hpi:run to pick up compiled classes & saved resources from core or plugin snapshot dependencies in addition to the plugin under test itself.
• Ensuring Plugin-Dependencies appears in a consistent order from build to build.

Not recorded.

mvn -Prun-its clean install
# Find some plugin using the 2.x parent POM and run:
mvn -f ../some-plugin -Dhpi-plugin.version=2.XXX-SNAPSHOT -DskipTests -DjenkinsHome=/tmp/sanity-check-maven-hpi-plugin clean package hpi:run

You can also rerun one test:

mvn -Prun-its mrm:start invoker:run mrm:stop -Dinvoker.test=parent-3x

To rerun just the verification script:

groovy -e "basedir='$(pwd)/target/its/parent-3x'; evaluate new File('src/it/parent-3x/verify.groovy')"

Also make sure project.parent.version in src/it/parent-3x/pom.xml is the latest.

hpi:run mojo is a variant of jetty:run mojo, and because of the way plugin descriptor is generated, this module copies some code from Jetty Maven plugin, specifically AbstractJettyMojo.java and ConsoleScanner.java.

To keep upstream tracking easier, pristine copies of these files are copied into incoming-x.y branch, then package renamed. This version specific incoming branch is then "theirs" merged into the incoming branch, which acts as the upstream tracking branch.

This branch is then merged into master via git merge -X ignore-space-at-eol incoming. See diff between incoming and master on these files to see the exact local patches.