@sapui5/sap.ushell 1.143.3 → 1.144.0

package/src/main/js/sap/ushell/appIntegration/AppLifeCycle.js

@@ -1,8 +1,8 @@
-// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
+// Copyright (c) 2009-2026 SAP SE, All Rights Reserved
 
 /**
  * @fileOverview handle all the resources for the different applications.
- * @version 1.143.3
+ * @version 1.144.0
  */
 sap.ui.define([
     "sap/base/util/Deferred",
@@ -22,7 +22,7 @@ sap.ui.define([
     "sap/ushell/appIntegration/AppLifeCycle/KeepAliveMode",
     "sap/ushell/appIntegration/PostMessageHandler",
     "sap/ushell/appIntegration/PostMessageManager",
-    "sap/ushell/appIntegration/PostMessagePluginInterface",
+    "sap/ushell/services/PluginManager/PostMessagePluginInterface",
     "sap/ushell/appIntegration/IframeApplicationContainer",
     "sap/ushell/appIntegration/UI5ApplicationContainer",
     "sap/ushell/services/AppConfiguration",
@@ -242,6 +242,14 @@ sap.ui.define([
      */
     AppLifeCycle.prototype.registerHandleHashChange = function (oShellNavigationInternal) {
         oShellNavigationInternal.hashChanger.attachEvent("hashChanged", (oHashChangeEvent) => {
+            const oParameters = oHashChangeEvent.getParameters();
+
+            if (this.getCurrentApplication()?.container?.getActive() && this.getCurrentApplication().container.getVisible()) {
+                // always store latest hash in the current application container
+                // with this we can restore the app with the correct hash
+                this.getCurrentApplication().container.setCurrentHash(oParameters.fullHash);
+            }
+
             // FIX for internal incident #1980317281 - In general, hash structure in FLP is splitted into 3 parts:
             // A - application identification & B - Application parameters & C - Internal application area
             // Now, when an IFrame changes its hash, it sends PostMessage up to the FLP. The FLP does 2 things: Change its URL
@@ -251,8 +259,6 @@ sap.ui.define([
                 return;
             }
 
-            const oParameters = oHashChangeEvent.getParameters();
-
             if (oParameters && oShellNavigationInternal.hashChanger.isInnerAppNavigation(oParameters.newHash, oParameters.oldHash)) {
                 PostMessageManager.sendRequestToAllApplications("sap.ushell.appRuntime.innerAppRouteChange", {
                     oHash: oParameters
@@ -612,6 +618,33 @@ sap.ui.define([
             const oApplicationContainer = oStorageEntry.container;
             if (oApplicationContainer.isA("sap.ushell.appIntegration.IframeApplicationContainer")) {
                 await oApplicationContainer.sendRequest("sap.ushell.appRuntime.keepAliveAppShow", {}, false);
+
+                /**
+                 * Check if only the app specific route has changed with the navigation
+                 * This scenario can happen for a stored application which is targeted again with updated app-specific route.
+                 * It is only relevant for stateful container not supporting keep-alive within the same frame.
+                 * In this case the old application is restored but without information on the current hash.
+                 */
+                if (!StatefulContainerV2Handler.isStatefulContainerSupportingKeepAlive(oApplicationContainer)) {
+                    const sCurrentHash = hasher.getHash();
+                    const oCurrentParsedHash = UrlParsing.parseShellHash(sCurrentHash, true);
+                    const oStoredParsedHash = UrlParsing.parseShellHash(oApplicationContainer.getCurrentHash(), true);
+                    const oHashComparison = UrlParsing.compareParsedHashes(oStoredParsedHash, oCurrentParsedHash);
+
+                    const bSameAppUpdatedRoute = oHashComparison.sameIntent && oHashComparison.sameParameters && !oHashComparison.sameAppSpecificRoute;
+                    if (bSameAppUpdatedRoute) {
+                        const oHashUpdate = {
+                            oldHash: (oStoredParsedHash.appSpecificRoute || "").replace("&/", ""),
+                            newHash: (oCurrentParsedHash.appSpecificRoute || "").replace("&/", ""),
+                            fullHash: sCurrentHash
+                        };
+                        oApplicationContainer.sendRequest("sap.ushell.appRuntime.innerAppRouteChange", {
+                            oHash: oHashUpdate
+                        }, false);
+
+                        oApplicationContainer.setCurrentHash(sCurrentHash);
+                    }
+                }
             } else if (oApplicationContainer.isA("sap.ushell.appIntegration.UI5ApplicationContainer")) {
                 await EmbeddedUI5Handler.restoreAppAfterNavigate(oApplicationContainer, oStorageEntry);
             }
@@ -824,11 +857,12 @@ sap.ui.define([
      * @param {string} sStorageAppId the id of the application.
      * @param {string} sBaseAppId the base application id.
      * @param {object} oResolvedHashFragment the resolved hash fragment.
+     * @param {sap.ushell.services.URLParsing.DecomposedHash} oParsedHash the parsed shell hash.
      * @param {object} bShouldBeCached Wether it should be cached.
      *
      * @returns {object} the application container.
      */
-    AppLifeCycle.prototype._createOrReuseApplicationContainer = function (sStorageAppId, sBaseAppId, oResolvedHashFragment, bShouldBeCached) {
+    AppLifeCycle.prototype._createOrReuseApplicationContainer = function (sStorageAppId, sBaseAppId, oResolvedHashFragment, oParsedHash, bShouldBeCached) {
         let oApplicationContainer;
 
         const oStorageEntry = KeepAliveApps.get(sStorageAppId);
@@ -863,6 +897,7 @@ sap.ui.define([
                 initialAppId: sStorageAppId,
                 currentAppId: sStorageAppId,
                 currentAppUrl: oResolvedHashFragment.url,
+                currentHash: UrlParsing.constructShellHash(oParsedHash),
                 shellUIService: oResolvedHashFragment.shellUIService,
                 currentAppTargetResolution: oResolvedHashFragment,
                 applicationType: oResolvedHashFragment.applicationType,
@@ -1029,10 +1064,6 @@ sap.ui.define([
                 return sNavigationRedirectHash;
             }
 
-            if (typeof oComponentInstance.active === "function") {
-                oComponentInstance.active();
-            }
-
             return;
         }
 
@@ -1219,7 +1250,7 @@ sap.ui.define([
         const sKeepAliveMode = this._calculateKeepAliveMode(sStorageAppId, oResolvedHashFragment, oParsedHash);
         const bShouldBeCached = sKeepAliveMode !== KeepAliveMode.False;
 
-        const oApplicationContainer = this._createOrReuseApplicationContainer(sStorageAppId, sBaseAppId, oResolvedHashFragment, bShouldBeCached);
+        const oApplicationContainer = this._createOrReuseApplicationContainer(sStorageAppId, sBaseAppId, oResolvedHashFragment, oParsedHash, bShouldBeCached);
 
         // check after cleanup, but before creating the storage entry
         const bWasKeptAlive = !!KeepAliveApps.get(sStorageAppId);
@@ -1426,6 +1457,14 @@ sap.ui.define([
             }
         }
 
+        // todo [FLPCOREANDUX-10024] Move this into EmbeddedUI5Handler
+        // Note 2717290 / BCP 1880601193
+        // Custom lifecycle event to have a stable hook to dynamically set fullWidth/ letterBox AFTER AppLifeCycle applied default behavior
+        const oComponentInstance = oResolvedHashFragment.componentHandle?.getInstance();
+        if (oComponentInstance && typeof oComponentInstance.active === "function") {
+            oComponentInstance.active();
+        }
+
         let sIcon = "sap-icon://folder";
         if (oMetadata && oMetadata.icon) {
             sIcon = oMetadata.icon;

package/src/main/js/sap/ushell/appIntegration/ApplicationContainer.js

@@ -1,8 +1,8 @@
-// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
+// Copyright (c) 2009-2026 SAP SE, All Rights Reserved
 
 /**
  * @fileOverview The UI integration's SAPUI5 control which supports application embedding.
- * @version 1.143.3
+ * @version 1.144.0
  */
 sap.ui.define([
     "sap/base/Log",
@@ -62,6 +62,7 @@ sap.ui.define([
                 initialAppId: { defaultValue: "", type: "string" },
                 currentAppId: { defaultValue: "", type: "string" },
                 currentAppUrl: { defaultValue: "", type: "string" },
+                currentHash: { defaultValue: "", type: "string" },
                 shellUIService: { type: "object" },
                 statefulType: { defaultValue: StatefulType.NotSupported, type: "sap.ushell.appIntegration.contracts.StatefulType" },
                 beforeAppCloseEvent: { type: "object" },
@@ -362,12 +363,17 @@ sap.ui.define([
 
     ApplicationContainer.prototype.getPostMessageTarget = function () {
         // needs to be implemented by sub classes
-        throw new Error("getPostMessageTarget is not implemented in ApplicationContainer");
+        throw new Error("getPostMessageTarget is not implemented for this sub class of ApplicationContainer");
     };
 
     ApplicationContainer.prototype.getPostMessageTargetOrigin = function () {
         // needs to be implemented by sub classes
-        throw new Error("getPostMessageTargetOrigin is not implemented in ApplicationContainer");
+        throw new Error("getPostMessageTargetOrigin is not implemented for this sub class of ApplicationContainer");
+    };
+
+    ApplicationContainer.prototype.sendRequest = async function () {
+        // needs to be implemented by sub classes
+        throw new Error("sendRequest is not implemented for this sub class of ApplicationContainer");
     };
 
     /**

package/src/main/js/sap/ushell/appIntegration/ApplicationContainerCache.js

@@ -1,8 +1,10 @@
-// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
+// Copyright (c) 2009-2026 SAP SE, All Rights Reserved
 sap.ui.define([
-    "sap/base/Log"
+    "sap/base/Log",
+    "sap/ushell/utils"
 ], (
-    Log
+    Log,
+    ushellUtils
 ) => {
     "use strict";
 
@@ -158,23 +160,13 @@ sap.ui.define([
          * @private
          */
         #getKeyFromUrl (sUrl) {
-            let sOrigin;
             let sIframeHint = "";
             let sUI5Version = "";
             let sUI5Async = "";
             let sFESR = "";
             let sTestUniqueId = "";
 
-            const oURL = new URL(sUrl, this._getWindowLocationHref());
-
-            sOrigin = oURL.origin;
-            if (oURL.port === "") {
-                if (oURL.protocol === "https:") {
-                    sOrigin = `${sOrigin}:443`;
-                } else if (oURL.protocol === "http:") {
-                    sOrigin = `${sOrigin}:80`;
-                }
-            }
+            const oURL = new URL(sUrl || "", ushellUtils.getLocationHref());
 
             const oSearchParams = oURL.searchParams;
             if (oSearchParams.has("sap-iframe-hint")) {
@@ -193,11 +185,45 @@ sap.ui.define([
                 sTestUniqueId = `@testid:${oSearchParams.get("sap-testcflp-iframeid")}`;
             }
 
-            return sOrigin.toLowerCase() + sIframeHint + sUI5Version + sUI5Async + sFESR + sTestUniqueId;
+            return this.#getUrlKeyPart(oURL) + sIframeHint + sUI5Version + sUI5Async + sFESR + sTestUniqueId;
         }
 
-        _getWindowLocationHref () {
-            return window.location.href;
+        /**
+         * Returns the URL part of the container key:
+         * - Only the origin for classic UI frameworks
+         * - Origin and pathname for everything else
+         *
+         * Note: This method does not implement special logic to handle URL path variations
+         * that might resolve to the same resource on the web server (e.g., 'same/path',
+         * 'same/path/', 'same/path/index.html'). The assumption is that applications use
+         * consistent URL templates, so such variations should not occur in practice.
+         *
+         * @param {URL} oURL The URL object of the application URL
+         * @returns {string} The URL key part
+         * @private
+         */
+        #getUrlKeyPart (oURL) {
+            let sOrigin = oURL.origin;
+            if (oURL.port === "") {
+                if (oURL.protocol === "https:") {
+                    sOrigin = `${sOrigin}:443`;
+                } else if (oURL.protocol === "http:") {
+                    sOrigin = `${sOrigin}:80`;
+                }
+            }
+
+            const aClassicUiFrameworkHints = [
+                "GUI",
+                "WDA",
+                "NWBC",
+                "WCF"
+            ];
+            const bIsClassicUiFramework = aClassicUiFrameworkHints.includes(oURL.searchParams.get("sap-iframe-hint"));
+            if (bIsClassicUiFramework) {
+                return sOrigin;
+            }
+
+            return sOrigin + oURL.pathname;
         }
 
         _getStorageForDebug () {

package/src/main/js/sap/ushell/appIntegration/ApplicationContainerRenderer.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
+// Copyright (c) 2009-2026 SAP SE, All Rights Reserved
 
 sap.ui.define([
 ], (

package/src/main/js/sap/ushell/appIntegration/ApplicationHandle.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
+// Copyright (c) 2009-2026 SAP SE, All Rights Reserved
 sap.ui.define([
     "sap/ushell/state/StateManager",
     "sap/ushell/utils"

package/src/main/js/sap/ushell/appIntegration/IframeApplicationContainer.js

@@ -1,4 +1,4 @@
-// Copyright (c) 2009-2025 SAP SE, All Rights Reserved
+// Copyright (c) 2009-2026 SAP SE, All Rights Reserved
 
 /**
  * @fileOverview The Application Container for iFrames.
@@ -53,11 +53,12 @@ sap.ui.define([
         metadata: {
             library: "sap.ushell",
             properties: {
-                visible: { type: "boolean", defaultValue: true },
                 nwbcDirtyStorageKey: { defaultValue: "", type: "string" },
                 iframeUrl: { defaultValue: "", type: "string", visibility: "hidden" },
-                iframePostAllParams: { defaultValue: false, type: "boolean" },
+
                 iframeWithPost: { defaultValue: false, type: "boolean" },
+                iframePostAllParams: { defaultValue: false, type: "boolean" },
+                iframePostFlpParams: { defaultValue: {}, type: "object" },
 
                 iframeIsValidSupport: { defaultValue: false, type: "boolean" },
                 lastIframeIsValidTime: { defaultValue: 0, type: "int" },
@@ -124,11 +125,13 @@ sap.ui.define([
      *
      * No changes to the rendering relevant properties of the control must be done during this phase.
      */
-    IframeApplicationContainer.prototype.prepareRendering = async function () {
+    IframeApplicationContainer.prototype._prepareRendering = async function () {
         if (this.getProperty("preparingRendering") || this.getProperty("renderingPrepared")) {
             return;
         }
 
+        this.setProperty("preparingRendering", true, true);
+
         try {
             this._attachNwbcLogoutEvent();
             this._initNwbcDirtyState();
@@ -136,8 +139,12 @@ sap.ui.define([
             await this._calculateIframeUrl();
             this._calculateIframeWithPost();
 
-            // the post mechanism requires the iframeUrl without system alias
-            if (!this.getProperty("iframeWithPost")) {
+            if (this.getProperty("iframeWithPost")) {
+                const sIframeUrl = this.getProperty("iframeUrl");
+                await this._calculatePostFlpParams(sIframeUrl);
+                // the post mechanism requires the iframeUrl without system alias
+                // it is added only during render of the iframe
+            } else {
                 const sIframeUrl = this.getProperty("iframeUrl");
                 const sIframeUrlWithSystemAlias = systemAliasUtils.addSystemAlias(sIframeUrl, this);
 
@@ -156,7 +163,7 @@ sap.ui.define([
             return;
         }
 
-        this.prepareRendering();
+        this._prepareRendering();
     };
 
     IframeApplicationContainer.prototype.onAfterRendering = async function () {
@@ -168,6 +175,15 @@ sap.ui.define([
             return;
         }
 
+        if (this.getIframeWithPost()) {
+            const oForm = this.getDomRef().querySelector("form");
+            if (oForm) {
+                oForm.submit();
+            } else {
+                Log.error("Form element not found");
+            }
+        }
+
         // after rendering, the iframe and its origin is available
         const MessageBroker = await Container.getServiceAsync("MessageBroker");
         const sTargetOrigin = this.getPostMessageTargetOrigin();
@@ -295,6 +311,41 @@ sap.ui.define([
         this.setProperty("iframeWithPost", bEnablePost, true);
     };
 
+    IframeApplicationContainer.prototype._calculatePostFlpParams = async function (sIframeUrl) {
+        let aKeys = [];
+        let aValues = [];
+
+        const sAdaptedIframeUrl = ushellUtils.filterOutParamsFromLegacyAppURL(sIframeUrl);
+        const oAppStatesInfo = ushellUtils.getParamKeys(sAdaptedIframeUrl);
+        if (oAppStatesInfo.aAppStateNamesArray.length) {
+            const Navigation = await Container.getServiceAsync("Navigation");
+            try {
+                const aDataArray = await Navigation.getAppStateData(oAppStatesInfo.aAppStateKeysArray);
+                if (aDataArray) {
+                    aKeys = [...oAppStatesInfo.aAppStateNamesArray];
+                    aValues = [...aDataArray];
+                }
+            } catch {
+                // fail silently
+            }
+        }
+
+        aKeys.push("sap-flp-url");
+        aValues.push(Container.getFLPUrl(true));
+
+        aKeys.push("system-alias");
+        aValues.push(this.getSystemAlias());
+
+        const oFLPParams = {};
+        aKeys.forEach((item, index) => {
+            if (aValues[index] || item === "system-alias") {
+                oFLPParams[item] = aValues[index];
+            }
+        });
+
+        this.setProperty("iframePostFlpParams", oFLPParams, true);
+    };
+
     IframeApplicationContainer.prototype._calculateIframeUrl = async function () {
         const sApplicationType = this.getApplicationType();
 
@@ -315,21 +366,37 @@ sap.ui.define([
     IframeApplicationContainer.prototype._injectParametersFromDocumentUrl = function (sIframeUrl) {
         // generic mechanism for allowing to pass parameters to the iframe URL
         const oUrlParams = UriParameters.fromURL(this._getDocumentUrl());
+        const sIframeUiVersion = oUrlParams.get("sap-iframe-ui-version");
+        const sIframeUiDebug = oUrlParams.get("sap-iframe-ui-debug");
+        const sTmpURI = new URI(sIframeUrl);
+
+        if (sIframeUiVersion) {
+            sTmpURI.addQuery("sap-ui-version", sIframeUiVersion);
+        }
+        if (sIframeUiDebug) {
+            sTmpURI.addQuery("sap-ui-debug", sIframeUiDebug);
+        }
         if (!oUrlParams.has("sap-iframe-params")) {
+            sIframeUrl = sTmpURI.toString(); // assign for quicker debugging
             return sIframeUrl;
         }
 
         const sIframeParams = oUrlParams.get("sap-iframe-params") || "";
         const aParams = sIframeParams.split(",");
-
-        const sTmpURI = new URI(sIframeUrl);
         aParams.forEach((sParam) => {
+            if (sParam === "sap-ui-version" && sIframeUiVersion) {
+                Log.error("Both sap-iframe-ui-version and sap-iframe-params=sap-ui-version are set. Please use only one of them.");
+                return;
+            }
+            if (sParam === "sap-ui-debug" && sIframeUiDebug) {
+                Log.error("Both sap-iframe-ui-debug and sap-iframe-params=sap-ui-debug are set. Please use only one of them.");
+                return;
+            }
             if (sParam && oUrlParams.has(sParam)) {
                 sTmpURI.addQuery(sParam, oUrlParams.get(sParam));
             }
         });
-        sIframeUrl = sTmpURI.toString();
-
+        sIframeUrl = sTmpURI.toString(); // assign for quicker debugging
         return sIframeUrl;
     };