W-22405361-ETS-change

modules/ROOT/nav.adoc

@@ -2,6 +2,7 @@
 * xref:index.adoc[Overview]
 ** xref:partner-connector-upgrade.adoc[Upgrading Java for Custom Connectors (Partners)]
 ** xref:customer-connector-upgrade.adoc[Upgrading Java for Custom Connectors (Customers)]
+** xref:publishing-connectors-exchange.adoc[Publishing Connectors to Exchange]
 * xref:getting-started.adoc[Java SDK]
  ** xref:choosing-version.adoc[Choosing the SDK version]
   *** xref:extensions-api-deprecated.adoc[]

modules/ROOT/pages/publishing-connectors-exchange.adoc

@@ -0,0 +1,72 @@
+= Publishing Connectors to Exchange
+:page-id: publishing-connectors-exchange
+
+Starting May 18, 2026, Exchange requires `mule-extension-plugin` version 1.9.0 or later to publish connectors and Mule plugins. This version writes Java compatibility metadata to `mule-artifact.json` during build time.
+
+Exchange now reads Java compatibility from `mule-artifact.json` instead of the Extension Model, eliminating the need to download dependencies from Maven Central.
+
+[NOTE]
+Update your plugin version before you publish a new connector version. This change doesn't affect existing connectors that are already published to Exchange.
+
+
+== Update Your Connector
+
+Choose the approach that matches your development setup:
+
+* If you use the parent POM, update to the latest parent POM version that includes `mule-extension-plugin` 1.9.0 or later.
++
+[source,xml]
+----
+<parent>
+    <groupId>org.mule.connectors</groupId>
+    <artifactId>mule-modules-parent</artifactId>
+    <version>1.9.0</version> <!-- or later -->
+</parent>
+----
+
+* If you use Mule SDK, upgrade to a version that includes `mule-extension-plugin` 1.9.0 or later.
+
+* If you manually configure plugins, update your POM file to reference `mule-extension-plugin` 1.9.0 or later.
++
+[source,xml]
+----
+<plugin>
+    <groupId>org.mule.tools.maven</groupId>
+    <artifactId>mule-extension-plugin</artifactId>
+    <version>1.9.0</version> <!-- or later -->
+</plugin>
+----
+
+== Verify Your Configuration
+
+After updating your POM:
+
+. Build your connector locally
++
+[source,console]
+----
+mvn clean install
+----
+. Verify that `mule-artifact.json` contains Java compatibility information
++
+In your connector JAR file, confirm that `mule-artifact.json` includes the `minJavaVersion` attribute.
+. Test publishing to Exchange
++
+Publish to a test environment before you publish to production.
+
+== Troubleshooting
+
+Publishing Fails After May 18, 2026::
++
+If Exchange rejects your connector with an error about missing Java compatibility information. verify your `mule-extension-plugin` version:
++
+. Check your POM file for `mule-extension-plugin`
+. Ensure the version is 1.9.0 or higher
+. Rebuild and republish your connector
+
+The Build Fails After You Update the Plugin::
++
+If the Maven build fails after you update to `mule-extension-plugin` 1.9.0 or later, update Maven to version 3.8.0 or later.
+
+
+