add BuildServicesResolver.setBuildServices()

api/src/main/java/jakarta/enterprise/inject/build/compatible/spi/BuildServicesResolver.java

@@ -12,12 +12,13 @@
 
 import java.util.Collections;
 import java.util.Comparator;
+import java.util.Objects;
 import java.util.ServiceConfigurationError;
 import java.util.ServiceLoader;
 import java.util.Set;
 import java.util.TreeSet;
 
-final class BuildServicesResolver {
+public final class BuildServicesResolver {
     private static final Object lock = new Object();
     private static volatile Set<BuildServices> discoveredBuildServices;
     private static volatile BuildServices configuredBuildServices;
@@ -48,7 +49,7 @@ private static void discoverFactories() {
                 BuildServices.class, BuildServicesResolver.class.getClassLoader());
 
         if (!loader.iterator().hasNext()) {
-            throw new IllegalStateException("Unable to locate AnnotationBuilderFactory implementation");
+            throw new IllegalStateException("Unable to locate BuildServices implementation");
         }
 
         try {
@@ -61,4 +62,12 @@ private static void discoverFactories() {
 
         BuildServicesResolver.discoveredBuildServices = Collections.unmodifiableSet(factories);
     }
+
+    /**
+     * This method should <em>not</em> be used by applications. It is only exposed for integrators
+     * with complex classloading architectures, where service loader lookup doesn't work out of the box.
+     */
+    public static void setBuildServices(BuildServices instance) {
+        configuredBuildServices = Objects.requireNonNull(instance, "BuildServices instance must not be null");
+    }
 }