diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 14b60d99..9beba6c7 100644 --- a/modules/ROOT/nav.adoc +++ b/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[] diff --git a/modules/ROOT/pages/publishing-connectors-exchange.adoc b/modules/ROOT/pages/publishing-connectors-exchange.adoc new file mode 100644 index 00000000..600be995 --- /dev/null +++ b/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] +---- + + org.mule.connectors + mule-modules-parent + 1.9.0 + +---- + +* 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] +---- + + org.mule.tools.maven + mule-extension-plugin + 1.9.0 + +---- + +== 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. + + +