GenerateLocalLibraryFiles

Generates source files that allow JenkinsRule integration tests to load the project's shared library.

The plugin registers this task automatically; consumers do not invoke it directly. The generated files are wired into the integrationTest source set:

• LocalLibraryRetriever.java — a LibraryRetriever that copies src/, vars/, and resources/ from the path set in the test.library.location system property. Additional libraries are injected via contiguous test.library.N.{name,location,implicit} properties. A future iteration may replace the property scheme with a single manifest file on the test classpath once external library resolution is implemented.

• SharedLibraryAutoRegistrar.java — an @Initializer-annotated class that auto-registers all libraries in GlobalLibraries at embedded Jenkins startup (generated unless sharedLibrary.autoRegisterLibrary = false). Libraries are scanned via contiguous zero-based indices: test.library.0.* is always the project's own library; additional libraries resolved from Gradle dependencies follow at test.library.1.*, test.library.2.*, …

• META-INF/services/annotations/hudson.init.Initializer — the annotation-indexer class list that Jenkins reads at startup; each listed class is scanned for @Initializer methods via reflection. Generated directly here instead of via the annotation-indexer processor.

• META-INF/hudson.remoting.ClassFilter — registers LocalLibraryRetriever so XStream can deserialise LibraryConfiguration during test setup.

When generateAutoRegistrar = true (the default), no explicit GlobalLibraries.get().setLibraries(...) call is needed in test code — the auto-registrar handles it at Jenkins startup time. Pass an explicit name if you need a different library name than project.name:

// Explicit registration (only needed when autoRegisterLibrary = false):
GlobalLibraries.get().setLibraries(List.of(LocalLibraryRetriever.implicitLibrary()));
GlobalLibraries.get().setLibraries(List.of(LocalLibraryRetriever.implicitLibrary("my-lib")));