From f6670e75266dfb788d7b65768d975ffc8e90f287 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos Date: Fri, 8 May 2026 04:21:35 -0300 Subject: [PATCH 1/3] W-22405361-ETS-change --- modules/ROOT/nav.adoc | 1 + .../pages/publishing-connectors-exchange.adoc | 72 +++++++++++++++++++ 2 files changed, 73 insertions(+) create mode 100644 modules/ROOT/pages/publishing-connectors-exchange.adoc 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..0a8002c8 --- /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` version 1.9.0 or later. + +* If you manually configure plugins, update your POM file to reference `mule-extension-plugin` version 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. + + + From c06334ee983d79a5ebfef757986cc9dd14a3bf4d Mon Sep 17 00:00:00 2001 From: Luana Dos Santos Date: Fri, 8 May 2026 04:29:43 -0300 Subject: [PATCH 2/3] fixed format --- modules/ROOT/pages/publishing-connectors-exchange.adoc | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/modules/ROOT/pages/publishing-connectors-exchange.adoc b/modules/ROOT/pages/publishing-connectors-exchange.adoc index 0a8002c8..7449d275 100644 --- a/modules/ROOT/pages/publishing-connectors-exchange.adoc +++ b/modules/ROOT/pages/publishing-connectors-exchange.adoc @@ -13,7 +13,7 @@ Update your plugin version before you publish a new connector version. This chan 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. +* 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] ---- @@ -24,9 +24,9 @@ Choose the approach that matches your development setup: ---- -* If you use Mule SDK, upgrade to a version that includes `mule-extension-plugin` version 1.9.0 or later. +* 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` version 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] ---- From 42ee750b31d181432e5ee2ead2f08a67146c5568 Mon Sep 17 00:00:00 2001 From: Luana Dos Santos <84200607+luanamulesoft@users.noreply.github.com> Date: Fri, 8 May 2026 04:32:06 -0300 Subject: [PATCH 3/3] Update publishing-connectors-exchange.adoc --- modules/ROOT/pages/publishing-connectors-exchange.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/ROOT/pages/publishing-connectors-exchange.adoc b/modules/ROOT/pages/publishing-connectors-exchange.adoc index 7449d275..600be995 100644 --- a/modules/ROOT/pages/publishing-connectors-exchange.adoc +++ b/modules/ROOT/pages/publishing-connectors-exchange.adoc @@ -13,7 +13,7 @@ Update your plugin version before you publish a new connector version. This chan 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. +* 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] ----